Создает идентификатор, который можно использовать для визуализации изображения «миниатюры».
Используется вместе с GetThumbnailPixels . Вызов thumbnails.create предоставляет выражение и некоторые параметры вывода. Результатом thumbnails.create является идентификатор, представляющий изображение, являющееся результатом оценки этого выражения и применения этих параметров. Впоследствии можно выполнить вызовы GetThumbnailPixels , чтобы получить данные изображения для всего результирующего изображения. Удостоверение будет действительно в течение умеренного периода (несколько часов).
Наиболее распространенный вариант использования этой пары конечных точек — предоставить сложное выражение через POST для thumbnails.create , а затем получить вычисленное изображение через GET для GetThumbnailPixels . Этот процесс, состоящий из двух частей, позволяет использовать его в большем количестве ситуаций, чем ComputePixels . В частности: - результат ComputePixels необходимо развернуть, чтобы получить байты закодированного изображения. Результат GetThumbnailPixels может отображаться непосредственно в браузере. – ComputePixels может вызываться только авторизованным пользователем с использованием токена OAuth с правильной областью действия. thumbnails.create имеет то же ограничение, но GetThumbnailPixels можно вызвать с помощью URL-адреса, содержащего ключ API, поэтому URL-адреса, вызывающие его, можно использовать более широко.
Результат вычисления выражения должен соответствовать некоторым разумным требованиям для запрошенного формата изображения. В частности, формат JPEG или PNG требует наличия одной или трех выходных полос и значений клипов, выходящих за пределы диапазона 0–255.
Описание «миниатюра» не подразумевает ограничения на размер вычисляемого изображения: к thumbnails.create / GetThumbnailPixels применяются те же ограничения, что и у ComputePixels . Запросы ограничены 48 МБ несжатых данных на запрос, вычисляемых как произведение размеров запроса в пикселях, количества запрошенных полос изображения и количества байтов на пиксель для каждой полосы. Запросы также ограничены максимум 32 000 пикселей в любом измерении и не более 1024 полос. Запросы, превышающие эти ограничения, приведут к коду ошибки 400 (BAD_REQUEST).
HTTP-запрос
POST https://earthengine.googleapis.com/v1/{parent=projects/*/locations/*}/thumbnails
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры | |
|---|---|
parent | Необходимый. Родитель коллекции миниатюр (например, «projects/*»). Для авторизации требуется следующее разрешение IAM для указанного
|
Параметры запроса
| Параметры | |
|---|---|
workloadTag | Предоставленный пользователем тег для отслеживания этих вычислений. |
Тело запроса
Тело запроса содержит экземпляр Thumbnail .
Тело ответа
В случае успеха тело ответа будет содержать вновь созданный экземпляр Thumbnail .
Области авторизации
Требуется одна из следующих областей 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 .