dataLayers 端点 返回编码为 GeoTIFF 文件的数据, 信息系统 (GIS) 应用来设计太阳能系统。
dataLayers 响应中的每个字符串都包含一个网址,您可以 用于获取相应的 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 米/像素 | 每像素一位,表示该像素是否被视为 或屋顶的一角 |
年均通量 | 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,例如 所对应的日期,因此该日期无效。 |
解码每小时阴影光栅
每小时阴影数据采用多频光栅编码。详细了解光栅 Solar API 概念。
当您请求按小时获取阴影数据时,最多可以收到 12 个栅格数据,每个日历月(1 月至 12 月)对应一个。每个光栅 由 24 个图层(也称为“频段”)组成,相当于 24 小时的有效期 。
每个频段由单元格矩阵(即“像素”)表示。每个像素都有一个 32 位的深度,对应于一个月中的(最大)31 天。 因此,解码阴影数据的日期、时间和月份需要 您要分析的位、频段和光栅
例如,要确定在坐标 (x, y) 处的指定位置是否 (6 月 22 日下午 4:00 星期日)进行以下活动:
- 向所有图层发出位置 (x, y) 数据请求。
- 因为 6 月是一年中的第六个月,所以提取第六个
hourlyShadeUrls
列表中的网址。 - 每小时表带采用 24 小时制。要获取下午 4:00 (16:00) 的数据, 查找第 17 个频道
- 位(天)从 0 开始索引。如需获取 6 月 22 日的数据,请读取位 21。
- 比特提供二进制数据,指示该位置是否在 指定日期和时间。如果位为 1,则该位置看到太阳。如果该位为 0, 看到阴影。
以下代码总结了上述步骤:
(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))