搜尋建築物

Solar 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 可能不相符，也就是說搜尋到的 (lat, lng) 無法解析為相同的地址或建築物。即使 Geocoding API 回應的細緻度為 ROOFTOP，place_id 的類型也可能不是 premise。

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

在地圖上選取位置

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