Объявление : Все некоммерческие проекты, зарегистрированные для использования Earth Engine до
15 апреля 2025 года, должны
подтвердить некоммерческое право на сохранение доступа к Earth Engine.
Method: projects.imageCollection.computeImages
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Вычисляет набор объектов, применяя произвольные вычисления к объектам в одной или нескольких таблицах. Результаты возвращаются в виде списка изображений.
HTTP-запрос
POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/imageCollection:computeImages
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
project | string Идентификатор или номер проекта Google Cloud Platform, который следует рассматривать как потребителя услуги для этого запроса. Формат: projects/{project-id} . Для авторизации требуется следующее разрешение IAM для указанного project ресурса: -
earthengine.computations.create
|
Тело запроса
Тело запроса содержит данные следующей структуры:
| JSON-представление |
|---|
{
"expression": {
object (Expression)
},
"pageSize": integer,
"pageToken": string,
"workloadTag": string
} |
| Поля |
|---|
expression | object ( Expression ) Выражение для вычисления. |
pageSize | integer Максимальное количество результатов на странице. Сервер может вернуть меньше изображений, чем запрошено. Если не указано, размер страницы по умолчанию составляет 1000 результатов на страницу. |
pageToken | string Токен, идентифицирующий страницу результатов, которую должен вернуть сервер. Обычно это значение ComputeImagesResponse.next_page_token , возвращенное в результате предыдущего вызова метода imageCollection.computeImages . |
workloadTag | string Предоставленный пользователем тег для отслеживания этих вычислений. |
Тело ответа
Ответное сообщение для EarthEngineService.ComputeImages.
В случае успеха тело ответа содержит данные следующей структуры:
| JSON-представление |
|---|
{
"images": [
{
object (EarthEngineAsset)
}
],
"nextPageToken": string
} |
| Поля |
|---|
images[] | object ( EarthEngineAsset ) Список изображений, соответствующих запросу. |
nextPageToken | string Токен для получения следующей страницы результатов. Передайте это значение в поле ComputeImagesRequest.page_token при последующем вызове метода imageCollection.computeImages , чтобы получить следующую страницу результатов. |
Области авторизации
Требуется одна из следующих областей 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\u003eComputes features by applying computations to features in tables and returns results as a list of images.\u003c/p\u003e\n"],["\u003cp\u003eAccepts an expression, page size, page token, and workload tag to define the computation.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of images and a token for retrieving subsequent pages of results.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eUses a POST request to the \u003ccode\u003eearthengine.googleapis.com\u003c/code\u003e endpoint for execution.\u003c/p\u003e\n"]]],[],null,["# Method: projects.imageCollection.computeImages\n\nComputes a set of features by applying an arbitrary computation to features in one or more tables. Results are returned as a list of images.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/imageCollection:computeImages`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `project` | `string` The project id or project number of the Google Cloud Platform project that should be treated as the service consumer for this request. Format is `projects/{project-id}`. Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `project`: - `earthengine.computations.create` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"expression\": { object (/earth-engine/reference/rest/v1alpha/Expression) }, \"pageSize\": integer, \"pageToken\": string, \"workloadTag\": string } ``` |\n\n| Fields ||\n|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1alpha/Expression)`)` The expression to compute. |\n| `pageSize` | `integer` The maximum number of results per page. The server may return fewer images than requested. If unspecified, the page size default is 1000 results per page. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically, this is the value of [ComputeImagesResponse.next_page_token](/earth-engine/reference/rest/v1alpha/projects.imageCollection/computeImages#body.ComputeImagesResponse.FIELDS.next_page_token) returned from the previous call to the `imageCollection.computeImages` method. |\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Response body\n\nResponse message for EarthEngineService.ComputeImages.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"images\": [ { object (/earth-engine/reference/rest/v1alpha/projects.assets#EarthEngineAsset) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `images[]` | `object (`[EarthEngineAsset](/earth-engine/reference/rest/v1alpha/projects.assets#EarthEngineAsset)`)` The list of images matching the query. |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [ComputeImagesRequest.page_token](/earth-engine/reference/rest/v1alpha/projects.imageCollection/computeImages#body.request_body.FIELDS.page_token) field in the subsequent call to the `imageCollection.computeImages` method to retrieve the next page of results. |\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)."]]
