Method: projects.imageCollection.computeImages
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Hiermit werden eine Reihe von Features berechnet, indem eine beliebige Berechnung auf Features in einer oder mehreren Tabellen angewendet wird. Die Ergebnisse werden als Liste von Bildern zurückgegeben.
HTTP-Anfrage
POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/imageCollection:computeImages
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)
},
"pageSize": integer,
"pageToken": string,
"workloadTag": string
} |
| Felder |
expression |
object (Expression)
Der Ausdruck, der berechnet werden soll.
|
pageSize |
integer
Die maximale Anzahl von Ergebnissen pro Seite. Der Server gibt möglicherweise weniger Bilder zurück als angefordert. Wenn keine Seitengröße angegeben wird, ist die Standardseitengröße 1.000 Ergebnisse pro Seite.
|
pageToken |
string
Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. Normalerweise ist dies der Wert von ComputeImagesResponse.next_page_token, der vom vorherigen Aufruf der imageCollection.computeImages-Methode zurückgegeben wurde.
|
workloadTag |
string
Vom Nutzer bereitgestelltes Tag zum Erfassen dieser Berechnung.
|
Antworttext
Antwortnachricht für EarthEngineService.ComputeImages
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"images": [
{
object (EarthEngineAsset)
}
],
"nextPageToken": string
} |
| Felder |
images[] |
object (EarthEngineAsset)
Die Liste der Bilder, die mit der Suchanfrage übereinstimmen.
|
nextPageToken |
string
Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann. Übergeben Sie diesen Wert im Feld ComputeImagesRequest.page_token im nachfolgenden Aufruf der Methode imageCollection.computeImages, um die nächste Ergebnisseite abzurufen.
|
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 features by applying computations to features in tables and returns results as a list of images.\u003c/p\u003e\n"],["\u003cp\u003eAccepts an expression, page size, page token, and workload tag to define the computation.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of images and a token for retrieving subsequent pages of results.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eUses a POST request to the \u003ccode\u003eearthengine.googleapis.com\u003c/code\u003e endpoint for execution.\u003c/p\u003e\n"]]],[],null,["# Method: projects.imageCollection.computeImages\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 images.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/imageCollection:computeImages`\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 images 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 [ComputeImagesResponse.next_page_token](/earth-engine/reference/rest/v1alpha/projects.imageCollection/computeImages#body.ComputeImagesResponse.FIELDS.next_page_token) returned from the previous call to the `imageCollection.computeImages` method. |\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Response body\n\nResponse message for EarthEngineService.ComputeImages.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"images\": [ { object (/earth-engine/reference/rest/v1alpha/projects.assets#EarthEngineAsset) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `images[]` | `object (`[EarthEngineAsset](/earth-engine/reference/rest/v1alpha/projects.assets#EarthEngineAsset)`)` The list of images matching the query. |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [ComputeImagesRequest.page_token](/earth-engine/reference/rest/v1alpha/projects.imageCollection/computeImages#body.request_body.FIELDS.page_token) field in the subsequent call to the `imageCollection.computeImages` 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)."]]
