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/v1alpha/{project=projects/*}/image: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,
  "maxPixels": string,
  "grid": {
    object (PixelGrid)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // 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 imagen que se debe calcular y exportar.

description

string

Es el nombre legible de la tarea.

maxPixels

string (Int64Value format)

Es la cantidad máxima de píxeles que se deben calcular y exportar. Esta es una medida de seguridad para evitar que inicies accidentalmente una exportación más grande de lo que deseas. 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 parámetros que describen cómo se debe volver a proyectar y recortar la imagen que calcula 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

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 (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.

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 opciones para guardar imágenes como recursos de Earth Engine.

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

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

enum (PyramidingPolicy)

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

pyramidingPolicyOverrides

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

Anulaciones específicas de la política de pirámide por banda

Es un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

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.