Announcement: All noncommercial projects registered to use Earth Engine beforeApril 15, 2025 mustverify noncommercial eligibility to maintain access. If you have not verified by September 26, 2025, your access may be on hold.

Method: projects.table.computeFeatures

  • ThecomputeFeatures method computes features by applying a computation to features in one or more tables.

  • The results of the computation are returned as a list of GeoJSON feature objects.

  • The method is accessed via a POST request to the specified URL.

  • The request body includes the expression to compute, optional pagination parameters, and an optional workload tag.

  • The response body contains the resulting GeoJSON features, a type field, and an optional token for the next page of results.

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/v1/{project=projects/*}/table:computeFeatures

The URL usesgRPC 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 isprojects/{project-id}.

Authorization requires the followingIAM permission on the specified resourceproject:

  • 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 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_token returned from the previous call to thetable.computeFeatures method.

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:

JSON representation
{"type":string,"features":[{object (Feature)}],"nextPageToken":string}
Fields
type

string

Always contains the constant string "FeatureCollection", marking this as a GeoJSON FeatureCollection object.

features[]

object (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".

nextPageToken

string

A token to retrieve the next page of results. Pass this value in theComputeFeaturesRequest.page_token field in the subsequent call to thetable.computeFeatures 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 theOAuth 2.0 Overview.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-03-06 UTC.