Method: projects.image.export

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

Solicitud HTTP

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

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

Parámetros de ruta

Parámetros
project

string

Es el ID o el número de 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,
  "maxPixels": string,
  "grid": {
    object (PixelGrid)
  },
  "requestId": string,
  "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 (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of mutually exclusive fields.
}
Campos
expression

object (Expression)

Es una expresión que se evalúa en la imagen que se debe calcular y exportar.
description

string

Es un nombre de la tarea legible por humanos.
maxPixels

string (Int64Value format)

Es la cantidad máxima de píxeles que se deben calcular y exportar. Esta es una protección de seguridad para evitar que inicies accidentalmente una exportación más grande de lo que tenías previsto. El valor predeterminado es de 1e8 píxeles, pero puedes establecer el valor de forma explícita para aumentar o disminuir este límite.
grid

object (PixelGrid)

Son los parámetros que describen cómo se debe volver a proyectar y recortar la imagen calculada por expression. Si no está presente, se muestra la imagen calculada completa en su proyección nativa.
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.
workloadTag

string

Es la etiqueta proporcionada por el usuario para hacer un seguimiento de este cálculo.
priority

integer

Es 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 no se establece, se establece en 100 de forma 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. Se establecerá como máximo uno de los campos en una respuesta:
fileExportOptions

object (ImageFileExportOptions)

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

object (ImageAssetExportOptions)

Si se especifica, configura la exportación como un recurso de Earth Engine.
Fin de los campos mutuamente excluyentes.

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.

ImageAssetExportOptions

Son las opciones para guardar imágenes como recursos de Earth Engine.

Representación JSON 
{
  "pyramidingPolicy": enum (PyramidingPolicy),
  "pyramidingPolicyOverrides": {
    string: enum (PyramidingPolicy),
    ...
  },

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

enum (PyramidingPolicy)

Es la política de piramidación que se aplica de forma predeterminada a todas las bandas.
pyramidingPolicyOverrides

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

Son las anulaciones de políticas de pirámide específicas por banda.

Un objeto que contiene una lista de "key": value pares. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Es el lugar en el que se escriben los resultados. A continuación, se incluye una lista de campos mutuamente excluyentes. Se establecerá como máximo uno de los campos en una respuesta:
earthEngineDestination

object (EarthEngineDestination)

Si se especifica, configura la exportación a Earth Engine.
Fin de los campos mutuamente excluyentes.