Method: projects.table.export

Inicia un proceso por lotes que calcula una tabla y escribe el resultado en uno de varios destinos.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
project

string

El ID o el número de proyecto de Google Cloud Platform que se debe considerar como el consumidor de servicios para esta solicitud. El formato es projects/{project-id}.

La autorización requiere el siguiente permiso IAM en el recurso especificado project:

  • earthengine.exports.create

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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)

Es una expresión que se evalúa como la tabla para calcular y exportar.
description

string

Es el nombre legible de la tarea.
selectors[]

string

Es una lista explícita de las columnas que se incluirán en el resultado.
requestId

string

Es una cadena única que se usa para detectar solicitudes duplicadas. Si el mismo usuario realiza más de una solicitud con el mismo requestId no vacío, solo una de esas solicitudes puede iniciar correctamente una operación de larga duración. requestId puede contener los caracteres a-z, A-Z, 0-9 o "-". requestId puede tener como máximo 60 caracteres.
maxErrorMeters

number

Es el error máximo permitido en metros cuando se transforma la geometría entre sistemas de coordenadas. Si está vacío, el error máximo es de 1 metro de forma predeterminada.
maxVertices

integer

Es la cantidad máxima de vértices sin cortar por geometría. Las geometrías con más vértices se cortarán en piezas más pequeñas que este tamaño.
workloadTag

string

Etiqueta proporcionada por el usuario para hacer un seguimiento de este cálculo.
priority

integer

Opcional. Es la prioridad de la tarea de exportación dentro del proyecto. Las tareas de prioridad más alta se programan antes. Debe ser un número entero entre 0 y 9999. Si la opción no está configurada, se establece en 100 de forma predeterminada.
Campo de unión export_options. Son opciones que describen dónde y cómo almacenar los resultados. Las direcciones (export_options) solo pueden ser una de las siguientes opciones:
fileExportOptions

object (TableFileExportOptions)

Si se especifica, configura la exportación como un archivo.
assetExportOptions

object (TableAssetExportOptions)

Si se especifica, configura la exportación como un recurso de Earth Engine.
featureViewExportOptions

object (FeatureViewAssetExportOptions)

Si se especifica, configura la exportación como un mapa de FeatureView.
bigqueryExportOptions

object (BigQueryExportOptions)

Si se especifica, configura la exportación de datos tabulares a BigQuery.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

TableFileExportOptions

Son opciones para exportar tablas como archivos fuera de Earth Engine.

Representación 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)

Es el formato de archivo en el que se exportarán las tablas.
Campo de unión destination. Es el lugar en el que se escriben los resultados. Las direcciones (destination) solo pueden ser una de las siguientes opciones:
driveDestination

object (DriveDestination)

Si se especifica, configura la exportación a Google Drive.
cloudStorageDestination

object (CloudStorageDestination)

Si se especifica, configura la exportación a Google Cloud Storage.

TableAssetExportOptions

Opciones para guardar tablas como recursos de Earth Engine.

Representación 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ón destination. Es el lugar en el que se escriben los resultados. Las direcciones (destination) solo pueden ser una de las siguientes opciones:
earthEngineDestination

object (EarthEngineDestination)

Si se especifica, configura la exportación a Earth Engine.

FeatureViewAssetExportOptions

Opciones para guardar tablas o FeatureCollections como mapas de FeatureView.

Representación 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)

Los parámetros de tiempo de transferencia de FeatureView Estos parámetros se deben especificar en el momento de la transferencia y no se pueden actualizar sobre la marcha.
Campo de unión destination. Es el lugar en el que se escriben los resultados. Las direcciones (destination) solo pueden ser una de las siguientes opciones:
featureViewDestination

object (FeatureViewDestination)

Si se especifica, configura la exportación a FeatureViews.

FeatureViewDestination

Configuración para un destino de FeatureView de Earth Engine.

Representación JSON 
{
  "name": string,
  "assetVersion": integer
}
Campos
name

string

Es obligatorio. El ID del activo de FeatureView. El servidor genera un nombre de mapa a partir del ID.
assetVersion

integer

La versión del activo de FeatureView que se creará. Se usa para crear alias de versiones con recursos. Si no se establece, se usará 0.

BigQueryExportOptions

Opciones para exportar datos tabulares a BigQuery.

Representación 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ón destination. Dónde escribir los datos. Las direcciones (destination) solo pueden ser una de las siguientes opciones:
bigqueryDestination

object (BigQueryDestination)

Si se especifica, configura la exportación a BigQuery.

BigQueryDestination

Configuración de un destino en BigQuery.

Representación JSON 
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
Campos
table

string

Es obligatorio. Es la referencia de la tabla de destino de BigQuery en el siguiente formato: “projectId.dataset_id.table_id”.

Si el recurso al que se hace referencia no existe, se creará una tabla nueva. Esto se aplica si los parámetros "append" y "overwrite" también son falsos.

Si el recurso al que se hace referencia existe y tiene un esquema compatible, uno de los parámetros "overwrite" y "append" debe ser verdadero; de lo contrario, la tarea fallará.

Si el recurso al que se hace referencia existe y el esquema no es compatible con el existente, la tarea también fallará.
overwrite

boolean

Especifica si se deben reemplazar los datos de la tabla si esta ya existe y tiene un esquema compatible.

Los parámetros overwrite y append no pueden ser true de forma simultánea.
append

boolean

Especifica si se deben adjuntar los datos de la tabla si esta ya existe y tiene un esquema compatible.

Los parámetros overwrite y append no pueden ser true de forma simultánea.