Method: projects.value.compute
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Calcule une valeur arbitraire. Cette opération échoue si le résultat de l'expression ne peut pas être exprimé en tant que valeur ou si son évaluation nécessite trop de ressources. Il est possible (et pas une erreur) de calculer n'importe quel type d'objet ici. En général, toute expression produisant des résultats plus adaptés à l'un des autres points de terminaison Compute* doit utiliser ce point de terminaison à la place (par exemple, une expression dont le résultat est un ensemble d'éléments géographiques doit utiliser ComputeFeatures).
Requête HTTP
POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/value:compute
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
project |
string
ID ou numéro du projet Google Cloud Platform à traiter comme client du service pour cette requête. Format : projects/{project-id}
L'autorisation IAM suivante est requise pour la ressource project indiquée :
earthengine.computations.create
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
| Représentation JSON |
{
"expression": {
object (Expression)
},
"workloadTag": string
} |
| Champs |
expression |
object (Expression)
Expression à calculer.
|
workloadTag |
string
Balise fournie par l'utilisateur pour suivre ce calcul.
|
Corps de la réponse
Résultats d'un calcul arbitraire.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
{
"result": value
} |
| Champs |
result |
value (Value format)
Résultats du calcul de la valeur de l'expression.
|
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
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
Pour en savoir plus, consultez OAuth 2.0 Overview.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003eComputes the value of an arbitrary Earth Engine expression, potentially failing if the result is not expressible as a Value or requires excessive resources.\u003c/p\u003e\n"],["\u003cp\u003eIt'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.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing an expression object and an optional workload tag in the request body, and returns the computed value in the response.\u003c/p\u003e\n"],["\u003cp\u003eTo use, you need appropriate authorization with 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"]]],[],null,["# Method: projects.value.compute\n\nComputes 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).\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/value:compute`\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) }, \"workloadTag\": string } ``` |\n\n| Fields ||\n|---------------|------------------------------------------------------------------------------------------------------|\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1beta/Expression)`)` The expression to compute. |\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Response body\n\nThe results of an arbitrary computation.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------|\n| ``` { \"result\": value } ``` |\n\n| Fields ||\n|----------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `result` | `value (`[Value](https://protobuf.dev/reference/protobuf/google.protobuf/#value)` format)` The results of computing the value of the expression. |\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)."]]
