Muestra una lista de las imágenes de un recurso de colección de imágenes. Este método permite que el llamador aplique filtros espaciotemporales y de metadatos a una colección de imágenes.
Solicitud HTTP
GET https://earthengine.googleapis.com/v1alpha/{parent=projects/*/assets/**}:listImages
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros | |
|---|---|
parent |
Es obligatorio. Es el nombre del recurso de la colección de imágenes que se mostrará. La autorización requiere el siguiente permiso IAM en el recurso especificado
|
Parámetros de consulta
| Parámetros | |
|---|---|
pageSize |
Es la cantidad máxima de resultados por página. Es posible que el servidor devuelva menos recursos de los solicitados. Si no se especifica, el tamaño de página predeterminado depende de EarthEngineAssetView, con límites más altos para vistas más restrictivas. |
pageToken |
Un token que identifica una página de resultados que debe mostrar el servidor. Por lo general, este es el valor de |
startTime |
Si está presente, filtra los resultados a aquellos cuya marca de tiempo sea de al menos este valor (inclusive). Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
endTime |
Si está presente, filtra los resultados a aquellos cuya marca de tiempo sea inferior a este valor (excluyente). Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
region |
Si está presente, es una geometría que define una región de consulta, especificada como una cadena de geometría GeoJSON (consulta RFC 7946). La intersección espacial tiene una precisión de un metro. |
filter |
Si está presente, especifica filtros de propiedades simples adicionales. |
view |
Especifica qué partes del recurso |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Mensaje de respuesta para EarthEngineService.ListImages.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
| Representación JSON |
|---|
{
"images": [
{
object ( |
| Campos | |
|---|---|
images[] |
Es la lista de imágenes que coinciden con la búsqueda. |
nextPageToken |
Un token para recuperar los resultados de la página siguiente. Pasa este valor en el campo |
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.
Imagen
Información sobre una imagen de Earth Engine.
| Representación JSON |
|---|
{
"name": string,
"id": string,
"updateTime": string,
"title": string,
"description": string,
"properties": {
object
},
"startTime": string,
"endTime": string,
"geometry": {
object
},
"bands": [
{
object ( |
| Campos | |
|---|---|
name |
Es el nombre de la imagen, si corresponde. |
id |
El ID de la imagen, si está presente. Es equivalente a |
updateTime |
Es la hora de la última modificación de la imagen. Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
title |
Es el título del activo. |
description |
Es la descripción del activo. |
properties |
Propiedades clave-valor asociadas con la imagen. |
startTime |
La marca de tiempo asociada con la imagen, si corresponde, p.ej., la hora en la que se tomó una imagen satelital. En el caso de los recursos que corresponden a un intervalo de tiempo, como los valores promedio durante un mes o un año, esta marca de tiempo corresponde al inicio de ese intervalo. Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
endTime |
En el caso de los recursos que corresponden a un intervalo de tiempo, como los valores promedio durante un mes o un año, esta marca de tiempo corresponde al final de ese intervalo (exclusivo). Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: |
geometry |
La huella espacial asociada con la imagen, si la hay, como un objeto de geometría GeoJSON (consulta RFC 7946). |
bands[] |
Información sobre las bandas de datos de la imagen. |
sizeBytes |
Es el tamaño de un recurso de nivel inferior (p.ej., una imagen) en bytes. Por lo general, debe ser distinto de cero para las imágenes almacenadas y cero para las calculadas. |