Solar API 可透過 buildingInsights 和 dataLayers 端點提供太陽能潛在資料。如要使用 Solar API 資料，瞭解下列概念可能會有幫助：
太陽輻射和溶解
建築物的「太陽能潛力」主要取決於建築物收到的陽光量以及其他因素。太陽輻射是指特定區域的光量，太陽能發電則是特定區域在一段時間內接收的平均太陽輻射量的測量結果。
千瓦 (kW) 是用來測量「功率」，或東西使用能量的速率，千瓦小時 (kWh) 則是使用「能源」或能源容量的測量依據。太陽輻射的測量單位為千瓦，而太陽能則以千瓦小時為單位。
1 kWh/kW 等於 1 日日，定義為一小時的日照強度，每平方公尺的發電量平均為 1,000 瓦 (1 千瓦)。
舉例來說，如果部分屋頂的太陽能隔熱量為 2000 kWh/kW/年，則在這裡放置的 1 kW 太陽能板陣列每年會產生 2000 kWh。放在相同位置的 4 kW 陣列每年會產生 8000 kWh。
標準測試條件是業界標準的基準測試，可用於判斷太陽能板的功率。在 STC 方面，太陽能板輸出的功率成為其最大功率 (或容量)。STC 採用 1 kW 面板可產生 1 kWh 的能源。
陽光和陽光的分位數
Solar API 將「日光」定義為相對於屋頂其他部分，屋頂特定部分所接收的日照量 (每年平均平均值)。屋頂的某些部分可能會因為鄰近建築物或樹皮遮蔽而變暗，而屋頂其他部分可能會隨時完全暴露在天空中，因此會接收較多陽光。
buildingInsights 回應中的 sunshineQuantiles 欄位可呈現屋頂或部分屋頂的日照量 11 分塊 (或分位數)。Solar API 會取用屋頂上的所有點，按「日光度」排序，並識別最高、最低和 9 個中間的中間間距值。
舉例來說，假設特定屋頂的日落部分 (1%) 每年收到 1100 kWh/kW/年，而同一屋頂最暗的部分 (也 1%) 則接收到 400 kWh/kW/year/year 狀態。下一個最暗的 20 屋頂屋頂是每年 500 千瓦時/千瓦/年。下一個晴天的屋頂是 50 千瓦時，每年可達到 900 千瓦時/千瓦時的水準。 其餘 28%；每年 1000 kWh/kW/年。
光柵
dataLayers 端點會傳回以 GeoTIFFs 中編碼的太陽能資訊，而這類資訊是一種光柵類型。
「光柵」是由一連串的儲存格 (或稱「像素」) 所組成，並依列和欄排列。每個像素都包含一個值，代表該位置的相關資訊，例如海拔、樹冠、日照等等。
光柵儲存離散和連續的資料。離散資料 (例如土地覆蓋或土壤類型) 是主題或類別型的資料。連續資料表示沒有明確邊界的現象，例如海拔或空拍圖像。
光柵是由「頻帶」組成，用來測量資料集的不同特性。光柵可以單一錶帶或多款錶帶。每個錶帶都是由儲存格矩陣 (又稱「像素」) 所組成，可儲存資訊。像素可以儲存浮點值或整數值。
像素的「位元深度」會根據公式 2n 指出像素可儲存的值數，其中 n 是位元深度。舉例來說，8 位元像素可儲存多達 0 到 255 之間的 256 (28) 值。
彈性
您可以使用 dataLayers 端點要求流動地圖。Solar API 將「flux」定義為屋頂的日照量，以千瓦時/千瓦/年為單位。計算流感時，Solar API 會將下列變數納入考量：
- 位置資訊：Solar API 會使用各種天氣組合的每小時太陽能發生率資料，通常為 4 到 10 公里的格線。API 會計算一年中每個小時的太陽位置。實際位置因地區而異，因此可能有所變動。
- 天氣模式 (雲)：在太陽輻射資料中顯然。
- 鄰近障礙物：計算時會將樹木、其他建築物和屋頂其他部分的著色納入考量。
- 方向：屋頂各部分的傾斜和方位角度。
- 真實效率：Solar API 計算的值與固定樣本效率無關。如要計算能源產量，您必須將面板的千瓦率乘以樣本數，並考量其他系統損失值。詳情請參閱「計算太陽能成本和節約效益」。
Solar API 不會將下列變數納入考量：
- 反相效率和其他損失：大部分值皆以 DC kWh 計算，但有些值會假設系統效率為 85&percnt，並轉換成 AC kWh。
- 積雪與雪：不會計入計算結果。