Stay organized with collectionsSave 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 GeoJSON feature objects.
HTTP request
POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/table:computeFeatures
The project id or project number of the Google Cloud Platform project that should be treated as the service consumer for this request. Format isprojects/{project-id}.
Authorization requires the followingIAMpermission on the specified resourceproject:
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 features 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 ofComputeFeaturesResponse.next_page_tokenreturned from the previous call to thetable.computeFeaturesmethod.
workloadTag
string
User supplied tag to track this computation.
Response body
Response message for EarthEngineService.ComputeFeatures.
If successful, the response body contains data with the following structure:
The list of features matching the query, as a list of GeoJSON feature objects (see RFC 7946) containing the string "Feature" in a field named "type", the geometry in a field named "geometry", and key/value properties in a field named "properties".
nextPageToken
string
A token to retrieve the next page of results. Pass this value in theComputeFeaturesRequest.page_tokenfield in the subsequent call to thetable.computeFeaturesmethod 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\u003eComputes a set of features by applying a computation to features in one or more tables, returning results as a list of GeoJSON feature objects.\u003c/p\u003e\n"],["\u003cp\u003eThe computation is defined by an expression provided in the request body, along with optional parameters for pagination and workload tracking.\u003c/p\u003e\n"],["\u003cp\u003eResults are returned as a GeoJSON FeatureCollection, containing a list of features with their geometry and properties.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires appropriate authorization using OAuth scopes for Earth Engine or Google Cloud Platform.\u003c/p\u003e\n"]]],[],null,["# Method: projects.table.computeFeatures\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 GeoJSON feature objects.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/table:computeFeatures`\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 features 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 [ComputeFeaturesResponse.next_page_token](/earth-engine/reference/rest/v1alpha/projects.table/computeFeatures#body.ComputeFeaturesResponse.FIELDS.next_page_token) returned from the previous call to the `table.computeFeatures` method. |\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Response body\n\nResponse message for EarthEngineService.ComputeFeatures.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"type\": string, \"features\": [ { object (/earth-engine/reference/rest/v1alpha/Feature) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `type` | `string` Always contains the constant string \"FeatureCollection\", marking this as a GeoJSON FeatureCollection object. |\n| `features[]` | `object (`[Feature](/earth-engine/reference/rest/v1alpha/Feature)`)` The list of features matching the query, as a list of GeoJSON feature objects (see RFC 7946) containing the string \"Feature\" in a field named \"type\", the geometry in a field named \"geometry\", and key/value properties in a field named \"properties\". |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [ComputeFeaturesRequest.page_token](/earth-engine/reference/rest/v1alpha/projects.table/computeFeatures#body.request_body.FIELDS.page_token) field in the subsequent call to the `table.computeFeatures` 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)."]]
