建物の輪郭は、建物が覆う地球の表面積を表す 2D ポリゴンを定義する緯度と経度の座標ペアのセットです。このポリゴンを使用して、地図上に建物の枠線を描画できます。 入口は、1 つの緯度と経度の座標ペアで、 ある場所への出入口の位置たとえば あります。
追加のパラメータ
含める
ジオコーディング リクエスト内の extra_computations=BUILDING_AND_ENTRANCES
リバース ジオコーディングのリクエスト
またはプレイスのジオコーディング リクエスト
を使用して、入り口と建物の概略をレスポンスで受け取ります。
リクエスト例
次のクエリは、レストランの建物のアウトラインと入口を有効にします。 カリフォルニア州マウンテンビュー（米国カリフォルニア州）
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJ4TTDdzS3j4AR78EQgu5EADA&extra_computations=BUILDING_AND_ENTRANCES&key=YOUR_API_KEY
レスポンスの例
上記のクエリからのレスポンスは次のとおりです。
{
"entrances": [
{
"location": {
"lat": 37.3925065,
"lng": -122.0799465
},
"building_place_id": "ChIJVeHddzS3j4ARFZJVu4Cf27o"
}
],
"buildings" : [
{
"building_outlines" : [
{
"display_polygon" : {
"coordinates" : [
[
[
-122.080188246116,
37.3926407183216
],
[
-122.080281351765,
37.3924887558601
],
[
-122.080023707261,
37.392390122414
],
[
-122.079926266852,
37.3925369491992
],
[
-122.080188246116,
37.3926407183216
]
]
],
"type" : "Polygon"
}
}
],
"place_id" : "ChIJVeHddzS3j4ARFZJVu4Cf27o"
}
],
}
この機能が有効になっている場合に返される配列は 2 つあります。buildings[] と entrances[] です。
各 entrances 結果には次のフィールドがあります。
locationは、入口の緯度と経度の座標です。building_place_idは、エントランスを含む建物のプレイス ID です。このパラメータは、常に入力されるわけではありません。
各 buildings の結果には次のフィールドがあります。
place_idは、建物の一意の識別子です。詳しくは、プレイス ID の概要をご覧ください。building_outlines[]は、建物に関連付けられた輪郭の配列です。現時点では、この配列にはエントリが 1 つだけあります。building_outlines[]の各オブジェクトには、次のフィールドがあります。display_polygonは、ポリゴンの GeoJSON エンコードです。 建物で覆われた地表面積を推定し、 を使用 RFC 7946 形式。RFC 7946 形式はマルチポリゴン、 1 つのdisplay_polygonオブジェクトで複数のポリゴンを表すことができます。
対象範囲
この機能はすべての地域で利用できます。ただし、建物の輪郭や入り口がすべて表示されるわけではないため、カバレッジは地域によって異なります。また 建物の概要は含まれているが、 閲覧開始数今後、玄関の撮影範囲は改善される予定です。
フィードバック
この機能は試験運用中です。フィードバックは buildings-in-geocoding-feedback-channel@google.com までお寄せください。