Method: projects.image.export

Initiiert einen Batch-Prozess, bei dem ein Bild berechnet und das Ergebnis an eines von mehreren Zielen geschrieben wird.

HTTP-Anfrage

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/image:export

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.exports.create

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "maxPixels": string,
  "grid": {
    object (PixelGrid)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of list of possible types for union field export_options.
}
Felder
expression

object (Expression)

Ein Ausdruck, der zum zu berechnenden und zu exportierenden Bild führt.

description

string

Ein für Menschen lesbarer Name der Aufgabe.

maxPixels

string (Int64Value format)

Die maximale Anzahl von Pixeln, die berechnet und exportiert werden sollen. So wird verhindert, dass Sie versehentlich einen größeren Export starten, als Sie beabsichtigt haben. Der Standardwert ist 1 × 10 8 Pixel. Sie können den Wert jedoch explizit festlegen, um dieses Limit zu erhöhen oder zu senken.

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.

requestId

string

Ein eindeutiger String, mit dem doppelte Anfragen erkannt werden. Wenn derselbe Nutzer mehrere Anfragen mit derselben nicht leeren requestId stellt, kann nur eine dieser Anfragen einen langwierigen Vorgang starten. requestId darf die Zeichen a–z, A–Z, 0–9 oder „-“ enthalten. requestId darf maximal 60 Zeichen lang sein.

workloadTag

string

Vom Nutzer bereitgestelltes Label zum Erfassen dieser Berechnung.

priority

integer

Optional. Die Priorität der Exportaufgabe innerhalb des Projekts. Aufgaben mit höherer Priorität werden früher geplant. Muss eine Ganzzahl zwischen 0 und 9999 sein. Wenn kein Wert festgelegt ist, wird der Standardwert 100 verwendet.

Union-Feld export_options. Optionen, die angeben, wo und wie die Ergebnisse gespeichert werden sollen. Für export_options ist nur einer der folgenden Werte zulässig:
fileExportOptions

object (ImageFileExportOptions)

Wenn angegeben, wird der Export als Datei konfiguriert.

assetExportOptions

object (ImageAssetExportOptions)

Wenn angegeben, wird der Export als Earth Engine-Asset konfiguriert.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/devstorage.full_control

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

ImageAssetExportOptions

Optionen zum Speichern von Bildern als Earth Engine-Assets.

JSON-Darstellung
{
  "pyramidingPolicy": enum (PyramidingPolicy),
  "pyramidingPolicyOverrides": {
    string: enum (PyramidingPolicy),
    ...
  },

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
Felder
pyramidingPolicy

enum (PyramidingPolicy)

Die Pyramidierungsrichtlinie, die standardmäßig für alle Bänder gilt.

pyramidingPolicyOverrides

map (key: string, value: enum (PyramidingPolicy))

Bestimmte übergeordnete Richtlinien für Pyramiden pro Band

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Union-Feld destination. Speicherort, an den die Ergebnisse geschrieben werden sollen. Für destination ist nur einer der folgenden Werte zulässig:
earthEngineDestination

object (EarthEngineDestination)

Wenn angegeben, wird der Export in Earth Engine konfiguriert.