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 的图像组件将以该正常分辨率返回。

请求正文

请求正文必须为空。

响应正文

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