Method: projects.value.compute
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Berechnet einen beliebigen Wert. Dies schlägt fehl, wenn das Ergebnis des Ausdrucks nicht als Wert ausgedrückt werden kann oder wenn für die Auswertung zu viele Ressourcen erforderlich sind. Es ist zwar möglich (und kein Fehler), hier jeden Objekttyp zu berechnen, aber im Allgemeinen sollte für jeden Ausdruck, der Ergebnisse liefert, die besser zu einem der anderen Compute*-Endpunkte passen, stattdessen dieser Endpunkt verwendet werden. Beispiel: Für einen Ausdruck, dessen Ergebnis eine Reihe von Funktionen ist, sollte ComputeFeatures verwendet werden.
HTTP-Anfrage
POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/value:compute
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
project |
string
Die Projekt-ID oder Projektnummer des Google Cloud-Projekts, das für diese Anfrage als Dienstnutzer behandelt werden soll. Format ist projects/{project-id}.
Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource project erforderlich:
earthengine.computations.create
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| JSON-Darstellung |
{
"expression": {
object (Expression)
},
"workloadTag": string
} |
| Felder |
expression |
object (Expression)
Der Ausdruck, der berechnet werden soll.
|
workloadTag |
string
Vom Nutzer bereitgestelltes Tag zum Erfassen dieser Berechnung.
|
Antworttext
Die Ergebnisse einer beliebigen Berechnung.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"result": value
} |
| Felder |
result |
value (Value format)
Das Ergebnis der Berechnung des Ausdruckswerts.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
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
Weitere Informationen finden Sie unter OAuth 2.0 Overview.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
