Method: projects.table.import

Importa uma tabela.

Solicitação HTTP

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/table:import

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
project

string

O ID ou número do projeto do Google Cloud Platform que será tratado como o consumidor de serviço para essa solicitação. O formato é projects/{project-id}.

A autorização requer a seguinte permissão do IAM no recurso especificado project:

  • earthengine.assets.create

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "tableManifest": {
    object (TableManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
Campos
tableManifest

object (TableManifest)

O manifesto da tabela.

description

string

Um nome legível da tarefa.

overwrite

boolean

Permite substituir um recurso.

requestId

string

Uma string exclusiva usada para detectar solicitações duplicadas. Se mais de uma solicitação for feita pelo mesmo usuário com o mesmo requestId não vazio, apenas uma dessas solicitações poderá iniciar uma operação de longa duração. requestId pode conter os caracteres a..z, A..Z, 0-9 ou '-'. requestId pode ter no máximo 60 caracteres.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte OAuth 2.0 Overview.

TableManifest

Descreve como o serviço do EarthEngine deve compor uma tabela a partir de um conjunto de arquivos.

Representação JSON
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "sources": [
    {
      object (TableSource)
    }
  ],
  "startTime": string,
  "endTime": string,
  "csvColumnDataTypeOverrides": {
    string: enum (CsvColumnDataType),
    ...
  },
  "columnDataTypeOverrides": {
    string: enum (ColumnDataType),
    ...
  },
  "memo": string
}
Campos
name

string

O nome do recurso a ser criado. name tem o formato "projects/*/assets/**" (por exemplo, "projects/earthengine-legacy/assets/users//"). Todos os recursos de propriedade do usuário estão no projeto "earthengine-legacy" (por exemplo, "projects/earthengine-legacy/assets/users/foo/bar"). Todos os outros recursos estão no projeto "earthengine-public" (por exemplo, "projects/earthengine-public/assets/LANDSAT").

properties

object (Struct format)

Propriedades adicionais do recurso. Os nomes de propriedade "system:time_start" e "system:time_end" foram descontinuados. Use os campos startTime e endTime.

uriPrefix

string

O prefixo opcional adicionado a todas as uris definidas neste manifesto.

sources[]

object (TableSource)

As origens que compõem essa tabela.

startTime

string (Timestamp format)

O carimbo de data/hora associado ao recurso, se houver, por exemplo, o horário em que uma imagem de satélite foi tirada. Para recursos que correspondem a um intervalo de tempo, como valores médios em um mês ou ano, esse carimbo de data/hora corresponde ao início desse intervalo.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Para recursos que correspondem a um intervalo de tempo, como valores médios em um mês ou ano, esse carimbo de data/hora corresponde ao fim desse intervalo (exclusivo).

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

csvColumnDataTypeOverrides
(deprecated)

map (key: string, value: enum (CsvColumnDataType))

Use columnDataTypeOverrides.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

columnDataTypeOverrides

map (key: string, value: enum (ColumnDataType))

Um mapeamento do nome da coluna para o tipo a ser usado nessa coluna. O tipo das colunas não especificadas aqui será inferido, de modo que as colunas numéricas se tornem números, as colunas WKT se tornem geometria etc.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

memo

string

Campo de formato livre para armazenar anotações do usuário. Não usado na transferência.

TableSource

Um arquivo de tabela.

Representação JSON
{
  "uris": [
    string
  ],
  "charset": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "crs": string,
  "geodesic": boolean,
  "primaryGeometryColumn": string,
  "xColumn": string,
  "yColumn": string,
  "dateFormat": string,
  "csvDelimiter": string,
  "csvQualifier": string
}
Campos
uris[]

string

Os URIs dos dados a serem importados. Atualmente, apenas URIs do Google Cloud Storage são aceitos. Cada URI precisa ser especificado no seguinte formato: "gs://bucket-id/object-id". O objeto principal precisa ser o primeiro elemento da lista. Os arquivos sidecar são inferidos a partir do caminho do objeto principal. No momento, apenas um URI é aceito. Se mais de um URI for especificado, um erro INALID_ARGUMENT será retornado.

charset

string

O nome do charset padrão a ser usado para decodificar strings. Se estiver vazio, o padrão será o conjunto de caracteres "utf-8".

maxErrorMeters

number

O erro máximo permitido em metros ao transformar a geometria entre sistemas de coordenadas. Se estiver vazio, o erro máximo será de 1 metro por padrão.

maxVertices

integer

O número máximo de vértices. Se não for zero, a geometria será subdividida em partes espacialmente separadas, cada uma abaixo desse limite.

crs

string

A string WKT ou o código CRS padrão que especifica o sistema de referência de coordenadas de qualquer geometria que não tenha um especificado. Se for deixado em branco, o padrão será EPSG:4326: https://epsg.io/4326. Somente para origens CSV/TFRecord.

geodesic

boolean

A estratégia padrão para interpretar bordas em geometrias que não têm uma especificada. Se for falso, as bordas serão retas na projeção. Se verdadeiro, as arestas são curvas para seguir o caminho mais curto na superfície da Terra. Se estiver em branco, o padrão será "false" se "crs" for um sistema de coordenadas projetado. Somente para origens CSV/TFRecord.

primaryGeometryColumn

string

A coluna de geometria a ser usada como geometria principal de uma linha quando houver mais de uma coluna de geometria.

Se você deixar em branco e houver mais de uma coluna de geometria, a primeira coluna de geometria encontrada será usada. Somente para origens CSV/TFRecord.

xColumn

string

O nome da coluna numérica de coordenadas x para deduzir a geometria do ponto. Se a coluna y também for especificada e ambas as colunas contiverem valores numéricos, uma coluna de geometria de ponto será construída com valores x,y no sistema de coordenadas fornecido em "crs". Se deixado em branco e "crs" não especificar um sistema de coordenadas projetado, o padrão será "longitude". Se o campo "crs" for deixado em branco e não especificar um sistema de coordenadas projetado, o padrão será "" e nenhuma geometria de ponto será gerada.

Uma coluna de geometria de ponto gerada vai ser nomeada como {xColuna}_{yColuna}_N, em que N é anexado de modo que {xColuna}_{yColuna}_N seja exclusivo se uma coluna com o nome {xColuna}_{yColuna} já existir. Somente para origens CSV/TFRecord.

yColumn

string

O nome da coluna numérica de coordenadas y para deduzir a geometria do ponto. Se a coluna x também for especificada e ambas as colunas contiverem valores numéricos, uma coluna de geometria de ponto será construída com valores x,y no sistema de coordenadas fornecido em "crs". Se deixado em branco e "crs" não especificar um sistema de coordenadas projetado, o padrão será "latitude". Se o campo "crs" for deixado em branco e não especificar um sistema de coordenadas projetado, o padrão será "" e nenhuma geometria de ponto será gerada.

Uma coluna de geometria de ponto gerada vai ser nomeada como {xColuna}_{yColuna}_N, em que N é anexado de modo que {xColuna}_{yColuna}_N seja exclusivo se uma coluna com o nome {xColuna}_{yColuna} já existir. Somente para origens CSV/TFRecord.

dateFormat

string

Um formato para analisar campos de codificação de datas. O padrão de formato precisa ser o descrito em http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html. Se for deixado em branco, as datas serão importadas como strings. Somente para origens CSV/TFRecord.

csvDelimiter

string

Ao transferir arquivos CSV, um único caractere é usado como delimitador entre os valores de colunas em uma linha. Se for deixado em branco, o padrão será ','. Somente para origens CSV.

csvQualifier

string

Ao transferir arquivos CSV, um caractere que envolve os valores das colunas (também conhecido como "caractere de aspas"). Se ficar em branco, o padrão será '"'. Somente para origens CSV.

Se um valor de coluna não estiver entre parênteses, os espaços em branco iniciais e finais serão removidos. Por exemplo: ..., teste,... <== este valor não é qualificado e se torna o valor da string: "test" <== o espaço em branco é removido

where: ...," test",... <== esse valor É qualificado com aspas se torna o valor da string: "teste" <== o espaço em branco permanece!