Method: dataLayers.get

Pobieranie informacji o energii słonecznej w regionie otaczającym lokalizację. Jeśli lokalizacja znajduje się poza obszarem objętym usługą, zwraca błąd o kodzie NOT_FOUND.

Żą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 chcesz uzyskać dane.
radiusMeters

number

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

  • Zawsze możesz podać dowolną wartość do 100 mln.
  • Można podać wartości powyżej 100 mln, o ile radiusMeters <= pixelSizeMeters * 1000.
  • W przypadku wartości powyżej 175 mln w żądaniu DataLayerView nie może zawierać miesięcznego strumienia ani godzinowego zacienienia.
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. Nieokreślenie tego parametru jest równoznaczne z ograniczeniem do jakości WYSOKIEJ.
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 jest ustawione), 0,25, 0,5 i 1,0. Komponenty obrazów, których normalna rozdzielczość jest mniejsza niż pixelSizeMeters, będą zwracane w rozdzielczości określonej przez pixelSizeMeters. Komponenty obrazów, 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 wartość tego pola to „false”, pole requiredQuality jest interpretowane jako minimalna wymagana jakość, co oznacza, że obrazy o wysokiej jakości mogą być zwracane, gdy wartość pola requiredQuality to „MEDIUM”. Jeśli ma wartość „true”, parametr requiredQuality jest interpretowany jako dokładna wymagana jakość i zwracane są tylko obrazy o jakości MEDIUM, jeśli parametr requiredQuality ma wartość MEDIUM.
experiments[]

enum (Experiment)

Opcjonalnie. Określa eksperymenty przed GA, które mają zostać włączone. Żądania korzystające z tego pola są klasyfikowane jako oferta przed GA zgodnie ze szczegółowymi warunkami korzystania z usługi Google Maps Platform. Więcej informacji znajdziesz w [opisach etapów uruchamiania]( https://cloud.google.com/maps-platform/terms/launch-stages).

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, które informacje o energii słonecznej mają zostać zwrócone.

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