Method: projects.image.computePixels
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Er berechnet eine Pixelkachel, indem er eine beliebige Berechnung auf Bilddaten durchführt.
Anfragen sind auf 48 MB unkomprimierte Daten pro Anfrage beschränkt. Diese werden berechnet als Produkt aus den Abmessungen der Anfrage in Pixeln, der Anzahl der angeforderten Bildbänder und der Anzahl der Bytes pro Pixel für jedes Band. Anfragen sind außerdem auf maximal 32.000 Pixel in jeder Dimension und maximal 1.024 Bänder beschränkt. Anfragen, die diese Limits überschreiten, führen zu einem Fehlercode 400 (BAD_REQUEST).
Bei Erfolg enthält der Antworttext die angeforderten Pixeldaten in der Codierung, die im Feld fileFormat der Anfrage angegeben ist.
HTTP-Anfrage
POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/image:computePixels
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:
| Felder |
expression |
object (Expression)
Der Ausdruck, der berechnet werden soll.
|
fileFormat |
enum (ImageFileFormat)
Das Ausgabedateiformat, in dem die Pixelwerte zurückgegeben werden sollen.
|
grid |
object (PixelGrid)
Parameter, die beschreiben, wie das von expression berechnete Bild neu projiziert und zugeschnitten werden soll. Ist das nicht der Fall, wird das vollständige berechnete Bild in seiner nativen Projektion zurückgegeben.
|
bandIds[] |
string
Gibt gegebenenfalls eine bestimmte Gruppe von Bändern an, die aus dem Ergebnis der Auswertung von expression ausgewählt werden. Wenn nicht vorhanden, werden alle Bänder ausgewählt, die aus expression resultieren.
|
visualizationOptions |
object (VisualizationOptions)
Falls vorhanden, eine Reihe von Visualisierungsoptionen, die angewendet werden, um eine 8‑Bit-RGB-Visualisierung der Daten zu erstellen.
|
workloadTag |
string
Vom Nutzer bereitgestelltes Tag zum Erfassen dieser Berechnung.
|
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, ist die Antwort eine allgemeine HTTP-Antwort, deren Format von der Methode vorgegeben wird.
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\u003eThis API computes a tile of pixels by performing a user-defined computation on image data using an expression.\u003c/p\u003e\n"],["\u003cp\u003eRequests are limited to 48MB of uncompressed data and specific dimensions, exceeding which results in a 400 error.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses contain pixel data in the specified file format, encoded within the HTTP response body.\u003c/p\u003e\n"],["\u003cp\u003eThe API requires authorization using specific OAuth 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"],["\u003cp\u003eUsers can define the projection, clipping, band selection, and visualization options for the computed image within the request.\u003c/p\u003e\n"]]],["This API computes a tile of pixels from image data via an arbitrary expression. Input parameters include `expression`, `fileFormat`, `grid`, `bandIds`, `visualizationOptions`, and `workloadTag`. Requests are limited to 48MB of uncompressed data, 32K pixels per dimension, and 1024 bands, returning a 400 error code if these limits are exceeded. A successful request returns pixel data in the specified `fileFormat`, with authorization requiring specific OAuth scopes.\n"],null,["# Method: projects.image.computePixels\n\nComputes a tile of pixels by performing an arbitrary computation on image data.\n\nRequests are limited to 48MB in uncompressed data per request, computed as the product of the request dimensions in pixels, the number of image bands requested, and the number of bytes per pixel for each band. Requests are also limited to at most 32K pixels in either dimension and at most 1024 bands. Requests exceeding these limits will result in an error code of 400 (BAD_REQUEST).\n\nIf successful, the response body contains the requested pixel data in the encoding specified in the `fileFormat` field of the request.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/image:computePixels`\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) }, \"fileFormat\": enum (/earth-engine/reference/rest/v1beta/ImageFileFormat), \"grid\": { object (/earth-engine/reference/rest/v1beta/PixelGrid) }, \"bandIds\": [ string ], \"visualizationOptions\": { object (/earth-engine/reference/rest/v1beta/VisualizationOptions) }, \"workloadTag\": string } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1beta/Expression)`)` The expression to compute. |\n| `fileFormat` | `enum (`[ImageFileFormat](/earth-engine/reference/rest/v1beta/ImageFileFormat)`)` The output file format in which to return the pixel values. |\n| `grid` | `object (`[PixelGrid](/earth-engine/reference/rest/v1beta/PixelGrid)`)` Parameters describing how the image computed by `expression` should be reprojected and clipped. If not present, the full computed image is returned in its native projection. |\n| `bandIds[]` | `string` If present, specifies a specific set of bands that will be selected from the result of evaluating `expression`. If not present, all bands resulting from `expression` will be selected. |\n| `visualizationOptions` | `object (`[VisualizationOptions](/earth-engine/reference/rest/v1beta/VisualizationOptions)`)` If present, a set of visualization options to apply to produce an 8-bit RGB visualization of the data. |\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Response body\n\nIf successful, the response is a generic HTTP response whose format is defined by the method.\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)."]]
