Объявление : Все некоммерческие проекты, зарегистрированные для использования Earth Engine до
15 апреля 2025 года, должны
подтвердить некоммерческое право на сохранение доступа к Earth Engine.
Method: projects.assets.getPixels
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Извлекает пиксели из ресурса изображения. Этот пользовательский метод позволяет вызывающему объекту запрашивать произвольный фрагмент пикселей изображения, при необходимости указывая полосы и проекцию карты. Замаскированные или отсутствующие данные будут закодированы как нули.
Запросы ограничены 48 МБ несжатых данных на запрос, вычисляемых как произведение размеров запроса в пикселях, количества запрошенных полос изображения и количества байтов на пиксель для каждой полосы. Запросы также ограничены максимум 32 000 пикселей в любом измерении и не более 1024 полос. Запросы, превышающие эти ограничения, приведут к коду ошибки 400 (BAD_REQUEST).
В случае успеха тело ответа содержит запрошенные данные пикселей в кодировке, указанной в поле fileFormat запроса.
HTTP-запрос
POST https://earthengine.googleapis.com/v1/{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 ресурса: |
Тело запроса
Тело запроса содержит данные следующей структуры:
| Поля |
|---|
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 .
,
Извлекает пиксели из ресурса изображения. Этот пользовательский метод позволяет вызывающему объекту запрашивать произвольный фрагмент пикселей изображения, при необходимости указывая полосы и проекцию карты. Замаскированные или отсутствующие данные будут закодированы как нули.
Запросы ограничены 48 МБ несжатых данных на запрос, вычисляемых как произведение размеров запроса в пикселях, количества запрошенных полос изображения и количества байтов на пиксель для каждой полосы. Запросы также ограничены максимум 32 000 пикселей в любом измерении и не более 1024 полос. Запросы, превышающие эти ограничения, приведут к коду ошибки 400 (BAD_REQUEST).
В случае успеха тело ответа содержит запрошенные данные пикселей в кодировке, указанной в поле fileFormat запроса.
HTTP-запрос
POST https://earthengine.googleapis.com/v1/{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 ресурса: |
Тело запроса
Тело запроса содержит данные следующей структуры:
| Поля |
|---|
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 .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 2025-07-25 UTC."],[[["\u003cp\u003eFetches pixel data from Earth Engine image assets, allowing users to specify bands, regions, and output formats.\u003c/p\u003e\n"],["\u003cp\u003eRequests are limited to 48MB uncompressed data, 32K pixels in each dimension, and 1024 bands; exceeding these limits results in a 400 error.\u003c/p\u003e\n"],["\u003cp\u003ePixel data can be returned in various formats, including raw data and visualizations based on specified parameters.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization using one of the specified OAuth scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eUsers can provide a workload tag for tracking the computation.\u003c/p\u003e\n"]]],[],null,["# Method: projects.assets.getPixels\n\nFetches pixels from an image asset. This custom method allows the caller to request an arbitrary tile of pixels from an image, optionally specifying the bands and map projection. Masked or missing data will be encoded as zeroes.\n\nRequests are limited to 48MB in uncompressed data per request, computed as the product of the request dimensions in pixels, the number of image bands requested, and the number of bytes per pixel for each band. Requests are also limited to at most 32K pixels in either dimension and at most 1024 bands. Requests exceeding these limits will result in an error code of 400 (BAD_REQUEST).\n\nIf successful, the response body contains the requested pixel data in the encoding specified in the `fileFormat` field of the request.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1/{name=projects/*/assets/**}:getPixels`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of the image asset from which to get pixels. `name` is of the format \"projects/\\*/assets/\\*\\*\" (e.g., \"projects/earthengine-legacy/assets/users/\\[USER\\]/\\[ASSET\\]\"). All user-owned assets are under the project \"earthengine-legacy\" (e.g., \"projects/earthengine-legacy/assets/users/foo/bar\"). All other assets are under the project \"earthengine-public\" (e.g., \"projects/earthengine-public/assets/LANDSAT\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `name`: - `earthengine.assets.get` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"fileFormat\": enum (/earth-engine/reference/rest/v1/ImageFileFormat), \"grid\": { object (/earth-engine/reference/rest/v1/PixelGrid) }, \"region\": { object }, \"bandIds\": [ string ], \"visualizationOptions\": { object (/earth-engine/reference/rest/v1/VisualizationOptions) }, \"workloadTag\": string } ``` |\n\n| Fields ||\n|------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `fileFormat` | `enum (`[ImageFileFormat](/earth-engine/reference/rest/v1/ImageFileFormat)`)` The output file format in which to return the pixel values. |\n| `grid` | `object (`[PixelGrid](/earth-engine/reference/rest/v1/PixelGrid)`)` Parameters describing the pixel grid in which to fetch data. Defaults to the native pixel grid of the data. |\n| `region` | `object (`[Struct](https://protobuf.dev/reference/protobuf/google.protobuf/#struct)` format)` If present, the region of data to return, specified as a GeoJSON geometry object (see RFC 7946). Since the returned image is always rectangular, the bounding box of the given geometry in the output coordinate system will actually be used. If `grid.dimensions` is also specified then the grid will finally be rescaled to the requested size. |\n| `bandIds[]` | `string` If present, specifies a specific set of bands from which to get pixels. Bands are identified by id, as indicated by the `id` field of an ImageBand proto. |\n| `visualizationOptions` | `object (`[VisualizationOptions](/earth-engine/reference/rest/v1/VisualizationOptions)`)` If present, a set of visualization options to apply to produce an 8-bit RGB visualization of the data, rather than returning the raw data. |\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Response body\n\nIf successful, the response is a generic HTTP response whose format is defined by the method.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/earthengine.readonly`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/cloud-platform.read-only`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
