搜尋建築物

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

建築物類型

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

除非註冊為 premise，否則系統不支援其他類型 (例如 subpremise 或化合物)，例如位於單一屬性的卸離建築物。

建築物屋頂

Solar API 可根據衛星圖像找出最佳的屋頂太陽能板放置位置。住宅建築物 (尤其是傾斜或傾斜的屋頂) 的準確度較高，而採用平坦屋頂的建築物 (例如公寓或商業建築物) 則可能有不同的準確性。

提示： 根據其他選擇方法 (包括手動選取使用者或自訂程式輔助選擇)，您可以使用 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 要求，檢查 place_id 是否有使用 Solar API 所涵蓋的建築物。

在地圖上選取地點

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