Method: projects.image.computePixels

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/v1/{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:

JSON-Darstellung 
{
  "expression": {
    object (Expression)
  },
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
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.