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

建筑物遮罩图片的网址：每个像素一位，用于指明相应像素是否被视为屋顶的一部分。
annualFluxUrl

string

相应区域的年通量地图（屋顶上的年日照量）的网址。值以千瓦时/千瓦/年为单位。这是未遮盖的通量：系统会针对每个位置（而不仅仅是建筑物屋顶）计算通量。无效位置存储为 -9999：覆盖范围之外的位置将无效，覆盖范围内无法计算通量的少数位置也将无效。
monthlyFluxUrl

string

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

string

12 个用于每小时阴影的网址，按 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 个网址（从零开始编制索引），[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 米/像素分辨率处理的增强型航拍图像。
BASE 太阳能数据源自以 0.25 米/像素处理的增强型卫星图像。

方法

get

 获取某个位置周围区域的太阳能信息。