Method: projects.map.export

Rozpoczyna proces wsadowy, który oblicza mapę kafelkową i zapisuje wynik w Google Cloud Storage.

Żądanie HTTP

POST https://earthengine.googleapis.com/v1alpha/{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 na potrzeby tego żądania. Format to projects/{project-id}.

Autoryzacja wymaga następującego IAM uprawnienia w określonym zasobie 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 daje w wyniku obraz do obliczenia i wyeksportowania. Granice obrazu zostaną użyte do określenia zbioru kafelków mapy do wyrenderowania. Aby kontrolować eksportowany region, przed eksportem przytnij obraz.
description

string

Nazwa zadania czytelna dla człowieka.
tileOptions

object (TileOptions)

Opcje opisujące kafelki mapy do wygenerowania.
tileExportOptions

object (ImageFileExportOptions)

Opcje określające, gdzie i w jakiej postaci wyeksportować kafelki mapy. Obecnie jedynym obsługiwanym miejscem docelowym eksportu map jest Cloud Storage.
requestId

string

Unikalny ciąg znaków używany do wykrywania zduplikowanych żądań. Jeśli ten sam użytkownik wyśle więcej niż 1 żądanie z tym samym niepustym parametrem requestId, tylko 1 z tych żądań może pomyślnie rozpocząć długo trwającą operację. Parametr requestId może zawierać znaki a–z, A–Z, 0–9 lub „-”. Długość parametru requestId nie może przekraczać 60 znaków.
workloadTag

string

Etykieta podana przez użytkownika do śledzenia tego obliczenia.
priority

integer

Opcjonalnie. Priorytet zadania eksportu w projekcie. Zadania o wyższym priorytecie są planowane wcześniej. Musi to być liczba całkowita z zakresu od 0 do 9999. Jeśli nie jest ustawiona, domyślnie przyjmuje wartość 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 sekcji OAuth 2.0 Overview.

TileOptions

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

Zapis JSON 
{
  "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.
}
Pola
startZoom

integer

Poziom powiększenia, od którego ma się rozpocząć generowanie kafelków mapy na potrzeby eksportu. Domyślnie 0.
minZoom
(deprecated)

integer

Poziom powiększenia, od którego ma się rozpocząć generowanie kafelków mapy na potrzeby eksportu. Domyślnie 0.
skipEmpty

boolean

Jeśli ma wartość „prawda”, pomiń zapisywanie pustych (czyli całkowicie przezroczystych) kafelków mapy.
skipEmptyTiles
(deprecated)

boolean

Jeśli ma wartość „prawda”, pomiń zapisywanie pustych (czyli całkowicie przezroczystych) kafelków mapy.
mapsApiKey

string

Opcjonalny klucz interfejsu API Google Maps Platform dla wygenerowanej przeglądarki kafelków mapy.
dimensions

object (GridDimensions)

Szerokość i wysokość wyjściowych kafelków wideo używane tylko do eksportowania piramid wideo (ExportVideoMap).
tileDimensions
(deprecated)

object (GridDimensions)

Szerokość i wysokość wyjściowych kafelków wideo używane tylko do eksportowania piramid wideo (ExportVideoMap).
stride

integer

Krok wiersza i kolumny kafelka. (ExportVideoMap) Ustaw wartość 4 w przypadku rzadkich kafelków (tylko WebGL) lub 1 (domyślnie) w celu zapewnienia maksymalnej zgodności.
zoomSubset

object (ZoomSubset)

Podzbiór poziomów powiększenia, dla których mają być generowane kafelki. Można go określić tylko w wywołaniu ExportVideoMap.
Poziom powiększenia lub skala, przy której ma się zakończyć generowanie kafelków mapy. Musisz określić jeden z tych parametrów. Oto lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej 1 z tych pól:
endZoom

integer

Poziom powiększenia, przy którym ma się zakończyć generowanie kafelków mapy.
maxZoom
(deprecated)

integer

Poziom powiększenia, przy którym ma się zakończyć generowanie kafelków mapy.
scale

number

Maksymalna rozdzielczość obrazu w metrach na piksel. Skala zostanie przekonwertowana na najbardziej odpowiedni maksymalny poziom powiększenia na równiku.
Koniec pól, które się wzajemnie wykluczają.

ZoomSubset

Podzbiór poziomów powiększenia, dla których mają być generowane kafelki (ExportVideoMap). Podzbiory początkowy i końcowy to wartości podwójnej precyzji, co umożliwia renderowanie poziomu powiększenia lub poziomów powiększenia przyrostowo. Aby wyrenderować całą piramidę z początkowym powiększeniem 12: ustaw startZoom=0, endZoom=12 i nie ustawiaj tej wiadomości. Aby wyrenderować poziomy 0–11 i pierwsze 10% poziomu 12: ustaw startZoom=0, endZoom=12, subset = {min=0, max=12.1}. Aby wyrenderować kolejne 10% poziomu 12: ustaw startZoom=0, endZoom=12, subset = {min=12.1, max=12.2}. Aby wyrenderować pozostałe 80% poziomu 12: ustaw startZoom=0, endZoom=12, subset = {min=12.2, max=13}. Pamiętaj też, że wszystkie fragmenty eksportu muszą mieć ten sam (pełny) rozmiar piramidy w startZoom/endZoom.

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

number

Początkowy podzbiór poziomu powiększenia, dla którego mają być generowane kafelki (ExportVideoMap). Podzbiór jest tu wartością podwójnej precyzji, co umożliwia renderowanie poziomu powiększenia przyrostowo. Na przykład 12.1 to pierwsze 10% kafelków w powiększeniu 12 w nieokreślonej, ale deterministycznej kolejności.
end

number

Końcowy podzbiór poziomu powiększenia, dla którego mają być generowane kafelki (ExportVideoMap), co umożliwia renderowanie poziomu powiększenia przyrostowo, aż do maksymalnego podzbioru (jeśli jest podany), ale bez niego, w nieokreślonej, ale deterministycznej kolejności.
min
(deprecated)

number

Początkowy podzbiór poziomu powiększenia, dla którego mają być generowane kafelki (ExportVideoMap). Podzbiór jest tu wartością podwójnej precyzji, co umożliwia renderowanie poziomu powiększenia przyrostowo. Na przykład 12.1 to pierwsze 10% kafelków w powiększeniu 12 w nieokreślonej, ale deterministycznej kolejności.
max
(deprecated)

number

Końcowy podzbiór poziomu powiększenia, dla którego mają być generowane kafelki (ExportVideoMap), co umożliwia renderowanie poziomu powiększenia przyrostowo, aż do maksymalnego podzbioru (jeśli jest podany), ale bez niego, w nieokreślonej, ale deterministycznej kolejności.