Method: projects.value.compute

  • Computes the value of an arbitrary Earth Engine expression, potentially failing if the result is not expressible as a Value or requires excessive resources.

  • It's recommended to use specific Compute endpoints (e.g., ComputeFeatures) when dealing with expressions yielding results better suited for those endpoints, rather than this general-purpose endpoint.

  • Requires providing an expression object and an optional workload tag in the request body, and returns the computed value in the response.

  • To use, you need appropriate authorization with scopes like https://www.googleapis.com/auth/earthengine or https://www.googleapis.com/auth/cloud-platform.

Computes an arbitrary value. This will fail if the result of the Expression is not something that is expressible as a Value, or if its evaluation requires too many resources. While it is possible (and not an error) to compute any type of object here, in general any Expression producing results that are better suited to one of the other Compute* endpoints should use that endpoint instead (e.g., an Expression whose result is a set of features should use ComputeFeatures).

HTTP request

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/value:compute

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)
  },
  "workloadTag": string
}
Fields
expression

object (Expression)

The expression to compute.
workloadTag

string

User supplied tag to track this computation.

Response body

The results of an arbitrary computation.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "result": value
}
Fields
result

value (Value format)

The results of computing the value of the expression.

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.