Method: dataLayers.get

Ruft Solarinformationen für eine Region um einen Standort ab. Gibt einen Fehler mit dem Code NOT_FOUND zurück, wenn sich der Standort außerhalb des Abdeckungsbereichs befindet.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
location

object (LatLng)

Erforderlich. Der Längen- und Breitengrad für das Zentrum der Region, für die Daten abgerufen werden sollen.
radiusMeters

number

Erforderlich. Der Radius in Metern, der die Region um diesen Mittelpunkt definiert, für die Daten zurückgegeben werden sollen. Für diesen Wert gelten die folgenden Einschränkungen:

  • Ein Wert von bis zu 100 m kann immer angegeben werden.
  • Werte über 100 m können angegeben werden, solange radiusMeters <= pixelSizeMeters * 1000.
  • Bei Werten über 175 m darf die DataLayerView in der Anfrage jedoch keinen monatlichen Fluss oder stündlichen Schatten enthalten.
view

enum (DataLayerView)

Optional. Die gewünschte Teilmenge der zurückzugebenden Daten.
requiredQuality

enum (ImageryQuality)

Optional. Die Mindestqualitätsstufe, die in den Ergebnissen zulässig ist. Es werden keine Ergebnisse mit einer niedrigeren Qualität zurückgegeben. Wenn Sie diesen Wert nicht angeben, werden nur Ergebnisse mit der Qualität „HIGH“ zurückgegeben.
pixelSizeMeters

number

Optional. Der Mindestmaßstab der zurückzugebenden Daten in Metern pro Pixel. Die Werte 0,1 (Standardwert, wenn dieses Feld nicht explizit festgelegt ist), 0,25, 0,5 und 1,0 werden unterstützt. Bildkomponenten, deren normale Auflösung geringer als pixelSizeMeters ist, werden mit der von pixelSizeMeters angegebenen Auflösung zurückgegeben. Bildkomponenten, deren normale Auflösung gleich oder größer als pixelSizeMeters ist, werden mit dieser normalen Auflösung zurückgegeben.
exactQualityRequired

boolean

Optional. Gibt an, ob die genaue Qualität des Bildmaterials erforderlich ist. Wenn dieser Wert auf „false“ gesetzt ist, wird das Feld requiredQuality als die mindestens erforderliche Qualität interpretiert. So kann beispielsweise Bildmaterial mit der Qualität „HIGH“ zurückgegeben werden, wenn requiredQuality auf „MEDIUM“ gesetzt ist. Wenn dieser Wert auf „true“ gesetzt ist, wird requiredQuality als die exakt erforderliche Qualität interpretiert. Wenn requiredQuality auf MEDIUM gesetzt ist, wird nur Bildmaterial mit der Qualität MEDIUM zurückgegeben.
experiments[]

enum (Experiment)

Optional. Gibt die pre-GA-Tests an, die aktiviert werden sollen. Anfragen, die dieses Feld verwenden, werden gemäß den dienstspezifischen Nutzungsbedingungen für die Google Maps Platform als Angebot vor der GA-Phase klassifiziert. Weitere Informationen finden Sie in den [Beschreibungen der Produkteinführungsphasen]( https://cloud.google.com/maps-platform/terms/launch-stages).

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von DataLayers.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

DataLayerView

Welche Teilmenge der Solarinformationen zurückgegeben werden soll.

Enums
DATA_LAYER_VIEW_UNSPECIFIED Entspricht „FULL“.
DSM_LAYER Nur das DSM abrufen.
IMAGERY_LAYERS DSM, RGB und Maske abrufen.
IMAGERY_AND_ANNUAL_FLUX_LAYERS DSM, RGB, Maske und jährlichen Fluss abrufen.
IMAGERY_AND_ALL_FLUX_LAYERS DSM, RGB, Maske, jährlichen Fluss und monatlichen Fluss abrufen.
FULL_LAYERS Alle Daten abrufen.