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
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.
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.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-02-27 (UTC)."],[[["Retrieves solar information for a specified region using latitude, longitude, and radius."],["Allows customization of data retrieval with parameters like `view`, `requiredQuality`, `pixelSizeMeters`, and `exactQualityRequired`."],["Returns an error if the location is outside the coverage area or if radius exceeds limitations."],["Requires authorization with the `https://www.googleapis.com/auth/cloud-platform` scope."],["Response includes a `DataLayers` object containing the requested solar data subset if successful."]]],["This content details how to retrieve solar information for a specific region via a `GET` request to `https://solar.googleapis.com/v1/dataLayers:get`. The request requires parameters like `location` (latitude/longitude), `radiusMeters`, and optional parameters including `view`, `requiredQuality`, `pixelSizeMeters` and `exactQualityRequired`. The body is empty and a successful response will provide solar data via `DataLayers`. Specific authorization scope `https://www.googleapis.com/auth/cloud-platform` is required. `DataLayerView` allows one to define the solar information subset to be retrieved.\n"]]
