Method: dataLayers.get

Pobiera informacje o słonecznej energii w regionie otaczającym lokalizację. Zwraca błąd o kodze NOT_FOUND, jeśli lokalizacja znajduje się poza obszarem zasięgu.

Żądanie HTTP

GET https://solar.googleapis.com/v1/dataLayers:get

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
location

object (LatLng)

Wymagane. Długość i szerokokość geograficzna centrum regionu, z którego mają pochodzić dane.

radiusMeters

number

Wymagane. Promień (w metrach) określający obszar wokół punktu centralnego, z którego mają zostać zwrócone dane. Ograniczenia dotyczące tej wartości:

  • Zawsze można podać dowolną wartość do 100 m.
  • Można podać wartości większe niż 100 m, o ile radiusMeters <= pixelSizeMeters * 1000.
  • Jednak w przypadku wartości powyżej 175 m DataLayerView w żądaniu nie może zawierać miesięcznego ani godzinowego zakresu.
view

enum (DataLayerView)

Opcjonalnie: Wybrany podzbiór danych do zwrócenia.

requiredQuality

enum (ImageryQuality)

Opcjonalnie: Minimalny dozwolony poziom jakości w wynikach. Nie zostaną zwrócone żadne wyniki o niższej jakości. Nie podanie tej opcji jest równoznaczne z ograniczeniem do jakości WYSOKA.

pixelSizeMeters

number

Opcjonalnie: Minimalna skala (w metrach na piksel) danych, które mają zostać zwrócone. Obsługiwane są wartości 0,1 (wartość domyślna, jeśli to pole nie jest ustawione), 0,25, 0,5 i 1,0. Komponenty z obrazem, których normalna rozdzielczość jest mniejsza niż pixelSizeMeters, będą zwracane w rozdzielczości określonej przez pixelSizeMeters. Komponenty z obrazem, których normalna rozdzielczość jest równa lub większa niż pixelSizeMeters, będą zwracane w tej normalnej rozdzielczości.

exactQualityRequired

boolean

Opcjonalnie: Określa, czy wymagana jest dokładna jakość obrazów. Jeśli ustawisz wartość false, pole requiredQuality zostanie zinterpretowane jako minimalna wymagana jakość, co oznacza, że obrazy o jakości HIGH mogą zostać zwrócone, gdy requiredQuality jest ustawione na MEDIUM. Jeśli ma wartość Prawda, requiredQuality jest interpretowany jako dokładna wymagana jakość, a jeśli requiredQuality ma wartość MEDIUM, zwracane są tylko obrazy o jakości MEDIUM.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

DataLayerView

Podzbiór informacji o słonecznej, który ma zostać zwrócony.

Wartości w polu enum
DATA_LAYER_VIEW_UNSPECIFIED Odpowiednik opcji FULL.
DSM_LAYER Pobierz tylko DSM.
IMAGERY_LAYERS Pobierz DSM, RGB i maskę.
IMAGERY_AND_ANNUAL_FLUX_LAYERS DSM, RGB, maska i roczny flux.
IMAGERY_AND_ALL_FLUX_LAYERS Uzyskaj dane DSM, RGB, maski, roczny i miesięczny.
FULL_LAYERS Pobierz wszystkie dane.