REST Resource: dataLayers

{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}

object (Date)

此区域中的源图像（所有其他数据都来源于此）的时间。因为这些图像可能拍摄时间超过一天，所以显示的结果可能太接近了。

object (Date)

此图像的处理完成时间。

string

地区 DSM（数字平台模型）的图片网址。值以高于 EGM96 大地水准（即海平面）的米为单位。无效位置（我们没有数据）存储为 -9999。

string

地区的 RGB 数据图片（航拍照片）的网址。

string

建筑物遮罩图片的网址：每像素 1 位，指明该像素是否属于屋顶。

string

地区年度通量地图（屋顶上的年度日照量）的网址。值为 kWh/kW/年。这是“未遮盖的通量”：计算每个位置的通量，而不仅仅是建筑物屋顶。无效位置存储为 -9999：覆盖区域内以外的位置无效，覆盖区域内无法计算通量的某些位置也将无效。

string

地区的每月通量地图（屋顶上的日照，按月细分）的网址。值为 kWh/kW/年。此网址指向的 GeoTIFF 将按顺序包含 12 个频段，分别对应于 1 月到 12 月。

string

十二个每小时阴影网址，分别对应 1 月...12 月（按顺序）。每个 GeoTIFF 将包含 24 个频段，分别对应一天中的 24 小时。每个像素都是一个 32 位的整数，最多对应当月的第 31 天；1 位表示相应位置能够在当月的那一天中看到太阳。无效位置被存储为 -9999（因为该值为负数，所以其设置了位 31，而任何有效值不能将位 31 设置为对应于当月 32 日的位 31）。

下面的示例可能对您有所帮助。如果您想知道某个点（在像素位置 (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] 表示将频道编入索引，最终非零结果表示“sunny”。没有闰日，也不存在 DST（每一天都有 24 小时；中午始终是“标准时间”中午）。

enum (ImageryQuality)

结果图像的质量。

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

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

integer

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

integer

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