Crea un ID que se puede usar para renderizar tarjetas de mapa que muestran los resultados de un procesamiento. El ID resultante se debe usar como parte de las solicitudes de GetTile.
Se usa junto con GetTile. Una llamada a maps.create proporciona una expresión y algunas opciones de salida. El resultado de maps.create es un ID de mapa que representa una imagen que es el resultado de evaluar esa expresión y aplicar esas opciones. Posteriormente, se pueden realizar llamadas a GetTile para obtener datos de imagen de una tarjeta de la imagen resultante, en cualquier ubicación y zoom deseados. El ID del mapa tendrá validez durante un período moderado (unas horas).
El caso de uso más común para este par de extremos es propagar un viewport de mapa con una visualización del resultado de algún cálculo. Para que eso sea posible, el resultado del procesamiento debe cumplir con algunos requisitos razonables para el formato de imagen solicitado. En particular, el formato JPEG o PNG requiere que haya una o tres bandas de salida y que se recorten los valores que estén fuera del rango de 0 a 255.
Solicitud HTTP
POST https://earthengine.googleapis.com/v1beta/{parent=projects/*}/maps
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros | |
|---|---|
parent |
Es obligatorio. El elemento superior de la colección de mapas (p.ej., "projects/*"). La autorización requiere el siguiente permiso IAM en el recurso especificado
|
Parámetros de consulta
| Parámetros | |
|---|---|
workloadTag |
Es la etiqueta que proporcionó el usuario para hacer un seguimiento de este cálculo. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de EarthEngineMap.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de EarthEngineMap.
Permisos de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/earthenginehttps://www.googleapis.com/auth/earthengine.readonlyhttps://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/cloud-platform.read-only
Para obtener más información, consulta OAuth 2.0 Overview.