Method: dataLayers.get
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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.
|
experiments[] |
enum (Experiment)
Optional. Gibt an, welche Pre-GA-Tests aktiviert werden sollen.
|
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 |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-29 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-29 (UTC)."],[[["\u003cp\u003eRetrieves solar information for a specified region using latitude, longitude, and radius.\u003c/p\u003e\n"],["\u003cp\u003eAllows customization of data retrieval with parameters like \u003ccode\u003eview\u003c/code\u003e, \u003ccode\u003erequiredQuality\u003c/code\u003e, \u003ccode\u003epixelSizeMeters\u003c/code\u003e, and \u003ccode\u003eexactQualityRequired\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eReturns an error if the location is outside the coverage area or if radius exceeds limitations.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes a \u003ccode\u003eDataLayers\u003c/code\u003e object containing the requested solar data subset if successful.\u003c/p\u003e\n"]]],["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"],null,["# Method: dataLayers.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [DataLayerView](#DataLayerView)\n- [Try it!](#try-it)\n\nGets solar information for a region surrounding a location. Returns an error with code `NOT_FOUND` if the location is outside the coverage area.\n\n### HTTP request\n\n`GET https://solar.googleapis.com/v1/dataLayers:get`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `location` | `object (`[LatLng](/maps/documentation/solar/reference/rest/v1/LatLng)`)` Required. The longitude and latitude for the center of the region to get data for. |\n| `radiusMeters` | `number` Required. The radius, in meters, defining the region surrounding that centre point for which data should be returned. The limitations on this value are: - Any value up to 100m can always be specified. - Values over 100m can be specified, as long as `radiusMeters` \\\u003c= `pixelSizeMeters * 1000`. - However, for values over 175m, the `DataLayerView` in the request must not include monthly flux or hourly shade. |\n| `view` | `enum (`[DataLayerView](/maps/documentation/solar/reference/rest/v1/dataLayers/get#DataLayerView)`)` Optional. The desired subset of the data to return. |\n| `requiredQuality` | `enum (`[ImageryQuality](/maps/documentation/solar/reference/rest/v1/dataLayers#ImageryQuality)`)` Optional. The minimum quality level allowed in the results. No result with lower quality than this will be returned. Not specifying this is equivalent to restricting to HIGH quality only. |\n| `pixelSizeMeters` | `number` Optional. The minimum scale, in meters per pixel, of the data to return. Values of 0.1 (the default, if this field is not set explicitly), 0.25, 0.5, and 1.0 are supported. Imagery components whose normal resolution is less than `pixelSizeMeters` will be returned at the resolution specified by `pixelSizeMeters`; imagery components whose normal resolution is equal to or greater than `pixelSizeMeters` will be returned at that normal resolution. |\n| `exactQualityRequired` | `boolean` Optional. Whether to require exact quality of the imagery. If set to false, the `requiredQuality` field is interpreted as the minimum required quality, such that HIGH quality imagery may be returned when `requiredQuality` is set to MEDIUM. If set to true, `requiredQuality` is interpreted as the exact required quality and only `MEDIUM` quality imagery is returned if `requiredQuality` is set to `MEDIUM`. |\n| `experiments[]` | `enum (`[Experiment](/maps/documentation/solar/reference/rest/v1/Experiment)`)` Optional. Specifies the pre-GA experiments to enable. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [DataLayers](/maps/documentation/solar/reference/rest/v1/dataLayers#DataLayers).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nDataLayerView\n-------------\n\nWhat subset of the solar information to return.\n\n| Enums ||\n|----------------------------------|--------------------------------------------------------|\n| `DATA_LAYER_VIEW_UNSPECIFIED` | Equivalent to FULL. |\n| `DSM_LAYER` | Get the DSM only. |\n| `IMAGERY_LAYERS` | Get the DSM, RGB, and mask. |\n| `IMAGERY_AND_ANNUAL_FLUX_LAYERS` | Get the DSM, RGB, mask, and annual flux. |\n| `IMAGERY_AND_ALL_FLUX_LAYERS` | Get the DSM, RGB, mask, annual flux, and monthly flux. |\n| `FULL_LAYERS` | Get all data. |"]]
