Method: dataLayers.get
Получает информацию о солнечной радиации для региона, окружающего данное местоположение. Возвращает ошибку с кодом NOT_FOUND
, если местоположение находится за пределами зоны покрытия.
HTTP-запрос
GET https://solar.googleapis.com/v1/dataLayers:get
URL-адрес использует синтаксис транскодирования gRPC .
Параметры запроса
Параметры |
---|
location | object ( LatLng ) Необходимый. Долгота и широта центра региона, для которого нужно получить данные. |
radiusMeters | number Необходимый. Радиус в метрах, определяющий область вокруг центральной точки, для которой должны быть возвращены данные. Ограничения на это значение: - Всегда можно указать любое значение до 100 м.
- Можно указать значения более 100 м, если
radiusMeters <= pixelSizeMeters * 1000 . - Однако для значений более 175 м
DataLayerView в запросе не должен включать ежемесячный поток или почасовую тень.
|
view | enum ( DataLayerView ) Необязательный. Желаемое подмножество возвращаемых данных. |
requiredQuality | enum ( ImageryQuality ) Необязательный. Минимальный уровень качества, разрешенный для результатов. Никакой результат с более низким качеством, чем этот, не будет возвращен. Отсутствие указания этого параметра эквивалентно ограничению только ВЫСОКОГО качества. |
pixelSizeMeters | number Необязательный. Минимальный масштаб возвращаемых данных в метрах на пиксель. Поддерживаются значения 0,1 (по умолчанию, если это поле не задано явно), 0,25, 0,5 и 1,0. Компоненты изображений, нормальное разрешение которых меньше, чем pixelSizeMeters будут возвращены с разрешением, указанным в pixelSizeMeters ; Компоненты изображений, нормальное разрешение которых равно или превышает значение pixelSizeMeters будут возвращены с этим нормальным разрешением. |
exactQualityRequired | boolean Необязательный. Требуется ли точное качество изображения. Если установлено значение false, поле requiredQuality интерпретируется как минимально требуемое качество, поэтому изображения ВЫСОКОГО качества могут быть возвращены, когда для requiredQuality установлено значение СРЕДНЕЕ. Если установлено значение true, requiredQuality интерпретируется как точное требуемое качество, и возвращаются только изображения MEDIUM качества, если для параметра requiredQuality установлено значение MEDIUM . |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа содержит экземпляр DataLayers
.
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/cloud-platform
DataLayerView
Какую часть солнечной информации нужно вернуть.
Перечисления |
---|
DATA_LAYER_VIEW_UNSPECIFIED | Эквивалент ПОЛНОГО. |
DSM_LAYER | Берите только DSM. |
IMAGERY_LAYERS | Возьмите DSM, RGB и маску. |
IMAGERY_AND_ANNUAL_FLUX_LAYERS | Получите DSM, RGB, маску и годовой поток. |
IMAGERY_AND_ALL_FLUX_LAYERS | Получите DSM, RGB, маску, годовой поток и ежемесячный поток. |
FULL_LAYERS | Получите все данные. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-02-27 UTC.
[null,null,["Последнее обновление: 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"]]