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