Method: projects.map.export

Startet einen Batchprozess, der eine gekachelte Karte berechnet und das Ergebnis in Google Cloud Storage schreibt.

HTTP-Anfrage

POST https://earthengine.googleapis.com/v1alpha/{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, mit der doppelte Anfragen erkannt werden. 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 zur Nachverfolgung 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.

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,
  "minZoom": integer,
  "skipEmpty": boolean,
  "skipEmptyTiles": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "tileDimensions": {
    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,
  "maxZoom": 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.
minZoom
(deprecated)

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.
skipEmptyTiles
(deprecated)

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).
tileDimensions
(deprecated)

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 Kachelzeilen 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.
maxZoom
(deprecated)

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 Start- und Endteilmengen sind Werte mit doppelter Genauigkeit, sodass Sie eine oder mehrere Zoomstufen schrittweise rendern können. Wenn Sie eine ganze Pyramide mit einer Startzoomstufe von 12 rendern möchten, legen Sie Folgendes fest: startZoom=0, endZoom=12. Legen Sie diese Nachricht nicht fest. So rendern Sie die Ebenen 0–11 und die ersten 10% von Ebene 12: startZoom=0, endZoom=12, subset = {min=0, max=12.1}. So rendern Sie die nächsten 10% von Ebene 12: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2}. So rendern Sie die restlichen 80% von Ebene 12: startZoom=0, endZoom=12, subset = {min=12.2, max=13}. Alle Exportschards müssen dieselbe (vollständige) Pyramidengröße in startZoom/endZoom haben.

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

number

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

number

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

number

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

number

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