Method: projects.map.export

Inicia un proceso por lotes que calcula un mapa en mosaicos y escribe el resultado en Google Cloud Storage.

Solicitud HTTP

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/map:export

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

Parámetros de ruta

Parámetros
project

string

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,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
Campos
expression

object (Expression)

Una expresión que se evalúa en la imagen para calcular y exportar. Los límites de la imagen se usarán para determinar el conjunto de mosaicos del mapa que se renderizarán. Para controlar la región exportada, recorta la imagen antes de exportarla.
description

string

Un nombre de la tarea legible por humanos.
tileOptions

object (TileOptions)

Opciones que describen los mosaicos del mapa que se generarán.
tileExportOptions

object (ImageFileExportOptions)

Opciones para dónde y en qué formato exportar los mosaicos del mapa. Actualmente, Cloud Storage es el único destino admitido para las exportaciones de mapas.
requestId

string

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 una longitud máxima de 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, el valor predeterminado es 100.

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.

TileOptions

Opciones que describen los mosaicos de mapas de imágenes o videos que se exportarán.

Representación JSON 
{
  "startZoom": integer,
  "minZoom": integer,
  "skipEmpty": boolean,
  "skipEmptyTiles": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "tileDimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "endZoom": integer,
  "maxZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
Campos
startZoom

integer

Es el nivel de zoom para comenzar a generar mosaicos de mapas para la exportación. El valor predeterminado es cero.
minZoom
(deprecated)

integer

Es el nivel de zoom para comenzar a generar mosaicos de mapas para la exportación. El valor predeterminado es cero.
skipEmpty

boolean

Si es verdadero, omite la escritura de mosaicos de mapas vacíos (es decir, completamente transparentes).
skipEmptyTiles
(deprecated)

boolean

Si es verdadero, omite la escritura de mosaicos de mapas vacíos (es decir, completamente transparentes).
mapsApiKey

string

Es la clave de API de Google Maps Platform opcional para el visor de mosaicos de mapas generados.
dimensions

object (GridDimensions)

Es el ancho y la altura de los mosaicos de video de salida, que se usan solo para exportar pirámides de video en mosaicos (ExportVideoMap).
tileDimensions
(deprecated)

object (GridDimensions)

Es el ancho y la altura de los mosaicos de video de salida, que se usan solo para exportar pirámides de video en mosaicos (ExportVideoMap).
stride

integer

Es el paso de fila y columna de los mosaicos. (ExportVideoMap) Se establece en 4 para mosaicos dispersos (solo WebGL) o 1 (predeterminado) para obtener la máxima compatibilidad.
zoomSubset

object (ZoomSubset)

Es un subconjunto de niveles de zoom para los que se generarán mosaicos. Solo se puede especificar en una llamada a ExportVideoMap.
Es el nivel de zoom o la escala en la que se dejarán de generar mosaicos de mapas. Se debe especificar uno de ellos. A continuación, se incluye una lista de campos mutuamente excluyentes. Se establecerá como máximo uno de los campos en una respuesta:
endZoom

integer

Es el nivel de zoom para dejar de generar mosaicos de mapas.
maxZoom
(deprecated)

integer

Es el nivel de zoom para dejar de generar mosaicos de mapas.
scale

number

Es la resolución máxima de la imagen en metros por píxel. La escala se convertirá en el nivel de zoom máximo más adecuado en el ecuador.
Fin de los campos mutuamente excluyentes.

ZoomSubset

Es un subconjunto de niveles de zoom para los que se generarán mosaicos (ExportVideoMap). Los subconjuntos de inicio y finalización son valores de doble precisión, lo que te permite renderizar un nivel de zoom o niveles de forma incremental. Para renderizar una pirámide completa con un zoom inicial de 12: startZoom=0, endZoom=12, no configures este mensaje. Para renderizar los niveles 0 a 11 y el primer 10% del nivel 12: startZoom=0, endZoom=12, subset = {min=0, max=12.1 }. Para renderizar el siguiente 10% del nivel 12: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 }. Para renderizar el 80% restante del nivel 12: startZoom=0, endZoom=12, subset = {min=12.2, max=13 }. También ten en cuenta que todos los fragmentos de exportación deben tener el mismo tamaño de pirámide (completo) en start/endZoom.

Representación JSON 
{
  "start": number,
  "end": number,
  "min": number,
  "max": number
}
Campos
start

number

Es el subconjunto de nivel de zoom inicial para el que se generarán mosaicos (ExportVideoMap). Aquí, el subconjunto es un valor de doble precisión, lo que te permite renderizar un nivel de zoom de forma incremental, por lo que 12.1, por ejemplo, es el primer 10% de los mosaicos en el zoom 12 en un orden no especificado, pero determinista.
end

number

Es el subconjunto de nivel de zoom final para el que se generarán mosaicos (ExportVideoMap), lo que te permite renderizar un nivel de zoom de forma incremental, hasta el subconjunto máximo (si se proporciona), pero sin incluirlo, en un orden no especificado, pero determinista.
min
(deprecated)

number

Es el subconjunto de nivel de zoom inicial para el que se generarán mosaicos (ExportVideoMap). Aquí, el subconjunto es un valor de doble precisión, lo que te permite renderizar un nivel de zoom de forma incremental, por lo que 12.1, por ejemplo, es el primer 10% de los mosaicos en el zoom 12 en un orden no especificado, pero determinista.
max
(deprecated)

number

Es el subconjunto de nivel de zoom final para el que se generarán mosaicos (ExportVideoMap), lo que te permite renderizar un nivel de zoom de forma incremental, hasta el subconjunto máximo (si se proporciona), pero sin incluirlo, en un orden no especificado, pero determinista.