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 .

experiments[]

enum ( Experiment )

Необязательный. Указывает, какие эксперименты перед GA следует включить.

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

В случае успеха тело ответа содержит экземпляр 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 Получите все данные.