Method: projects.map.export

Startet einen Batchprozess, bei dem eine gekachelte Karte berechnet und das Ergebnis in Google Cloud Storage geschrieben wird.

HTTP-Anfrage

POST https://earthengine.googleapis.com/v1/{project=projects/*}/map: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,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
Felder
expression

object (Expression)

Ein Ausdruck, der zu dem Bild ausgewertet wird, das berechnet und exportiert werden soll. Anhand der Grenzen des Bildes wird die Menge der zu rendernden Kartenkacheln bestimmt. Wenn Sie die exportierte Region steuern möchten, schneiden Sie das Bild vor dem Export zu.

description

string

Ein für Menschen lesbarer Name der Aufgabe.

tileOptions

object (TileOptions)

Optionen, die die zu generierenden Kartenkacheln beschreiben.

tileExportOptions

object (ImageFileExportOptions)

Optionen für den Speicherort und das Format, in dem die Kartenkacheln exportiert werden sollen. Cloud Storage ist derzeit das einzige unterstützte Ziel für Kartenexporte.

requestId

string

Eine eindeutige String-ID zum Erkennen doppelter Anfragen. 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 Nachverfolgen 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 nicht festgelegt, ist der Standardwert 100.

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.

TileOptions

Optionen, die Bild- oder Videokartenkacheln beschreiben, die exportiert werden sollen.

JSON-Darstellung
{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "endZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
Felder
startZoom

integer

Die Zoomstufe, bei der die Generierung von Kartenkacheln für den Export beginnen soll. Der Standardwert ist null.

skipEmpty

boolean

Wenn „true“, werden leere (d.h. vollständig transparente) Kartenkacheln nicht geschrieben.

mapsApiKey

string

Optionaler Google Maps Platform API-Schlüssel für die generierte Kartenkachelansicht.

dimensions

object (GridDimensions)

Die Breite und Höhe der Ausgabevideokacheln, die nur für den Export von gekachelten Videopyramiden verwendet werden (ExportVideoMap).

stride

integer

Schrittweite für Kacheln in Zeilen und Spalten. (ExportVideoMap) Legen Sie für spärliche Kacheln (nur WebGL) den Wert 4 oder für maximale Kompatibilität den Wert 1 (Standard) fest.

zoomSubset

object (ZoomSubset)

Eine Teilmenge von Zoomstufen, für die Kacheln generiert werden sollen. Kann nur in einem Aufruf von ExportVideoMap angegeben werden.

Die Zoomstufe oder der Maßstab, bei dem die Generierung von Kartenkacheln beendet werden soll. Einer der beiden Werte muss angegeben werden. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
endZoom

integer

Die Zoomstufe, bei der die Generierung von Kartenkacheln beendet werden soll.

scale

number

Die maximale Bildauflösung in Metern pro Pixel. Der Maßstab wird in die am besten geeignete maximale Zoomstufe am Äquator umgewandelt.

Ende der sich gegenseitig ausschließenden Felder.

ZoomSubset

Eine Teilmenge von Zoomstufen, für die Kacheln generiert werden sollen (ExportVideoMap). Die Teilmengen für Start und Ende sind Werte mit doppelter Genauigkeit, mit denen Sie eine oder mehrere Zoomstufen schrittweise rendern können. Wenn Sie eine ganze Pyramide mit einer Startzoomstufe von 12 rendern möchten, legen Sie startZoom=0 und endZoom=12 fest und lassen Sie diese Nachricht weg. So rendern Sie die Stufen 0–11 und die ersten 10% von Stufe 12: startZoom=0, endZoom=12, subset = {min=0, max=12.1}. So rendern Sie die nächsten 10% von Stufe 12: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2}. So rendern Sie die restlichen 80% von Stufe 12: startZoom=0, endZoom=12, subset = {min=12.2, max=13}. Alle Exportschards müssen dieselbe (vollständige) Pyramidenhöhe in startZoom/endZoom haben.

JSON-Darstellung
{
  "start": number,
  "end": number
}
Felder
start

number

Teilmenge der Startzoomstufe, für die Kacheln generiert werden sollen (ExportVideoMap). Hier ist die Teilmenge ein Wert mit doppelter Genauigkeit, mit dem Sie eine Zoomstufe schrittweise rendern können. 12.1 steht beispielsweise für die ersten 10% der Kacheln in Zoomstufe 12 in einer nicht angegebenen, aber deterministischen Reihenfolge.

end

number

Teilmenge der Endzoomstufe, für die Kacheln generiert werden sollen (ExportVideoMap). Damit können Sie eine Zoomstufe schrittweise rendern, bis zur maximalen Teilmenge (falls angegeben) in einer nicht angegebenen, aber deterministischen Reihenfolge.