Method: projects.table.export

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

Solicitação HTTP

POST https://earthengine.googleapis.com/v1beta/{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 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.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,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (TableFileExportOptions)
  },
  "assetExportOptions": {
    object (TableAssetExportOptions)
  },
  "featureViewExportOptions": {
    object (FeatureViewAssetExportOptions)
  },
  "bigqueryExportOptions": {
    object (BigQueryExportOptions)
  }
  // End of list of possible types for union field export_options.
}
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 '-'. requestId pode 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. As geometrias com mais vértices serão cortadas em pedaços menores que esse tamanho.
workloadTag

string

Rótulo fornecido pelo usuário para acompanhar 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. Precisa ser um número inteiro entre 0 e 9999. O padrão é 100, se não for definido.
Campo de união export_options. Opções que descrevem onde e como armazenar os resultados. export_options pode ser apenas de um dos tipos a seguir:
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 de visualização de elementos.
bigqueryExportOptions

object (BigQueryExportOptions)

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

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),

  // Union field destination can be only one of the following:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  }
  // End of list of possible types for union field destination.
}
Campos
fileFormat

enum (TableFileFormat)

O formato do arquivo para exportar as tabelas.
Campo de união destination. Onde gravar os resultados. destination pode ser apenas de um dos tipos a seguir:
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.

TableAssetExportOptions

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

Representação JSON 
{

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
Campos
Campo de união destination. Onde gravar os resultados. destination pode ser apenas de um dos tipos a seguir:
earthEngineDestination

object (EarthEngineDestination)

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

FeatureViewAssetExportOptions

Opções para salvar tabelas ou FeatureCollections como mapas de visualização de elementos.

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

  // Union field destination can be only one of the following:
  "featureViewDestination": {
    object (FeatureViewDestination)
  }
  // End of list of possible types for union field destination.
}
Campos
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

Os parâmetros de tempo de transferência do FeatureView. Esses parâmetros precisam ser especificados no momento da transferência e não podem ser atualizados em tempo real.
Campo de união destination. Onde gravar os resultados. destination pode ser apenas de um dos tipos a seguir:
featureViewDestination

object (FeatureViewDestination)

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

FeatureViewDestination

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

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

string

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

integer

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

BigQueryExportOptions

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

Representação JSON 
{

  // Union field destination can be only one of the following:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of list of possible types for union field destination.
}
Campos
Campo de união destination. Onde gravar os dados. destination pode ser apenas de um dos tipos a seguir:
bigqueryDestination

object (BigQueryDestination)

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

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 se aplica se os parâmetros "append" e "overwrite" também forem falsos.

Se o recurso referenciado existir e tiver um esquema compatível, um dos parâmetros "overwrite" e "append" precisa 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 precisam ser substituídos se a tabela 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 precisam 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.