Solar API は、 buildingInsights エンドポイントと dataLayers エンドポイントを介して太陽光発電のポテンシャルに関するデータを提供します。Solar API のデータを使用する際は、次のコンセプトを理解しておくと役立ちます。
太陽放射照度と日射量
建物の太陽光発電のポテンシャルは、主に日射量とその他の要因に基づいて決まります。太陽放射照度 は、特定のエリアに当たる光の量です。一方、日射量 は、あるエリアが一定期間に受ける平均太陽放射照度の測定値です。
キロワット（kW）は電力の単位、つまりエネルギーの使用率を表します。一方、キロワット時（kWh）はエネルギーの使用量またはエネルギー容量の単位です。太陽放射照度はキロワットで測定され、日射量はキロワット時で測定されます。
1 kWh/kW は 1 日照時間に相当します。1 日照時間は、太陽光の強度が 1 平方メートルあたり平均 1,000 ワット（1 キロワット）のエネルギーに達する 1 時間と定義されます。
たとえば、屋根の一部の日射量が 2, 000 kWh/kW/年の場合、そこに設置された 1 kW の太陽光パネル アレイは 2, 000 kWh/年を生成します。同じ場所に設置された 4 kW のアレイは 8,000 kWh/年を生成します。
標準試験 条件は 、太陽光パネルの出力電力を測定するために使用される業界標準のベンチマークです。STC では、太陽光パネルが出力する電力が最大出力定格、つまり容量になります。1 kW のパネルは、STC で 1 kWh のエネルギーを生成します。
日当たりと日射量分位数
Solar API では、「日当たり」は、屋根の特定の部分が受ける日射量を、屋根の他の部分と比較した相対的なレベルとして定義されます（年間平均）。屋根の一部は、近くの建物や樹木エリアによる日陰のために他の部分よりも暗くなることがあります。一方、屋根の一部は常に空に完全に露出しているため、より多くの日光を受けます。
sunshineQuantiles レスポンスの buildingInsights フィールドには、屋根または屋根の一部の日当たりの 11 個のバケット（十分位数）が用意されています。Solar API は、屋根のすべてのポイントを取得して「日当たり」で並べ替え、最も高い値、最も低い値、その間の等間隔に並んだ 9 個の値を特定します。
たとえば、ある屋根の日当たりの良い部分（1%）が 1,100 kWh/kW/年、同じ屋根の日当たりの悪い部分（1%）が 400 kWh/kW/年であるとします。次に日当たりの悪い 20% の屋根は 500 kWh/kW/年です。次に日当たりの良い 50% の屋根は 900 kWh/kW/年です。 残りの 28% は 1,000 kWh/kW/年です。
ラスター
dataLayers エンドポイントは、GeoTIFFsでエンコードされた太陽光発電に関する情報を返します。
ラスターは、行と列に配置されたセルのマトリックス（ピクセル）で構成されます。 各ピクセルには、その場所に関する情報（標高、樹木エリア、日光など）を表す値が含まれています。
ラスターには、離散データ と連続データ が格納されます。土地被覆や土壌タイプなどの離散データ は、テーマ別またはカテゴリ別です。連続データ は、標高や航空画像など、明確な境界のない現象を表します。
ラスターは、データセットのさまざまな特性を測定するバンドで構成されます。ラスターには、単一のバンドまたは複数のバンドを含めることができます。各バンドは、情報を格納するセルのマトリックス（ピクセル）で構成されます。ピクセルには、浮動小数点値または整数値を格納できます。
ピクセルのビット深度は、ピクセルが格納できる値の数を示します。これは、2nという式で計算されます。ここで、nはビット深度です。たとえば、8 ビットのピクセルには、0 ～ 255 の範囲の値を最大 256 個（28）格納できます。
フラックス
フラックスマップをdataLayersエンドポイントを使用してリクエストできます。Solar API では、フラックス は、屋根に当たる年間日射量を kWh/kW/年で表したものです。フラックスを計算する際、Solar API は次の変数を考慮します。
- 位置情報: Solar API は、さまざまな気象セットから 1 時間ごとの太陽放射照度データを使用します。通常、これらのデータは 4 ～ 10 km のグリッド上にあります。 API は、1 年の各時間における空の太陽の位置を計算します。これは位置によって異なり、結果として異なる場合があります。
- 気象パターン（雲）: 太陽放射照度データに考慮されます。
- 近くの障害物による日陰: 木、他の建物、屋根の他の部分による日陰が計算に考慮されます。
- 向き: 屋根の各部分のピッチと方位。
- 実際の効率: Solar API で計算される値は、パネルの効率とは無関係です。エネルギー生産量を計算するには、パネルのキロワット数を掛け、他のシステム損失を考慮する必要があります。詳細については、太陽光発電のコストと 節約額を計算するをご覧ください。
Solar API は、次の変数を考慮しません。
- インバータの効率とその他の損失: ほとんどの値は DC kWh で計算されますが、一部はシステム効率が 85% であると仮定して AC kWh に変換されます。
- 汚れと雪: 計算には含まれません。