dataLayers 端点返回编码为 GeoTIFF 文件的数据，这些数据可用于任何地理信息系统 (GIS) 应用来设计太阳能系统。
dataLayer 响应中的每个字符串都包含一个网址，可用于获取相应的 GeoTIFF。从原始数据层请求生成网址后，网址有效期最长为 1 小时。GeoTIFF 文件最多可以存储 30 天。
除 RGB 图层外，GeoTIFF 文件无法在图片查看器中正确显示，因为内容是编码数据而非 RGB 图片。GeoTIFF 文件也不能直接用作 Maps JavaScript API 的叠加层图像。
下表详细介绍了各个图层。
| 图层 | 像素深度 | 分辨率 | 说明 |
|---|---|---|---|
| 数字平台模型 (DSM) | 32 位浮点数 | 0.1 米/像素 | 表示地球表面地形的海拔数据，包括自然地图项和建筑地图项。值以高于海平面的米为单位。无效位置或我们没有数据的区域会存储为 -9999。 |
| RGB | 8 位 | 0.1 米/像素 0.25 米/像素 0.5 米/像素 1 米/像素 |
相应区域的航拍图像。GeoTIFF 图像文件包含与红色、绿色和蓝色值相对应的三个波段，以便为每个像素形成 24 位 RGB 值。 默认情况下，像素分辨率为 0.1 米/像素。 |
| 建筑物遮罩 | 1 位 | 0.1 米/像素 | 每像素 1 位，用于指明该像素是否属于屋顶。 |
| 年度通量 | 32 位浮点数 | 0.1 米/像素 | 该地区的年度通量地图，即屋顶的年度光照。
值为 kWh/kW/年。 我们会针对每个位置（而不仅仅是建筑物屋顶）计算通量。无效的位置或我们无法计算流量的区域会存储为 -9999。我们的覆盖区域之外的位置无效。 注意：这是未遮盖流量。 |
| 每月流量 | 32 位浮点数 | 0.5 米/像素 | 区域的每月通量地图（屋顶上的日照量，按月细分）。值为 kWh/kW/年。GeoTIFF 图像文件包含 12 个按顺序对应 1 月到 12 月的波段。 |
| 每小时阴影 | 32 位整数 | 100 万/像素 | 对应于 1 月到 12 月的每小时阴影地图（按顺序）的 12 个网址。 每个 GeoTIFF 文件都包含 24 个频段，分别对应一天中的 24 小时。每个像素都是一个 32 位的整数，最多对应当月的 31 天。1 位表示相应位置能够在当月的那一天、那个小时看到太阳。 无效位置会存储为 -9999 并设置位 31（对应于每月 32 日），因此该位置无效。 |
解码每小时阴影光栅
每小时阴影数据采用多频光栅编码。如需详细了解光栅基础知识，请参阅 Solar API 概念。
当您请求每小时的暗色数据时，您最多可以收到 12 个光栅，每个日历年（1 月到 12 月）每月一个光栅。每个光栅由 24 个图层（也称为“频带”）组成，对应一天 24 小时。
每个频段由单元格矩阵（即“像素”）表示。每个像素的深度为 32 位，对应于一个月中的（最多）31 天。因此，解码阴影数据的日期、时间和月份需要了解您正在分析的位、频段和光栅。
例如，如需确定坐标为 (x, y) 的给定位置是否在 6 月 22 日下午 4:00 看到太阳，请执行以下操作：
- 向所有图层发出位置 (x, y) 数据请求。
- 由于 6 月是当年的第 6 个月，因此应提取
hourlyShadeUrls列表中的第六个网址。 - 每小时表带采用 24 小时制。如需获取下午 4:00 (16:00) 的数据，请查找第 17 个渠道。
- 位（天）从 0 开始索引。如需获取 6 月 22 日的数据，请读取位 21。
- 位会提供二进制数据，以指示该地点在给定日期和时间是否看到太阳。如果位为 1，则该位置看到太阳。如果该位为 0，则表示该位置出现阴影。
以下代码总结了上述步骤：
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))