Method: dataLayers.get

获取某个地点周围区域的太阳能信息。如果相应位置不在覆盖范围内，则返回代码为 NOT_FOUND 的错误。

HTTP 请求

GET https://solar.googleapis.com/v1/dataLayers:get

网址采用 gRPC 转码语法。

查询参数

参数
location

object (LatLng)

必需。要获取数据的地区中心的经纬度。
radiusMeters

number

必需。半径（以米为单位），用于定义应返回数据的中心点周围的区域。此值存在以下限制：

  • 您可以随时指定不超过 100 米的任何值。
  • 可以指定超过 1 亿的值，前提是 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 设置为 MEDIUM 时，系统可能会返回 HIGH 画质的图像。如果设置为 true，requiredQuality 会被解读为确切的所需质量；如果 requiredQuality 设置为 MEDIUM，则仅返回 MEDIUM 质量的图像。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文包含一个 DataLayers 实例。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

DataLayerView

要返回的太阳能信息的子集。

枚举
DATA_LAYER_VIEW_UNSPECIFIED 等同于 FULL。
DSM_LAYER 仅获取 DSM。
IMAGERY_LAYERS 获取 DSM、RGB 和遮罩。
IMAGERY_AND_ANNUAL_FLUX_LAYERS 获取 DSM、RGB、蒙版和年均通量。
IMAGERY_AND_ALL_FLUX_LAYERS 获取 DSM、RGB、掩膜、年光通量和月光通量。
FULL_LAYERS 获取所有数据。