Method: dataLayers.get

Pobiera informacje o energii słonecznej dla regionu otaczającego 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 szerokość geograficzna środka 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 natężenia ani godzinnego zacienienia.
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 zostanie określone), 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 zwracane są tylko obrazy o jakości MEDIUM, jeśli requiredQuality ma wartość MEDIUM.
experiments[]

enum (Experiment)

Opcjonalnie. Określa eksperymenty przed GA, które mają być włączone.

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 Uzyskaj DSM, RGB, maskę i roczny flux.
IMAGERY_AND_ALL_FLUX_LAYERS Uzyskaj dane DSM, RGB, maski, roczny i miesięczny.
FULL_LAYERS Pobierz wszystkie dane.