Этот метод отображает список изображений в коллекции. Он позволяет вызывающей стороне применять пространственно-временные фильтры и фильтры метаданных к коллекции изображений.
HTTP-запрос
GET https://earthengine.googleapis.com/v1alpha/{parent=projects/*/assets/**}:listImages
В URL-адресе используется синтаксис транскодирования gRPC .
Параметры пути
| Параметры | |
|---|---|
parent | Обязательно. Имя ресурса коллекции изображений для отображения. Для авторизации требуются следующие разрешения IAM для указанного
|
Параметры запроса
| Параметры | |
|---|---|
pageSize | Максимальное количество результатов на странице. Сервер может вернуть меньше ресурсов, чем запрошено. Если не указано, размер страницы по умолчанию зависит от EarthEngineAssetView, при этом для более ограниченных представлений действуют более высокие ограничения. |
pageToken | Токен, идентифицирующий страницу результатов, которую должен вернуть сервер. Как правило, это значение |
startTime | Если указана эта метка времени, результаты фильтруются, оставляя только те, у которых она не меньше этого значения (включительно). Используется RFC 3339, согласно которому сгенерированный вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
endTime | Если указана эта опция, фильтрует результаты, оставляя только те, у которых метка времени меньше этого значения (исключая другие). Используется RFC 3339, согласно которому сгенерированный вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
region | Если присутствует, геометрическая модель, определяющая область запроса, указывается в виде строки геометрии GeoJSON (см. RFC 7946). Точность пространственного пересечения составляет один метр. |
filter | Если присутствует, указывает дополнительные простые фильтры свойств. |
view | Указывает, какие части ресурса |
Текст запроса
Тело запроса должно быть пустым.
Ответный текст
Ответное сообщение для EarthEngineService.ListImages.
В случае успеха тело ответа содержит данные следующей структуры:
| JSON-представление |
|---|
{
"images": [
{
object ( |
| Поля | |
|---|---|
images[] | Список изображений, соответствующих запросу. |
nextPageToken | Токен для получения следующей страницы результатов. Передайте это значение в поле |
Области полномочий
Требуется один из следующих диапазонов аутентификации OAuth:
-
https://www.googleapis.com/auth/earthengine -
https://www.googleapis.com/auth/earthengine.readonly -
https://www.googleapis.com/auth/cloud-platform -
https://www.googleapis.com/auth/cloud-platform.read-only
Для получения более подробной информации см.OAuth 2.0 Overview .
Изображение
Информация об изображении, полученном с помощью Earth Engine.
| JSON-представление |
|---|
{
"name": string,
"id": string,
"updateTime": string,
"title": string,
"description": string,
"properties": {
object
},
"startTime": string,
"endTime": string,
"geometry": {
object
},
"bands": [
{
object ( |
| Поля | |
|---|---|
name | Название образа, если оно присутствует. |
id | Идентификатор изображения, если он присутствует. Эквивалентно |
updateTime | Время последнего изменения изображения. Используется RFC 3339, согласно которому сгенерированный вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
title | Название актива. |
description | Описание актива. |
properties | Ключевые/значные свойства, связанные с изображением. |
startTime | Временная метка, связанная с изображением, если таковая имеется, например, время, когда был сделан спутниковый снимок. Для данных, соответствующих определенному временному интервалу, таких как средние значения за месяц или год, эта временная метка соответствует началу этого интервала. Используется RFC 3339, согласно которому сгенерированный вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
endTime | Для активов, соответствующих определенному временному интервалу, например, средним значениям за месяц или год, эта временная метка соответствует концу этого интервала (исключая его). Используется RFC 3339, согласно которому сгенерированный вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: |
geometry | Пространственный след, связанный с изображением, если таковой имеется, представлен в виде геометрического объекта GeoJSON (см. RFC 7946). |
bands[] | Информация о полосах данных изображения. |
sizeBytes | Размер конечного ресурса (например, изображения) в байтах. Как правило, для сохраненных изображений он должен быть ненулевым, а для вычисленных — нулевым. |