建物の概要と入口

建物の枠線は緯度と経度の座標ペアのセットで、建物の 建物で覆われている地球の表面積を表す 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.