Method: projects.assets.getPixels

Извлекает пиксели из ресурса изображения. Этот пользовательский метод позволяет вызывающему объекту запрашивать произвольный фрагмент пикселей изображения, при необходимости указывая полосы и проекцию карты. Замаскированные или отсутствующие данные будут закодированы как нули.

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

В случае успеха тело ответа содержит запрошенные данные пикселей в кодировке, указанной в поле fileFormat запроса.

HTTP-запрос

POST https://earthengine.googleapis.com/v1beta/{name=projects/*/assets/**}:getPixels

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

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

Параметры
name

string

Необходимый. Имя ресурса изображения, из которого можно получить пиксели. name имеет формат «projects/*/assets/**» (например, «projects/earthengine-legacy/assets/users/[USER]/[ASSET]»). Все ресурсы, принадлежащие пользователям, относятся к проекту «earthengine-legacy» (например, «projects/earthengine-legacy/assets/users/foo/bar»). Все остальные активы относятся к проекту «earthengine-public» (например, «projects/earthengine-public/assets/LANDSAT»).

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

  • earthengine.assets.get

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "region": {
    object
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
Поля
fileFormat

enum ( ImageFileFormat )

Формат выходного файла, в котором возвращаются значения пикселей.

grid

object ( PixelGrid )

Параметры, описывающие сетку пикселей, из которой извлекаются данные. По умолчанию используется собственная пиксельная сетка данных.

region

object ( Struct format)

Если присутствует, область возвращаемых данных, указанная как объект геометрии GeoJSON (см. RFC 7946). Поскольку возвращаемое изображение всегда прямоугольное, фактически будет использоваться ограничивающая рамка заданной геометрии в выходной системе координат. Если также указан grid.dimensions , то сетка, наконец, будет масштабирована до запрошенного размера.

bandIds[]

string

Если присутствует, указывает конкретный набор полос, из которых нужно получить пиксели. Полосы идентифицируются по идентификатору, как указано в поле id прототипа ImageBand.

visualizationOptions

object ( VisualizationOptions )

Если присутствует, набор параметров визуализации, которые необходимо применить для создания 8-битной RGB-визуализации данных вместо возврата необработанных данных.

workloadTag

string

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

Тело ответа

В случае успеха ответ представляет собой общий ответ HTTP, формат которого определяется методом.

Области авторизации

Требуется одна из следующих областей 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 .