建物を検索

Solar API は、場所データを使用して建物の種類を特定し、衛星画像に基づいて建物を識別します。このページでは、buildingInsights リクエストでどの建物の太陽光発電情報が返されるかを確認する方法について説明します。

建物の種類

Solar API は、premise タイプの建物をサポートしています。このタイプは名前のある場所を示します。通常は共通の名前を持つ建物や建物の集合体です。

他のタイプ（subpremise や複合物（たとえば、premise として登録されていない限り、1 つの区画にある分離された建物）など）はサポートされていません。

建物の屋根

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 リクエストを行うことで、Solar API の対象となる建物の place_id を確認できます。

地図上の場所を選択する

また、Maps JavaScript API を使ってユーザーが地図上で建物を選択できるようにすることで、別のエクスペリエンスを提供することもできます。マウス イベントから建物の緯度と経度を抽出し、それらの座標を buildingInsights リクエストに渡します。