Solar API 通过 buildingInsights 和 dataLayers 端点提供太阳能潜力数据。如需使用 Solar API 数据，了解以下概念可能会有所帮助：
太阳辐射强度和日照
建筑物的太阳能潜力主要取决于其接收的阳光量以及其他因素。太阳辐照度是指落在给定区域的光量，而太阳辐射是指某个区域在一段时间内接收到的平均太阳辐照度。
千瓦 (kW) 是功率（即某事物使用能量的速率）的度量单位，而千瓦时 (kWh) 是所用能量或能量容量的度量单位。太阳辐照度以千瓦为单位，而太阳辐射以千瓦时为单位。
1 千瓦时/千瓦等于 1 个日照时，即阳光强度达到每平方米平均 1,000 瓦（1 千瓦）能量的小时数。
例如，如果屋顶的某个部分的太阳辐射强度为 2000 千瓦时/千瓦/年，那么放置在该处的 1 千瓦太阳能电池板阵列将产生 2000 千瓦时/年的电量。如果将 4 千瓦阵列放置在同一位置，则每年可产生 8,000 千瓦时。
标准测试条件是用于确定太阳能电池板功率输出的行业标准基准。在 STC 下，太阳能电池板的输出功率即为其最大功率额定值或容量。在 STC 条件下，1 kW 的太阳能板将产生 1 kWh 的能量。
晴朗度和日照分位数
Solar API 将“日照强度”定义为屋顶特定区域相对于屋顶其余区域每年平均接收的日照量。由于附近建筑物或树木的遮挡，屋顶的某些部分可能比其他部分更暗，而屋顶的其他部分可能始终完全暴露在天空下，因此会接收到更多阳光。
buildingInsights 响应中的 sunshineQuantiles 字段提供了屋顶或部分屋顶日照程度的 11 个分桶（十分位数）。Solar API 会获取屋顶上的所有点，按“日照强度”对这些点进行排序，并确定最高值、最低值和 9 个均匀分布的中间值。
例如，假设某个屋顶上日照最充足的部分（占 1%）每年每千瓦可接收 1,100 千瓦时的能量，而同一屋顶上日照最少的部分（也占 1%）每年每千瓦可接收 400 千瓦时的能量。屋顶上接下来最暗的 20% 区域每年每千瓦可接收 500 千瓦时。屋顶上接下来日照最充足的 50% 区域每年每千瓦可接收 900 千瓦时的能量。 其余 28% 的发电量为 1,000 千瓦时/千瓦/年。
光栅
dataLayers 端点会返回以 GeoTIFFs（一种光栅）编码的太阳能信息。
光栅由按行和列排列的单元格或像素矩阵组成。每个像素都包含一个表示相应位置信息的值，例如海拔、树冠、阳光等。
栅格可存储离散数据和连续数据。离散数据（例如土地覆盖或土壤类型）是专题数据或类别数据。连续数据表示没有明确边界的现象，例如海拔或航空影像。
栅格由用于衡量数据集不同特征的波段组成。栅格可以包含单个波段，也可以包含多个波段。每个频段都由一个存储信息的单元格（或像素）矩阵组成。像素可以存储浮点值或整数值。
像素的位深度表示像素可以存储的值的数量，计算公式为 2n，其中 n 是位深度。例如，一个 8 位像素最多可以存储 256 (28) 个值，范围从 0 到 255。
Flux
您可以使用 dataLayers 端点请求 flux 地图。Solar API 将通量定义为屋顶的年日照量（以千瓦时/千瓦/年为单位）。在计算通量时，Solar API 会考虑以下变量：
- 位置信息：Solar API 使用来自各种天气数据集的每小时太阳辐照度数据，这些数据通常位于 4 到 10 公里的网格中。该 API 会计算一年中每小时太阳在天空中的位置。这取决于地理位置，因此可能会有所不同。
- 天气模式（云）：这些因素已纳入太阳辐照度数据中。
- 附近障碍物的阴影：计算中会考虑树木、其他建筑物和屋顶其他部分的阴影。
- 朝向：屋顶各部分的俯仰角和方位角。
- 真实效率：由 Solar API 计算的值与太阳能板效率无关。若要计算发电量，您必须乘以电池板的千瓦数，并考虑其他系统损耗。如需了解详情，请参阅计算太阳能费用和节省金额。
Solar API 不会考虑以下变量：
- 逆变器效率和其他损耗：大多数值以直流千瓦时 (kWh) 为单位计算，但有些值会转换为交流千瓦时 (kWh)，假设系统效率为 85%。
- 污垢和积雪：这些因素未纳入计算中。