Method: projects.table.export

Inicia um processo em lote que calcula uma tabela e grava o resultado em um de vários destinos.

Solicitação HTTP

POST https://earthengine.googleapis.com/v1/{project=projects/*}/table:export

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 deve ser tratado como o consumidor de serviço para esta solicitação. O formato é: projects/{project-id}

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

  • earthengine.exports.create

Corpo da solicitação

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

Representação JSON
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "selectors": [
    string
  ],
  "requestId": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "workloadTag": string,
  "priority": integer,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (TableFileExportOptions)
  },
  "assetExportOptions": {
    object (TableAssetExportOptions)
  },
  "featureViewExportOptions": {
    object (FeatureViewAssetExportOptions)
  },
  "bigqueryExportOptions": {
    object (BigQueryExportOptions)
  }
  // End of mutually exclusive fields.
}
Campos
expression

object (Expression)

Uma expressão que avalia a tabela a ser calculada e exportada.

description

string

Um nome legível da tarefa.

selectors[]

string

Uma lista explícita de colunas a serem incluídas no resultado.

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 "-" e requestId ter no máximo 60 caracteres.

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

Número máximo de vértices não cortados por geometria. Geometrias com mais vértices serão divididas em partes menores que esse tamanho.

workloadTag

string

Rótulo fornecido pelo usuário para rastrear esse cálculo.

priority

integer

Opcional. A prioridade da tarefa de exportação no projeto. As tarefas de maior prioridade são programadas mais cedo. O valor precisa ser um número inteiro entre 0 e 9999. O padrão é 100, caso não esteja definido.

Opções que descrevem onde e como armazenar os resultados. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo, um dos campos será definido em uma resposta:
fileExportOptions

object (TableFileExportOptions)

Se especificado, configura a exportação como um arquivo.

assetExportOptions

object (TableAssetExportOptions)

Se especificado, configura a exportação como um recurso do Earth Engine.

featureViewExportOptions

object (FeatureViewAssetExportOptions)

Se especificado, configura a exportação como um mapa FeatureView.

bigqueryExportOptions

object (BigQueryExportOptions)

Se especificado, configura a exportação de dados tabulares para o BigQuery.

Fim dos campos mutuamente exclusivos.

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
  • https://www.googleapis.com/auth/devstorage.full_control

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

TableFileExportOptions

Opções para exportar tabelas como arquivos fora do Earth Engine.

Representação JSON
{
  "fileFormat": enum (TableFileFormat),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  }
  // End of mutually exclusive fields.
}
Campos
fileFormat

enum (TableFileFormat)

O formato de arquivo em que as tabelas serão exportadas.

Onde gravar os resultados. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo, um dos campos será definido em uma resposta:
driveDestination

object (DriveDestination)

Se especificado, configura a exportação para o Google Drive.

cloudStorageDestination

object (CloudStorageDestination)

Se especificado, configura a exportação para o Google Cloud Storage.

Fim dos campos mutuamente exclusivos.

TableAssetExportOptions

Opções para salvar tabelas como recursos do Earth Engine.

Representação JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of mutually exclusive fields.
}
Campos
Onde gravar os resultados. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo, um dos campos será definido em uma resposta:
earthEngineDestination

object (EarthEngineDestination)

Se especificado, configura a exportação para o Earth Engine.

Fim dos campos mutuamente exclusivos.

FeatureViewAssetExportOptions

Opções para salvar tabelas ou FeatureCollections como mapas FeatureView.

Representação JSON
{
  "ingestionTimeParameters": {
    object (FeatureViewIngestionTimeParameters)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "featureViewDestination": {
    object (FeatureViewDestination)
  }
  // End of mutually exclusive fields.
}
Campos
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

Os parâmetros de tempo de ingestão do FeatureView. Esses parâmetros precisam ser especificados no momento da ingestão e não podem ser atualizados de forma dinâmica.

Onde gravar os resultados. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo, um dos campos será definido em uma resposta:
featureViewDestination

object (FeatureViewDestination)

Se especificado, configura a exportação para FeatureViews.

Fim dos campos mutuamente exclusivos.

FeatureViewDestination

Configuração para um destino FeatureView do Earth Engine.

Representação JSON
{
  "name": string,
  "assetVersion": integer
}
Campos
name

string

Obrigatório. O código do recurso FeatureView. O servidor gera um nome de mapa com base no ID.

assetVersion

integer

A versão do recurso FeatureView a ser criada. Usado para criar alias de versões com recursos. Se não for definido, será usado 0.

BigQueryExportOptions

Opções para exportar dados tabulares para o BigQuery.

Representação JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of mutually exclusive fields.
}
Campos
Onde gravar os dados. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo, um dos campos será definido em uma resposta:
bigqueryDestination

object (BigQueryDestination)

Se especificado, configura a exportação para o BigQuery.

Fim dos campos mutuamente exclusivos.

BigQueryDestination

Configuração de um destino no BigQuery.

Representação JSON
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
Campos
table

string

Obrigatório. A referência da tabela de destino do BigQuery no seguinte formato: "projectId.dataset_id.table_id".

Se o recurso referenciado não existir, uma nova tabela será criada. Isso também se aplica se os parâmetros "append" e "overwrite" forem ambos falsos.

Se o recurso referenciado existir e tiver um esquema compatível, um dos parâmetros "overwrite" e "append" precisará ser verdadeiro. Caso contrário, a tarefa vai falhar.

Se o recurso referenciado existir e o esquema não for compatível com o atual, a tarefa também vai falhar.

overwrite

boolean

Especifica se os dados da tabela serão substituídos se ela já existir e tiver um esquema compatível.

Os parâmetros overwrite e append não podem ser true simultaneamente.

append

boolean

Especifica se os dados da tabela devem ser anexados se a tabela já existir e tiver um esquema compatível.

Os parâmetros overwrite e append não podem ser true simultaneamente.