Solar API は、場所データを使用して建物の種類を特定し、衛星画像に基づいて建物を識別します。このページでは、buildingInsights
リクエストでどの建物の太陽光発電情報が返されるかを確認する方法について説明します。
建物の種類
Solar API は、premise
タイプの建物をサポートしています。このタイプは名前のある場所を示します。通常は共通の名前を持つ建物や建物の集合体です。
他のタイプ(subpremise
や複合物(たとえば、premise
として登録されていない限り、1 つの区画にある分離された建物)など)はサポートされていません。
建物の屋根
Solar API は、衛星画像に基づいて屋上太陽光発電パネルの最適な配置を特定します。住宅の建物(特に傾斜屋根や傾斜屋根)は高い精度で識別されますが、平屋根の建物(アパートや商業施設など)は精度が異なる場合があります。
住所からの検索
Geocoding API または Place Autocomplete API を使用すると、住所を緯度と経度の座標に変換できます。
place_id
を使用して、一致した場所を参照します。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 },... }
- Solar API が一致する建物が見つかった場合は、
オープンソースのサンプルアプリを使用するか、buildingInsights
リクエストを行うことで、Solar API の対象となる建物の place_id
を確認できます。
地図上の場所を選択する
また、Maps JavaScript API を使ってユーザーが地図上で建物を選択できるようにすることで、別のエクスペリエンスを提供することもできます。マウス イベントから建物の緯度と経度を抽出し、それらの座標を buildingInsights
リクエストに渡します。