建築物輪廓是一組經緯度座標組合, 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 與我們聯絡,提供寶貴意見。