Method: dataLayers.get

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

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 die Mitte der Region, für die Daten abgerufen werden sollen.

radiusMeters

number

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

  • Es kann immer ein beliebiger Wert bis 100m angegeben werden.
  • Es können Werte über 100 m angegeben werden, solange radiusMeters <= pixelSizeMeters * 1000 ist.
  • Bei Werten über 175 m darf der DataLayerView in der Anfrage jedoch keinen monatlichen Fluss oder stündlichen Farbton 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 wird kein Ergebnis mit niedrigerer Qualität zurückgegeben. Wenn Sie diese Option nicht angeben, wird nur die Qualität eingeschränkt.

pixelSizeMeters

number

Optional. Die minimale Skalierung der zurückzugebenden Daten in Metern pro Pixel. Unterstützt werden die Werte 0,1 (Standardeinstellung, wenn dieses Feld nicht explizit festgelegt wird), 0,25, 0,5 und 1,0. Bildkomponenten mit einer normalen Auflösung unter pixelSizeMeters werden mit der unter 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 eine exakte Bildqualität erforderlich ist. Ist die Richtlinie auf „false“ gesetzt, wird das Feld requiredQuality als erforderliche Mindestqualität interpretiert, sodass Bilder von hoher Qualität zurückgegeben werden können, wenn requiredQuality auf MITTEL gesetzt ist. Ist die Richtlinie auf „true“ gesetzt, wird requiredQuality als genau die erforderliche Qualität interpretiert und nur Bilder mit der Qualität MEDIUM werden zurückgegeben, wenn requiredQuality auf MEDIUM gesetzt ist.

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 Holen Sie sich nur das Produkt.
IMAGERY_LAYERS Rufen Sie die DSM, RGB und Maske ab.
IMAGERY_AND_ANNUAL_FLUX_LAYERS Holen Sie sich die DSM, RGB, Maske und den jährlichen Fluss.
IMAGERY_AND_ALL_FLUX_LAYERS Holen Sie sich das DDR-, RGB-, Masken-, Jahres- und Monatsformat.
FULL_LAYERS Alle Daten abrufen.