Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain Earth Engine access.
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:
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:
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-06 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eimageCollection.computeImages\u003c/code\u003e method computes features from one or more tables using an arbitrary computation and returns results as a list of images.\u003c/p\u003e\n"],["\u003cp\u003eUsers can specify the \u003ccode\u003eexpression\u003c/code\u003e to define the computation, \u003ccode\u003epageSize\u003c/code\u003e to limit results per page, \u003ccode\u003epageToken\u003c/code\u003e for pagination, and \u003ccode\u003eworkloadTag\u003c/code\u003e for tracking.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses include a list of \u003ccode\u003eimages\u003c/code\u003e (EarthEngineAssets) and a \u003ccode\u003enextPageToken\u003c/code\u003e for retrieving additional results.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication requires specific OAuth scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/earthengine\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e.\u003c/p\u003e\n"]]],["The `computeImages` method processes features from tables using a user-defined expression. A POST request is sent to a specific URL, including the project ID. The request body contains the computation `expression`, `pageSize` to control result count, `pageToken` for pagination, and a `workloadTag` for tracking. The response returns a list of `images` and a `nextPageToken` for subsequent result pages. Authorization requires specific OAuth scopes. An IAM permission (`earthengine.computations.create`) is required on the specified project.\n"],null,["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.\n\nHTTP request\n\n`POST https://earthengine.googleapis.com/v1/{project=projects/*}/imageCollection:computeImages`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath 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\nRequest body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"expression\": { object (/earth-engine/reference/rest/v1/Expression) }, \"pageSize\": integer, \"pageToken\": string, \"workloadTag\": string } ``` |\n\n| Fields ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1/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/v1/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\nResponse body Response 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/v1/projects.assets#EarthEngineAsset) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `images[]` | `object (`[EarthEngineAsset](/earth-engine/reference/rest/v1/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/v1/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\nAuthorization 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)."]]