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/v1/{project=projects/*}/table:export

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

Parámetros de ruta

Parámetros
project

string

Es el ID o número del proyecto de Google Cloud Platform que se debe tratar 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,

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

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

description

string

Es el nombre de la tarea legible por humanos.

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 podrá iniciar correctamente una operación de larga duración. requestId puede contener los caracteres de la a a la z, de la A a la Z, del 0 al 9 o "-", y requestId puede tener hasta 60 caracteres.

maxErrorMeters

number

Es el error máximo permitido en metros al transformar 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 partes más pequeñas que este tamaño.

workloadTag

string

Es la 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 mayor prioridad 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 manera predeterminada.

Son las opciones que describen dónde y cómo almacenar los resultados. A continuación, se incluye una lista de campos mutuamente excluyentes. En una respuesta, se establecerá, como máximo, uno de los siguientes campos:
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 activo 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.

Fin de los campos mutuamente exclusivos.

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

Opciones para exportar tablas como archivos fuera de Earth Engine.

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

Es el formato de archivo en el que se exportarán las tablas.

Lugar donde se escribirán los resultados. A continuación, se incluye una lista de campos mutuamente excluyentes. En una respuesta, se establecerá, como máximo, uno de los siguientes campos:
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.

Fin de los campos mutuamente exclusivos.

TableAssetExportOptions

Son opciones para guardar tablas como recursos de Earth Engine.

Representación 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
Lugar donde se escribirán los resultados. A continuación, se incluye una lista de campos mutuamente excluyentes. En una respuesta, se establecerá, como máximo, uno de los siguientes campos:
earthEngineDestination

object (EarthEngineDestination)

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

Fin de los campos mutuamente exclusivos.

FeatureViewAssetExportOptions

Son opciones para guardar tablas o FeatureCollections como mapas de FeatureView.

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

Son los parámetros de tiempo de la transferencia de datos de FeatureView. Estos parámetros se deben especificar en el momento de la transferencia y no se pueden actualizar sobre la marcha.

Lugar donde se escribirán los resultados. A continuación, se incluye una lista de campos mutuamente excluyentes. En una respuesta, se establecerá, como máximo, uno de los siguientes campos:
featureViewDestination

object (FeatureViewDestination)

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

Fin de los campos mutuamente exclusivos.

FeatureViewDestination

Es la configuración para un destino de FeatureView de Earth Engine.

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

string

Obligatorio. Es el ID del activo de FeatureView. El servidor genera un nombre de mapa a partir del ID.

assetVersion

integer

Es 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

Son las opciones para exportar datos tabulares a BigQuery.

Representación 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
Dónde escribir los datos A continuación, se incluye una lista de campos mutuamente excluyentes. En una respuesta, se establecerá, como máximo, uno de los siguientes campos:
bigqueryDestination

object (BigQueryDestination)

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

Fin de los campos mutuamente exclusivos.

BigQueryDestination

Es la configuración de un destino en BigQuery.

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

string

Obligatorio. Referencia a 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 también se aplica si los parámetros "append" y "overwrite" son ambos 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 simultáneamente.

append

boolean

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

Los parámetros overwrite y append no pueden ser true simultáneamente.