Method: projects.image.export

Rozpoczyna proces wsadowy, który oblicza obraz i zapisuje wynik w jednym z kilku miejsc docelowych.

Żądanie HTTP

POST https://earthengine.googleapis.com/v1/{project=projects/*}/image: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 tego żądania. 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,
  "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.
}
Pola
expression

object (Expression)

Wyrażenie, które daje w wyniku obraz do obliczenia i wyeksportowania.

description

string

Zrozumiała dla człowieka nazwa zadania.

maxPixels

string (Int64Value format)

Maksymalna liczba pikseli do obliczenia i wyeksportowania. Jest to zabezpieczenie, które zapobiega przypadkowemu rozpoczęciu eksportu większego niż zamierzony. Wartość domyślna to 1e8 pikseli, ale możesz ją ustawić, aby zwiększyć lub zmniejszyć ten limit.

grid

object (PixelGrid)

Parametry opisujące, jak obraz obliczony przez expression ma być ponownie rzutowany i przycinany. Jeśli nie jest obecny, zwracany jest pełny obliczony obraz w jego natywnej projekcji.

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 polem requestId, tylko jedno z tych żądań może pomyślnie rozpocząć długo trwającą operację. requestId może zawierać znaki a–z, A–Z, 0–9 lub „-”. Długość 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 zostanie ustawiony, domyślna wartość to 100.

Opcje opisujące, gdzie i jak przechowywać wyniki. Oto lista pól, które się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
fileExportOptions

object (ImageFileExportOptions)

Jeśli jest określony, konfiguruje eksport jako plik.

assetExportOptions

object (ImageAssetExportOptions)

Jeśli jest określony, konfiguruje eksport jako zasób Earth Engine.

Koniec pól, które się wykluczają.

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.

ImageAssetExportOptions

Opcje zapisywania obrazów jako zasobów Earth Engine.

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

enum (PyramidingPolicy)

Domyślna zasada piramidy, która ma być stosowana do wszystkich pasm.

pyramidingPolicyOverrides

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

Konkretne zastąpienia zasad piramidy dla poszczególnych pasm.

Obiekt zawierający listę "key": value par. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Miejsce, w którym mają być zapisywane wyniki. Oto lista pól, które się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
earthEngineDestination

object (EarthEngineDestination)

Jeśli jest określony, konfiguruje eksport do Earth Engine.

Koniec pól, które się wykluczają.