Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
Method: projects.imageCollection.computeImages
Stay organized with collections
Save and categorize content based on your preferences.
Computes a set of features by applying an arbitrary computation to features in one or more tables. Results are returned as a list of images.
HTTP request
POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/imageCollection:computeImages
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
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 permission on the specified resource project:
earthengine.computations.create
|
Request body
The request body contains data with the following structure:
| JSON representation |
{
"expression": {
object (Expression)
},
"pageSize": integer,
"pageToken": string,
"workloadTag": string
} |
| Fields |
expression |
object (Expression)
The expression to compute.
|
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.
|
pageToken |
string
A token identifying a page of results the server should return. Typically, this is the value of ComputeImagesResponse.next_page_token returned from the previous call to the imageCollection.computeImages method.
|
workloadTag |
string
User supplied tag to track this computation.
|
Response body
Response message for EarthEngineService.ComputeImages.
If successful, the response body contains data with the following structure:
| JSON representation |
{
"images": [
{
object (EarthEngineAsset)
}
],
"nextPageToken": string
} |
| Fields |
images[] |
object (EarthEngineAsset)
The list of images matching the query.
|
nextPageToken |
string
A token to retrieve the next page of results. Pass this value in the ComputeImagesRequest.page_token field in the subsequent call to the imageCollection.computeImages method to retrieve the next page of results.
|
Authorization scopes
Requires one of the following OAuth scopes:
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
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-06 UTC.
[null,null,["Last updated 2025-03-06 UTC."],[[["\u003cp\u003eThe \u003ccode\u003ecomputeImages\u003c/code\u003e method calculates features from one or more tables using a provided expression and returns the results as a list of images.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires an expression, and optionally accepts parameters for page size, page token, and a workload tag for tracking.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of computed images and a token for retrieving additional pages of results if available.\u003c/p\u003e\n"],["\u003cp\u003eUsers need appropriate authorization with scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/earthengine\u003c/code\u003e to access this functionality.\u003c/p\u003e\n"],["\u003cp\u003eThis functionality can be accessed via an HTTP POST request to the specified Earth Engine API endpoint with necessary project details.\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/v1beta/{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/v1beta/Expression) }, \"pageSize\": integer, \"pageToken\": string, \"workloadTag\": string } ``` |\n\n| Fields ||\n|---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1beta/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/v1beta/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/v1beta/projects.assets#EarthEngineAsset) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `images[]` | `object (`[EarthEngineAsset](/earth-engine/reference/rest/v1beta/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/v1beta/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)."]]