Method: projects.map.export

Inicjowanie procesu zbiorczego, który oblicza mapę w postaci płytek i zapisuje wynik w Google Cloud Storage.

Żądanie HTTP

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/map:export

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
project

string

Identyfikator lub numer projektu Google Cloud Platform, który powinien być traktowany jako konsument usługi w przypadku tej prośby. Format to projects/{project-id}.

Autoryzacja wymaga tych uprawnień IAM w przypadku określonego zasobu: project

  • earthengine.exports.create

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
Pola
expression

object (Expression)

Wyrażenie, które zwraca obraz do obliczenia i wyeksportowania. Granice obrazu posłużą do określenia zestawu kafelków mapy do wyrenderowania. Aby kontrolować eksportowany obszar, przed wyeksportowaniem przytnij obraz.

description

string

Zrozumiała dla człowieka nazwa zadania.

tileOptions

object (TileOptions)

Opcje opisujące klocki mapy do wygenerowania.

tileExportOptions

object (ImageFileExportOptions)

Opcje eksportowania płytek mapy (gdzie i w jakiej formie). Cloud Storage jest obecnie jedynym obsługiwanym miejscem docelowym dla eksportu map.

requestId

string

Unikalny ciąg znaków służący do wykrywania zduplikowanych żądań. Jeśli ten sam użytkownik wyśle więcej niż 1 żądanie z tą samą niepustą wartością requestId, tylko jedno z tych żądań może rozpocząć długotrwałą operację. requestId może zawierać znaki a–z, A–Z, 0–9 lub „–”. requestId może mieć maksymalnie 60 znaków.

workloadTag

string

Etykieta dostarczona przez użytkownika do śledzenia tego obliczenia.

priority

integer

Opcjonalnie: Priorytet zadania eksportowania w projekcie. Zadania o wyższym priorytecie są planowane wcześniej. Wartość musi być liczbą całkowitą z zakresu od 0 do 9999. Jeśli nie zostanie ustawiony, domyślna wartość to 100.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Operation.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

TileOptions

Opcje opisujące klocki mapy obrazu lub filmu do wyeksportowania.

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

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}
Pola
startZoom

integer

Poziom powiększenia, na którym mają być generowane elementy mapy do eksportu. Wartość domyślna to 0.

skipEmpty

boolean

Jeśli jest ustawiona wartość true, pomiń zapisywanie pustych (tzn. w pełni przezroczystych) kafelków mapy.

mapsApiKey

string

Opcjonalny klucz interfejsu API Google Maps Platform do wyświetlania generowanych kafelków mapy.

dimensions

object (GridDimensions)

Szerokość i wysokość kafelków wyjściowego filmu, używane tylko do eksportowania ułożonych w kolumnę piramid wideo (ExportVideoMap).

stride

integer

Rozstęp wierszy i kolumn. (ExportVideoMap) Ustaw na 4, aby uzyskać rzadkie płytki (tylko dla WebGL), lub na 1 (domyślnie), aby zapewnić maksymalną zgodność.

zoomSubset

object (ZoomSubset)

Podzbiór poziomów powiększenia, dla których mają być generowane elementy. Może być określony tylko w wywołaniu ExportVideoMap.

Pole unii end_zoom_or_scale. Poziom powiększenia lub skala, przy których ma przestać generować kafelki mapy. Musisz podać jeden z tych kodów. end_zoom_or_scale może być tylko jednym z tych elementów:
endZoom

integer

Poziom powiększenia, dla którego ma przestać generować się kafelek mapy.

scale

number

Maksymalna rozdzielczość obrazu w metrach na piksel. Skala zostanie przekształcona na najbardziej odpowiedni maksymalny poziom powiększenia na równiku.

ZoomSubset

Podzbiór poziomów powiększenia, dla których mają być generowane kafelki (ExportVideoMap). Podzbiory Start i End to wartości z podwójną precyzją, które umożliwiają renderowanie pojedynczych poziomów powiększenia. Aby renderować całą piramidę z powiększeniem początkowym 12: startZoom=0, endZoom=12, nie ustawiaj tego komunikatu. Aby renderować poziomy 0–11 i pierwsze 10% poziomu 12: startZoom=0, endZoom=12, subset = {min=0, max=12.1 } Aby renderować kolejne 10% poziomu 12: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 } Aby renderować pozostałe 80% poziomu 12: startZoom=0, endZoom=12, subset = {min=12.2, max=13 } Pamiętaj, że wszystkie fragmenty eksportu muszą mieć ten sam (pełny) rozmiar piramidy w ustawieniach startZoom/endZoom.

Zapis JSON
{
  "start": number,
  "end": number
}
Pola
start

number

Początkowy podzbiór poziomu powiększenia, dla którego mają być generowane płytki (ExportVideoMap). Tutaj podzbiór to wartość z podwójną precyzją, która umożliwia renderowanie poziomu powiększenia w sposób przyrostowy. Wartość 12.1 oznacza na przykład pierwsze 10% płytek w powiększeniu 12 w nieokreślonej, ale deterministycznej kolejności.

end

number

Podzbiór końcowego poziomu powiększenia, dla którego mają być generowane płytki (ExportVideoMap), umożliwiający renderowanie poziomu powiększenia stopniowo, do maksymalnego podzbioru (jeśli został podany) w nieokreślonym, ale określonym porządku.