建築物輪廓和入口

建築物輪廓是一組經緯度座標組合, 2D 多邊形,代表建築物涵蓋的地球表面區域。 您可以使用此多邊形來在地圖上繪製建築物的輪廓。 入口是指單一經緯度座標組合,用於定義進入某個地點的進出點位置,例如建築物的門。

其他參數

地理編碼要求反向地理編碼要求地點地理編碼要求中加入 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。詳情請參閱地點 ID 總覽
  • building_outlines[] 是與 建築物。目前這個陣列只會有一個項目。當中的每個物件 building_outlines[] 具有以下欄位:
    • display_polygon 是多邊形的 GeoJSON 編碼 以估算建築物涵蓋的地球表面積、 使用 RFC 7946 格式。請注意,RFC 7946 格式支援多多邊形 因此一個 display_polygon 物件可以代表多個多邊形。

涵蓋範圍

這項功能適用於所有地區。不過,並非所有建築物都會 外框或入口和涵蓋範圍會因地區而異此外,您應該會收到包含建築物輪廓但沒有入口的 API 回應。入口覆蓋率預計會隨著時間逐漸改善。

意見回饋

這是實驗功能。歡迎透過 buildings-in-geocoding-feedback-channel@google.com 與我們聯絡,提供寶貴意見。