建物の概要と入口

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