Anuncio: Todos los proyectos no comerciales registrados para usar Earth Engine antes del 15 de abril de 2025 deben verificar su elegibilidad no comercial para mantener el acceso a Earth Engine.

Se usó la API de Cloud Translation para traducir esta página.

Method: projects.map.export

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

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros

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`

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

Representación JSON
{ "expression": { object (`Expression`) }, "description": string, "tileOptions": { object (`TileOptions`) }, "tileExportOptions": { object (`ImageFileExportOptions`) }, "requestId": string, "workloadTag": string, "priority": integer }

{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}

Campos
`expression`	`object (Expression)` Es una expresión que se evalúa como la imagen que se debe 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` Es el nombre legible de la tarea.
`tileOptions`	`object (TileOptions)` Son opciones que describen las tarjetas del mapa que se generarán.
`tileExportOptions`	`object (ImageFileExportOptions)` Son opciones para exportar las tarjetas del mapa y dónde hacerlo. Actualmente, Cloud Storage es el único destino admitido para las exportaciones de mapas.
`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.

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

Son opciones que describen las tarjetas de mapas de imágenes o videos que se exportarán.

Representación JSON

Representación JSON
{ "startZoom": integer, "skipEmpty": boolean, "mapsApiKey": string, "dimensions": { object (`GridDimensions`) }, "stride": integer, "zoomSubset": { object (`ZoomSubset`) }, // Union field `end_zoom_or_scale` can be only one of the following: "endZoom": integer, "scale": number // End of list of possible types for union field `end_zoom_or_scale`. }

{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}

Campos
`startZoom`	`integer` Es el nivel de zoom para comenzar a generar mosaicos de mapas para exportar. El valor predeterminado es cero.
`skipEmpty`	`boolean` Si es verdadero, omite la escritura de mosaicos de mapa vacíos (es decir, completamente transparentes).
`mapsApiKey`	`string` Clave de API opcional de Google Maps Platform para el visor de mosaicos de mapas generados.
`dimensions`	`object (GridDimensions)` Es el ancho y la altura de las tarjetas de video de salida, que se usan solo para exportar pirámides de video en mosaico (ExportVideoMap).
`stride`	`integer` Paso de filas y columnas de 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`.
Campo de unión `end_zoom_or_scale`. Es el nivel de zoom o la escala en el que se debe dejar de generar mosaicos de mapas. Se debe especificar uno de ellos. Las direcciones (`end_zoom_or_scale`) solo pueden ser una de las siguientes opciones:
`endZoom`	`integer` Es el nivel de zoom para el que se dejarán de generar mosaicos del mapa.
`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.

ZoomSubset

Es un subconjunto de niveles de zoom para los que se deben generar mosaicos (ExportVideoMap). Los subconjuntos de inicio y finalización son valores de precisión doble, 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 del 0 al 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 }. Además, ten en cuenta que todos los fragmentos de exportación deben tener el mismo tamaño de pirámide (completo) en startZoom/endZoom.

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

Campos

Campos
`start`	`number` Es el subconjunto del nivel de zoom inicial para el que se generarán las tarjetas (ExportVideoMap). Aquí, el subconjunto es un valor de precisión doble que te permite renderizar un nivel de zoom de forma incremental, por lo que 12.1, por ejemplo, es el primer 10% de las tarjetas en el zoom 12 en algún orden no especificado, pero determinista.
`end`	`number` Es el subconjunto de nivel de zoom final para el que se generarán las tarjetas (ExportVideoMap), lo que te permite renderizar un nivel de zoom de forma incremental, hasta el subconjunto máximo (si se proporciona) en un orden no especificado, pero determinista.

start

number

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

end