Method: dataLayers.get

获取某个位置周围区域的太阳能信息。如果该位置超出覆盖范围,则返回代码为 NOT_FOUND 的错误。

HTTP 请求

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

网址采用 gRPC 转码语法。

查询参数

参数
location

object (LatLng)

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

radiusMeters

number

必需。半径(以米为单位),用于定义应返回数据的中心点周围的区域。此值的限制如下:

  • 始终可以指定不超过 100 米的任何值。
  • 可以指定超过 100 米的值,前提是 radiusMeters <= pixelSizeMeters * 1000
  • 不过,对于超过 175 米的值,请求中的 DataLayerView 不得包含每月通量或每小时阴影。
view

enum (DataLayerView)

可选。要返回的数据的所需子集。

requiredQuality

enum (ImageryQuality)

可选。结果中允许的最低质量级别。系统不会返回质量低于此级别的结果。如果不指定此项,则相当于仅限制为 HIGH 质量。

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)

可选。指定要启用的正式发布前实验。根据《Google Maps Platform 服务专用条款》,使用此字段的请求属于非正式版产品。如需了解详情,请参阅 [发布阶段说明]( https://cloud.google.com/maps-platform/terms/launch-stages)。

请求正文

请求正文必须为空。

响应正文

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