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