Crea un ID que se puede usar para renderizar una imagen de "miniatura".
Se usa junto con GetThumbnailPixels. Una llamada a thumbnails.create proporciona una expresión y algunas opciones de salida. El resultado de thumbnails.create es un ID que representa una imagen que es el resultado de evaluar esa expresión y aplicar esas opciones. Posteriormente, se pueden realizar llamadas a GetThumbnailPixels para obtener los datos de imagen de toda la imagen resultante. El ID tendrá validez durante un período moderado (unas horas).
El caso de uso más común para este par de extremos es proporcionar una expresión compleja a través de una solicitud POST a thumbnails.create y, luego, recuperar la imagen calculada a través de una solicitud GET a GetThumbnailPixels. Este proceso de dos partes permite su uso en más situaciones que ComputePixels. En particular: - El resultado de ComputePixels debe desenvolverse para obtener los bytes de imagen codificados. Un navegador puede mostrar directamente el resultado de GetThumbnailPixels. - Solo un usuario autorizado puede llamar a ComputePixels con un token de OAuth con el alcance adecuado. thumbnails.create tiene la misma restricción, pero GetThumbnailPixels se puede invocar con una URL que contiene una clave de API, por lo que las URLs que la invocan se pueden usar de forma más amplia.
El resultado de la evaluación de la expresión 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.
La descripción "miniatura" no implica una restricción en el tamaño de la imagen calculada: las mismas restricciones que se aplican a ComputePixels se aplican a thumbnails.create/GetThumbnailPixels. Las solicitudes se limitan a 48 MB de datos sin comprimir por solicitud, que se calculan como el producto de las dimensiones de la solicitud en píxeles, la cantidad de bandas de imagen solicitadas y la cantidad de bytes por píxel de cada banda. Las solicitudes también se limitan a un máximo de 32,000 píxeles en cualquier dimensión y 1,024 bandas como máximo. Las solicitudes que superen estos límites generarán un código de error 400 (BAD_REQUEST).
Solicitud HTTP
POST https://earthengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/thumbnails
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 miniaturas (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 Thumbnail.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Thumbnail.
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.