Method: dataLayers.get

获取位置周围区域的太阳能信息。如果营业地点不在服务范围内，则返回代码为 NOT_FOUND 的错误。

HTTP 请求

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

网址采用 gRPC 转码语法。

查询参数

参数
location

object (LatLng)

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

number

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

  • 你可以随时指定任何不超过 100m 的值。
  • 可以指定超过 100m 的值，前提是 radiusMeters <= pixelSizeMeters * 1000。
  • 但是，对于超过 1.75 亿的值，请求中的 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 时可以返回高质量图像。如果设置为 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 获取所有数据。