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 质量的图像。
experiments[]

enum (Experiment)

可选。指定要启用的正式版发布前实验。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文包含一个 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 获取所有数据。