建筑物轮廓是一组纬度/经度坐标对,用于定义 表示建筑物所覆盖的地球表面积的二维多边形。 您可以使用此多边形在地图上绘制建筑物的轮廓。 入口是一个纬度/经度坐标对,用于定义 某个地点的入口和出口位置;例如 。
其他参数
包含
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[]
是与以下内容相关联的轮廓数组: 建筑物。截至目前,此数组只有一个条目。每个对象building_outlines[]
具有以下字段:display_polygon
是多边形的 GeoJSON 编码 大致相当于建筑物所覆盖的地球表面积, 使用 RFC 7946 格式。请注意,RFC 7946 格式支持多重多边形, 因此一个display_polygon
对象可以表示多个多边形。
覆盖率
所有地区均提供此功能;不过,并非所有建筑物 但覆盖范围因地区而异。此外,您还应该 预计会收到的 API 响应包含建筑物轮廓,但 进入次数。入口覆盖率预计会随着时间的推移而不断提高。
反馈
这是一项实验性功能。如果您能提供反馈,我们将不胜感激。 buildings-in-geocoding-feedback-channel@google.com.