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 Versorgungsgebiets 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. Längen- und Breitengrad für den Mittelpunkt der Region, für die Daten abgerufen werden sollen.

radiusMeters

number

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

  • Es kann immer ein Wert bis zu 100 m angegeben werden.
  • Werte über 100 m sind zulässig, solange radiusMeters <= pixelSizeMeters * 1000.
  • Bei Werten über 175 m darf DataLayerView in der Anfrage jedoch keinen monatlichen Fluss oder stündlichen Schatten enthalten.
view

enum (DataLayerView)

Optional. Die gewünschte Teilmenge der Daten, die zurückgegeben werden soll.

requiredQuality

enum (ImageryQuality)

Optional. Die Mindestqualität der Ergebnisse. Es werden keine Ergebnisse mit einer niedrigeren Qualität zurückgegeben. Wenn Sie dies nicht angeben, wird die Suche auf Videos mit der höchsten Qualität beschränkt.

pixelSizeMeters

number

Optional. Die minimale Skalierung der zurückzugebenden Daten in Metern pro Pixel. Es werden die Werte 0,1 (Standardwert, wenn dieses Feld nicht explizit festgelegt ist), 0,25, 0,5 und 1,0 unterstützt. Bildkomponenten, deren normale Auflösung unter pixelSizeMeters liegt, werden mit der von pixelSizeMeters angegebenen Auflösung zurückgegeben. Bildkomponenten, deren normale Auflösung pixelSizeMeters entspricht oder übersteigt, werden mit dieser normalen Auflösung zurückgegeben.

exactQualityRequired

boolean

Optional. Ob eine genaue Qualität der Bilder erforderlich ist. Wenn „false“ festgelegt ist, wird das Feld „requiredQuality“ als Mindestqualität interpretiert. Wenn „requiredQuality“ auf „MEDIUM“ festgelegt ist, können Bilder in hoher Qualität zurückgegeben werden. Wenn „true“ festgelegt ist, wird requiredQuality als genau die erforderliche Qualität interpretiert. Wenn requiredQuality auf MEDIUM festgelegt ist, werden nur Bilder mit der Qualität MEDIUM zurückgegeben.

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 Sonneninformationen zurückgegeben werden soll.

Enums
DATA_LAYER_VIEW_UNSPECIFIED Entspricht FULL.
DSM_LAYER Nur DSM herunterladen
IMAGERY_LAYERS DSM, RGB und Maske abrufen
IMAGERY_AND_ANNUAL_FLUX_LAYERS DSM, RGB, Maske und Jahresdurchfluss abrufen
IMAGERY_AND_ALL_FLUX_LAYERS DSM, RGB, Maske, Jahres- und Monatsstrom
FULL_LAYERS Alle Daten abrufen