Method: projects.image.export

Startet einen Batchprozess, der ein Bild berechnet und das Ergebnis an eines von mehreren Zielen schreibt.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
project

string

Die Projekt-ID oder Projektnummer des Google Cloud Platform-Projekts, das für diese Anfrage als Dienstnutzer behandelt werden soll. Das Format ist projects/{project-id}.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource project:

  • 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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of mutually exclusive fields.
}
Felder
expression

object (Expression)

Ein Ausdruck, der das zu berechnende und zu exportierende Bild ergibt.
description

string

Ein für Menschen lesbarer Name der Aufgabe.
maxPixels

string (Int64Value format)

Die maximale Anzahl der zu berechnenden und zu exportierenden Pixel. Dies ist eine Sicherheitsmaßnahme, um zu verhindern, dass Sie versehentlich einen größeren Export starten als beabsichtigt. Der Standardwert ist 1e8 Pixel. Sie können den Wert aber explizit festlegen, um dieses Limit zu erhöhen oder zu senken.
grid

object (PixelGrid)

Parameter, die beschreiben, wie das mit expression berechnete Bild neu projiziert und zugeschnitten werden soll. Wenn nicht vorhanden, wird das vollständig berechnete Bild in seiner ursprünglichen Projektion zurückgegeben.
requestId

string

Eine eindeutige String, die zum Erkennen doppelter Anfragen verwendet wird. Wenn derselbe Nutzer mehrere Anfragen mit derselben nicht leeren requestId stellt, kann nur eine dieser Anfragen einen Vorgang mit langer Ausführungszeit starten. requestId kann die Zeichen a–z, A–Z, 0–9 oder „-“ enthalten. Die Länge von requestId darf maximal 60 Zeichen betragen.
workloadTag

string

Vom Nutzer angegebenes Label zum Verfolgen dieser Berechnung.
priority

integer

Optional. Die Priorität der Exportaufgabe im Projekt. 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.
Optionen, die beschreiben, wo und wie die Ergebnisse gespeichert werden sollen. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
fileExportOptions

object (ImageFileExportOptions)

Wenn angegeben, wird der Export als Datei konfiguriert.
assetExportOptions

object (ImageAssetExportOptions)

Wenn angegeben, wird der Export als Earth Engine-Asset konfiguriert.
Ende der sich gegenseitig ausschließenden Felder.

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),
    ...
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of mutually exclusive fields.
}
Felder
pyramidingPolicy

enum (PyramidingPolicy)

Die Pyramiding-Richtlinie, die standardmäßig auf alle Bänder angewendet werden soll.
pyramidingPolicyOverrides

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

Spezifische Überschreibungen der Pyramiding-Richtlinie pro Band.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Ziel für die Ergebnisse. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
earthEngineDestination

object (EarthEngineDestination)

Wenn angegeben, wird der Export nach Earth Engine konfiguriert.
Ende der sich gegenseitig ausschließenden Felder.