Method: dataLayers.get

Uzyskiwanie informacji o słońcu wokół lokalizacji. Zwraca błąd z kodem 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, dla którego są zbierane dane.

radiusMeters

number

Wymagane. Promień w metrach określający obszar otaczający ten punkt środkowy, dla którego mają być zwracane dane. Ograniczenia dotyczące tej wartości:

  • Zawsze możesz podać dowolną wartość do 100 m.
  • Można podawać wartości przekraczające 100 m, o ile radiusMeters <= pixelSizeMeters * 1000.
  • Jednak w przypadku wartości powyżej 175 m pole DataLayerView w żądaniu nie może zawierać strumienia danych z miesiąca ani cienia godzinowego.
view

enum (DataLayerView)

Opcjonalnie. Żądany podzbiór danych do zwrócenia.

requiredQuality

enum (ImageryQuality)

Opcjonalnie. Minimalny poziom jakości dozwolony w wynikach. Nie zostaną zwrócone żadne wyniki o niższej jakości. Brak określenia tego ustawienia jest odpowiednikiem ograniczenia tylko do WYSOKIEJ jakości.

pixelSizeMeters

number

Opcjonalnie. Minimalna skala danych do zwrócenia (w metrach na piksel). Obsługiwane są wartości 0,1 (domyślna, jeśli to pole nie zostało wyraźnie skonfigurowane) – obsługiwane są wartości 0,25, 0,5 i 1,0. Komponenty zdjęć, których normalna rozdzielczość jest mniejsza niż pixelSizeMeters, będą zwracane w rozdzielczości określonej przez pixelSizeMeters. Komponenty zdjęć, 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ść zdjęć. Jeśli zasada ma wartość Fałsz, pole requiredQuality jest interpretowane jako minimalna wymagana jakość, więc zdjęcia o wysokiej jakości mogą być zwracane, gdy zasada requiredQuality ma wartość ŚREDNIA. Jeśli zasada ma wartość Prawda, requiredQuality jest interpretowane jako dokładnie wymagana jakość i zwracane są tylko zdjęcia w jakości MEDIUM, jeśli requiredQuality ma wartość 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

Określa, jaki podzbiór informacji o słońcu ma zwrócić.

Wartości w polu enum
DATA_LAYER_VIEW_UNSPECIFIED Odpowiednik FULL.
DSM_LAYER Pobierz tylko DSM.
IMAGERY_LAYERS Kup DSM, RGB i maskę.
IMAGERY_AND_ANNUAL_FLUX_LAYERS Uzyskaj dostęp do DSM, RGB, maski i strumienia rocznego.
IMAGERY_AND_ALL_FLUX_LAYERS Uzyskaj dostęp do strumienia DSM, RGB, maski, strumienia rocznego i strumienia miesięcznego.
FULL_LAYERS Pobierz wszystkie dane.