REST Resource: dataLayers

资源：DataLayers

有关某个区域的太阳能发电潜力的信息。实际数据包含在多个 GeoTIFF 文件中，这些文件涵盖了请求的区域，此消息包含这些文件的网址：DataLayers 消息中的每个字符串都包含一个网址，您可以通过该网址提取相应的 GeoTIFF。这些网址在生成后会在几个小时内有效。大多数 GeoTIFF 文件的分辨率为 0.1 米/像素，但月度通量文件的分辨率为 0.5 米/像素，小时阴影文件的分辨率为 1 米/像素。如果在 GetDataLayersRequest 中指定了 pixelSizeMeters 值，则 GeoTIFF 文件中的最小分辨率将为该值。

JSON 表示法 
{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}
字段
imageryDate

object (Date)

此区域的源图像（所有其他数据均派生自此）的拍摄时间。由于图片可能拍摄于多天内，因此此时间范围必然具有一定的不确定性。
imageryProcessedDate

object (Date)

此图像的处理完成时间。
dsmUrl

string

相应区域 DSM（数字地表模型）图片的网址。值以高于 EGM96 地心引力模型（即海平面）的米数表示。无效的位置（我们没有数据的位置）会存储为 -9999。
rgbUrl

string

相应区域 RGB 数据（航拍照片）的图片网址。
maskUrl

string

建筑物遮罩图片的网址：每个像素占用 1 位，表示该像素是否被视为屋顶的一部分。
annualFluxUrl

string

相应区域的年均辐射量地图（屋顶年均日照量）的网址。值为千瓦时/千瓦/年。这是未经脱敏的通量：系统会针对每个位置（而不仅仅是建筑物屋顶）计算通量。无效的位置会存储为 -9999：不在覆盖范围内的位置无效，并且覆盖范围内无法计算通量的部分位置也无效。
monthlyFluxUrl

string

相应区域的每月通量图（屋顶上的阳光，按月细分）的网址。值为千瓦时/千瓦/年。此网址指向的 GeoTIFF 将包含十二个波段，依次对应于 1 月到 12 月。
hourlyShadeUrls[]

string

十二个小时阴影网址，分别对应于 1 月到 12 月。每个 GeoTIFF 文件都包含 24 个波段，对应于一天中的 24 个小时。每个像素都是一个 32 位整数，对应于当月（最多）31 天；1 位表示相应位置能够在当月当天当小时看到太阳。无效的位置存储为 -9999（由于此值为负，因此其设置了位 31，并且任何有效值都不能设置位 31，因为这会对应于当月的 32 天）。

下面的示例可能很有用。如果您想知道某个点（位于像素位置 (x, y)）在 6 月 22 日下午 4 点是否见到阳光，则需要执行以下操作：

  1. 提取此列表中的第六个网址（对应于 6 月）。
  2. 查找第 17 个频道（对应于下午 4 点）。
  3. 读取 (x, y) 处的 32 位值。
  4. 读取该值的 21 位（对应于当月 22 日）。
  5. 如果该位数为 1，则表示该点在 6 月 22 日下午 4 点看到了太阳。

更正式地说：给定 month（1-12）、day（1...月最大；2 月有 28 天）和 hour（0-23），则相应月份/日期/小时在位置 (x, y) 的阴影/阳光是位

(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))

其中 (x, y) 是空间索引编制，[month - 1] 是提取第 month - 1 个网址（从 0 开始编制索引），[hour] 是将网址编入渠道，最终的非零结果表示“晴天”。没有闰日，也不存在夏令时（所有日期均为 24 小时；中午始终是“标准时间”中午）。
imageryQuality

enum (ImageryQuality)

结果的图像质量。

日期

表示整个或部分日历日期（例如生日）。一天中的时间和时区要么在别处指定，要么不重要。日期相对于公历。可以表示以下任一情况：

  • 包含非零年份、月份和天值的完整日期。
  • 月份和天，年份值为零（例如周年纪念日）。
  • 单独的年份，月份和天值为零。
  • 年份和月份，天值为零（例如，信用卡到期日期）。

相关类型：

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer
}
字段
year

integer

日期中的年份。必须介于 1 到 9999 之间，或为 0（即指定不含年份的日期）。
month

integer

一年中的第几个月。必须介于 1 到 12 之间，或为 0（即只指定年份，不指定月份和天值）。
day

integer

一个月中的第几天。必须介于 1 到 31 之间并且对年份和月份有效，或为 0（即天不重要，指定单独的年份或者年份和月份）。

ImageryQuality

用于计算某些 API 结果的图像质量。

注意：无论图像质量级别如何，DSM 输出始终为 0.1 米/像素的分辨率，月度通量输出始终为 0.5 米/像素的分辨率，每小时阴影输出始终为 1 米/像素的分辨率。

枚举
IMAGERY_QUALITY_UNSPECIFIED 质量未知。
HIGH 太阳能数据来自于在低空拍摄的航拍图像，处理分辨率为 0.1 米/像素。
MEDIUM 太阳能数据来自高海拔拍摄的增强型航拍图像，处理分辨率为 0.25 米/像素。
LOW 太阳能数据源自以 0.25 米/像素处理的增强型卫星图像。

方法

get

 获取某个地点周围区域的太阳能信息。