Solar API 透過 buildingInsights 和 dataLayers 端點提供太陽能發電潛力資料。如要使用 Solar API 資料，瞭解下列概念可能會很有幫助：
太陽能輻射與隔熱
建築物的太陽能發電潛力主要取決於其收到的日光量和其他因素。太陽輻射是指在特定區域的光量，「太陽過射」則是指特定區域隨著時間獲得的平均太陽輻射量。
「千瓦」 (kW) 是用來測量「功率」或能源使用速率，而「千瓦時」 (kWh) 則是「能源」或能源容量的測量指標。太陽輻射的測量單位為千瓦，而太陽能隔熱測量則以千瓦小時為單位。
1 kWh/kW 等於 1 太陽小時，意指日光強度達到平均每平方公尺平均 1,000 瓦特 (1 千瓦) 的能源。
舉例來說，如果屋頂的一部分太陽能板承載自每年 2000 千瓦時/千瓦時，那麼在該屋頂上放置 1 千瓦太陽能板陣列將產生每年 2000 千瓦時的瓦時。放在相同位置的 4 kW 陣列將產生每年 8000 千瓦時的結果。
標準測試條件是業界標準的基準，可用於判斷太陽能板發電的輸出。對 STC 來說，太陽能板輸出的功率會成為其功率分級上限 (或稱電量)。採用 STC 時，1 千瓦面板可產生 1 千瓦時的能源。
日光黃和陽光分位數
Solar API 將「日光」定義為屋頂上特定屋頂部分的陽光相對於屋頂其他部分的平均日照量。屋頂的某些區域可能會因為周圍建築物或樹木覆蓋的陰影而變得較深，而屋頂的其他部分則隨時可能完全暴露在天空中，因此會得到較多的陽光。
buildingInsights 回應中的 sunshineQuantiles 欄位提供了 11 個 11 桶 (即岩盤或部分屋頂的陽性)。Solar API 會擷取屋頂的所有點，依照「日光」進行排序，然後識別最高、最低和 9 個中繼空間值。
例如，假設指定屋頂的最寬部分 (1%) 接收 1100 kWh/kW/year，而相同屋頂的最深部分 (也是 1%) 可接收到 400 kWh/kW/year。屋頂的下一個最黑暗 20&percnt，每年可收到 500 千瓦時/千瓦時。屋頂的下個最陽性 50&percnt，每年可接收 900 千瓦時/千瓦時。 其餘 28&percnt；接收 1000 kWh/kW/year。
光柵
dataLayers 端點會傳回以 GeoTIFFs 編碼的太陽能資訊 (一種光柵類型)。
「光柵」是由儲存格矩陣 (或稱「像素」) 組成，並分別顯示在列和欄中。每個像素都包含一個值，代表該位置的相關資訊，例如高度、樹冠、日光等。
光柵會儲存離散和連續的資料。離散資料 (例如土地覆蓋或土壤類型) 為主題或類別型資料。連續資料代表沒有明確界線的現象，例如高度或空照圖像。
光柵由「頻帶」組成，可測量資料集的不同特性。光柵可以搭配單一錶帶或多個錶帶。每個錶帶都是由儲存格矩陣，或用來儲存資訊的「像素」組成。像素可以儲存浮點值或整數值。
像素的「位元深度」會根據公式 2n 來表示像素可儲存的值數量，其中 n 是位元深度。例如，8 位元像素最多可以儲存 256 (28) 的值，範圍介於 0 到 255 之間。
流體
您可以使用 dataLayers 端點要求流水對應。Solar API 將「flux」定義為屋頂上的日光量 (kWh/kW/年)。在計算波動時，Solar API 會考量下列變數：
- 位置資訊：Solar API 會使用來自不同天氣組合的每小時太陽輻射資料，通常位於 4 至 10 公里的電網上。API 會在每年的每個小時內計算太陽在空中的位置。實際情況因地點而異，因此可能會有變動。
- 天氣模式 (雲)：這些變化會計入太陽輻射資料。
- 避開鄰近障礙物：在計算時，系統會將樹木、其他建築物和屋頂其他部分的陰影納入考量。
- 方向：屋頂每個部分的俯仰角和方位角。
- 實際效率：Solar API 計算的值與固定樣本效率無關，如要計算能源生產量，您必須將面板的千瓦特乘以其他系統損失。詳情請參閱「計算太陽能費用與節省費用」一文。
Solar API 不會將下列變數納入考量：
- 反相器效率和其他損失：大多數值都會以 DC kWh 計算，但有些值會假設系統效率 85&percnt 時轉換至 AC kWh。
- 航行和下雪：未包含在計算中。