Method: dataLayers.get
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Pobiera informacje o energii słonecznej dla regionu otaczającego lokalizację. Zwraca błąd o kodze NOT_FOUND, jeśli lokalizacja znajduje się poza obszarem zasięgu.
Żądanie HTTP
GET https://solar.googleapis.com/v1/dataLayers:get
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
| Parametry |
location |
object (LatLng)
Wymagane. Długość i szerokość geograficzna środka regionu, z którego mają pochodzić dane.
|
radiusMeters |
number
Wymagane. Promień (w metrach) określający obszar wokół punktu centralnego, z którego mają zostać zwrócone dane. Ograniczenia dotyczące tej wartości:
- Zawsze można podać dowolną wartość do 100 m.
- Można podać wartości większe niż 100 m, o ile
radiusMeters <= pixelSizeMeters * 1000.
- Jednak w przypadku wartości powyżej 175 m
DataLayerView w żądaniu nie może zawierać miesięcznego natężenia ani godzinnego zacienienia.
|
view |
enum (DataLayerView)
Opcjonalnie. Wybrany podzbiór danych do zwrócenia.
|
requiredQuality |
enum (ImageryQuality)
Opcjonalnie. Minimalny dozwolony poziom jakości w wynikach. Nie zostaną zwrócone żadne wyniki o niższej jakości. Nie podanie tej opcji jest równoznaczne z ograniczeniem do jakości WYSOKA.
|
pixelSizeMeters |
number
Opcjonalnie. Minimalna skala (w metrach na piksel) danych, które mają zostać zwrócone. Obsługiwane są wartości 0,1 (wartość domyślna, jeśli to pole nie zostanie określone), 0,25, 0,5 i 1,0. Komponenty z obrazem, których normalna rozdzielczość jest mniejsza niż pixelSizeMeters, będą zwracane w rozdzielczości określonej przez pixelSizeMeters. Komponenty z obrazem, których normalna rozdzielczość jest równa lub większa niż pixelSizeMeters, będą zwracane w tej normalnej rozdzielczości.
|
exactQualityRequired |
boolean
Opcjonalnie. Określa, czy wymagana jest dokładna jakość obrazów. Jeśli ustawisz wartość false, pole requiredQuality zostanie zinterpretowane jako minimalna wymagana jakość, co oznacza, że obrazy o jakości HIGH mogą zostać zwrócone, gdy requiredQuality jest ustawione na MEDIUM. Jeśli ma wartość Prawda, requiredQuality jest interpretowany jako dokładna wymagana jakość, a zwracane są tylko obrazy o jakości MEDIUM, jeśli requiredQuality ma wartość MEDIUM.
|
experiments[] |
enum (Experiment)
Opcjonalnie. Określa eksperymenty przed GA, które mają być włączone.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu DataLayers.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/cloud-platform
DataLayerView
Podzbiór informacji o słonecznej, który ma zostać zwrócony.
| Wartości w polu enum |
DATA_LAYER_VIEW_UNSPECIFIED |
Odpowiednik opcji FULL. |
DSM_LAYER |
Pobierz tylko DSM. |
IMAGERY_LAYERS |
Pobierz DSM, RGB i maskę. |
IMAGERY_AND_ANNUAL_FLUX_LAYERS |
Uzyskaj DSM, RGB, maskę i roczny flux. |
IMAGERY_AND_ALL_FLUX_LAYERS |
Uzyskaj dane DSM, RGB, maski, roczny i miesięczny. |
FULL_LAYERS |
Pobierz wszystkie dane. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-29 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
