Method: projects.assets.getPixels

Pobiera piksele z komponentu z obrazem. Ta niestandardowa metoda umożliwia wywołującemu żądanie dowolnej płytki pikseli z obrazu, opcjonalnie ze wskazaniem pasm i projekcji mapy. Zamaskowane lub brakujące dane zostaną zakodowane jako zera.

Żądania są ograniczone do 48 MB nieskompresowanych danych na żądanie. Jest to iloczyn wymiarów żądania w pikselach, liczba żądanych pasm obrazów i liczba bajtów na piksel dla każdego pasma. Żądania są też ograniczone do maksymalnie 32 tys. pikseli w każdym wymiarze i maksymalnie 1024 pasm. Żądania przekraczające te limity będą skutkować kodem błędu 400 (BAD_REQUEST).

W przypadku powodzenia treść odpowiedzi zawiera żądane dane pikselu w kodowaniu określonym w polu fileFormat żądania.

Żądanie HTTP

POST https://earthengine.googleapis.com/v1alpha/{name=projects/*/assets/**}:getPixels

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagany. Nazwa komponentu z obrazem, z którego mają być pobierane piksele. name ma format „projekty/*/zasobniki/*” (np. "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Wszystkie zasoby należące do użytkowników znajdują się w projekcie „earthengine-legacy” (np. "projects/earthengine-legacy/assets/users/foo/bar"). Wszystkie pozostałe zasoby znajdują się w projekcie „earthengine-public” (np. "projects/earthengine-public/assets/LANDSAT").

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

  • earthengine.assets.get

Treść żądania

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

Zapis JSON 
{
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "region": {
    object
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
Pola
fileFormat

enum (ImageFileFormat)

Format pliku wyjściowego, w którym mają być zwracane wartości pikseli.
grid

object (PixelGrid)

Parametry opisujące siatkę pikseli, z której mają być pobierane dane. Domyślnie jest to natywny układ pikseli danych.
region

object (Struct format)

W razie wystąpienia region danych do zwrócenia określony jako obiekt geometrii GeoJSON (patrz RFC 7946). Zwracany obraz jest zawsze prostokątny, dlatego w systemie współrzędnych wyjściowych zostanie użyty ograniczający prostokąt danej geometrii. Jeśli podana jest też wartość grid.dimensions, siatka zostanie ponownie przeskalowana do żądanego rozmiaru.
bandIds[]

string

Jeśli jest obecny, określa konkretny zestaw pasm, z których mają być pobierane piksele. Pasma są identyfikowane za pomocą identyfikatora, który jest wskazany w polu id proto ImageBand.
visualizationOptions

object (VisualizationOptions)

Jeśli jest obecny, zestaw opcji wizualizacji, które mają być zastosowane, aby zamiast zwracania danych nieprzetworzonych wygenerować 8-bitową wizualizację danych w formacie RGB.
workloadTag

string

Tag dostarczony przez użytkownika do śledzenia tego obliczenia.

Treść odpowiedzi

W przypadku powodzenia odpowiedź jest ogólną odpowiedzią HTTP, której format jest zdefiniowany przez metodę.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/earthengine.readonly
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only

Więcej informacji znajdziesz w OAuth 2.0 Overview.