Method: projects.thumbnails.create

Создает идентификатор, который можно использовать для визуализации изображения «миниатюры».

Используется вместе с thumbnails.getPixels . Вызов thumbnails.create предоставляет выражение и некоторые параметры вывода. Результатом thumbnails.create является идентификатор, представляющий изображение, являющееся результатом оценки этого выражения и применения этих параметров. Впоследствии можно выполнить вызовы thumbnails.getPixels , чтобы получить данные изображения для всего результирующего изображения. Удостоверение будет действительно в течение умеренного периода (несколько часов).

Наиболее распространенный вариант использования этой пары конечных точек — предоставить сложное выражение через POST для thumbnails.create , а затем получить вычисленное изображение через GET для thumbnails.getPixels . Этот процесс, состоящий из двух частей, позволяет использовать его в большем количестве ситуаций, чем ComputePixels . В частности: - результат ComputePixels необходимо развернуть, чтобы получить байты закодированного изображения. Результат thumbnails.getPixels может отображаться непосредственно в браузере. – ComputePixels может вызываться только авторизованным пользователем с использованием токена OAuth с правильной областью действия. thumbnails.create имеет то же ограничение, но thumbnails.getPixels можно вызывать с помощью URL-адреса, содержащего ключ API, поэтому URL-адреса, вызывающие его, можно использовать более широко.

Результат вычисления выражения должен соответствовать некоторым разумным требованиям для запрошенного формата изображения. В частности, формат JPEG или PNG требует наличия одной или трех выходных полос и значений клипов, выходящих за пределы диапазона 0–255.

Описание «миниатюра» не подразумевает ограничения на размер вычисляемого изображения: к thumbnails.create / thumbnails.getPixels применяются те же ограничения, что и у ComputePixels . Запросы ограничены 48 МБ несжатых данных на запрос, вычисляемых как произведение размеров запроса в пикселях, количества запрошенных полос изображения и количества байтов на пиксель для каждой полосы. Запросы также ограничены максимум 32 000 пикселей в любом измерении и не более 1024 полос. Запросы, превышающие эти ограничения, приведут к коду ошибки 400 (BAD_REQUEST).

HTTP-запрос

POST https://earthengine.googleapis.com/v1beta/{parent=projects/*}/thumbnails

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
parent

string

Необходимый. Родитель коллекции миниатюр (например, «projects/*»).

Для авторизации требуется следующее разрешение IAM для указанного parent ресурса:

  • earthengine.thumbnails.create

Параметры запроса

Параметры
workloadTag

string

Предоставленный пользователем тег для отслеживания этих вычислений.

Тело запроса

Тело запроса содержит экземпляр 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 .