搜尋建築物

太陽能 API 會使用地點資料判斷建築物類型，並根據衛星圖像識別建築物。本頁說明如何判斷buildingInsights要求傳回的建築物太陽能資訊。

建築物類型

Solar API 支援 premise 類型的建築物。這類地點通常是建築物或具有共同名稱的建築物群。

其他類型 (例如 subpremise 或複合式建築物，例如位於單一房地產上的獨立建築物，除非註冊為 premise) 不受支援。

建築物屋頂

Solar API 會根據衛星圖像，找出最適合安裝屋頂太陽能板的位置。系統可高度準確地識別住宅建築物，尤其是傾斜或尖頂屋頂，但平頂屋頂的建築物 (例如公寓或商業建築物) 準確度可能有所不同。

如果 buildingInsights 回應未包含 solarPanelConfigs 欄位，表示系統已正確處理建築物，但無法在屋頂上放置太陽能板。如果屋頂太小而無法安裝太陽能板，或是遮蔽物太多而無法產生足夠的能源，就可能發生這種情況。

提示： 根據其他選取方式 (包括手動選取使用者或自訂程式選取)，您可以使用 Solar API dataLayers 端點，自行計算太陽能潛力並放置太陽能板。

從地址搜尋

1. 您可以使用 Geocoding API 或 Place Autocomplete API，將地址轉換為經緯度座標。

   使用 place_id 參照相符地點。

2. 在 Solar API buildingInsights 要求中使用地點的經緯度座標。

   • 如果 Solar API 找到相符的建築物，請確認 buildingInsights 回應中的 place_id 與 Geocoding API 或 Place Autocomplete API 中的 place_id 相符。
   • 如要將結果限制為類型為 premise 的地點，請在 Geocoding API 或 Places API 回應中新增地點類型篩選器。

     {
     "name": "buildings/ChIJh0CMPQW7j4ARLrRiVvmg6Vs",
     "center": {
     "latitude": 37.4449739,
     "longitude": -122.13914659999998
     },...
     }

注意： 有時地點 ID 不會相符，這表示搜尋的 (緯度、經度) 無法解析為相同的地址或建築物。即使 Geocoding API 回應的精細度為 ROOFTOP，place_id 的類型也可能不是 premise。

您可以使用開放原始碼範例應用程式，或發出 buildingInsights 要求來檢查 Solar API 涵蓋的建築物。place_id

在地圖上選取位置

您也可以使用 Maps JavaScript API，讓使用者在地圖上選取建築物，提供互補體驗。從滑鼠事件中擷取建築物的經緯度，然後在 buildingInsights 要求中傳遞這些座標。