使用 Geocoding API 获取建筑物轮廓和入口，以增强地图渲染中的数据可视化效果。
为此，请在地理编码请求中添加一个额外的参数，以返回用于定义建筑物轮廓或入口的纬度/经度坐标对。使用请求的输出在地图上绘制建筑物轮廓，并指示建筑物的入口。
- 建筑物轮廓是一组纬度/经度坐标对，用于定义表示建筑物所覆盖的地球表面积的 2D 多边形。
- 建筑物入口是一个纬度/经度坐标对，用于定义某个地点的入口和出口位置。
使用情况和覆盖面
您可以使用此服务在单个请求中返回单个地点的轮廓多边形。这意味着，如果请求城市级地理编码（例如英国伦敦），系统不会返回该地区内的所有建筑物轮廓。在这种情况下，该服务会返回不含建筑物轮廓或入口的标准地理编码响应。具体而言，该服务仅为以下地点类型生成轮廓和入口：
支持的地点类型
建筑物 |
进入次数 |
|---|---|
|
|
|
|
|
|
|
虽然此功能在所有地区均可使用，但覆盖范围因地区而异。此外，您应该会收到包含建筑物轮廓但没有入口数据的 API 响应。在这种情况下，该服务将返回包含建筑物轮廓的地理编码响应，但不包含入口数据数组。该服务会不断努力扩大门牌覆盖范围。
请求详情
您可以通过以下类型的请求获取建筑物轮廓和入口坐标：
对于任何此类请求，您都需要提供以下参数：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
示例响应
在大多数情况下，响应会返回与单个建筑物对应的字段，但在某些情况下，响应可以包含多个元素，例如占据多个建筑物的地图注点。响应元素包含两个数组：
一个包含以下字段的 buildings[] 数组：
place_id相应建筑物的唯一标识符。如需了解详情，请参阅地点 ID 概览。
building_outlines[]与相应建筑物关联的轮廓数组。此数组只有一个条目。
building_outlines[]中的每个对象都有以下字段：display_polygon
用于大致估算建筑物所覆盖地球表面积的多边形的 GeoJSON 编码，采用 RFC 7946 格式
一个包含以下字段的 entrances[] 数组：
location入口的纬度/经度坐标。
building_place_id包含相应入口的建筑物的地点 ID。这与地理编码结果的地点 ID 不同，除非地理编码结果是建筑物本身的。此参数并不总是填充。
上述查询的响应显示了建筑物数组中的一个入口和一个多边形项：
{
"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"
}
],
}
在地图上显示建筑物轮廓
JavaScript API 内置支持显示 RFC 7946 格式的多边形和多边形组合。具体操作如下：
- 使用多边形数据构建地图项对象。
- 为多边形应用样式。
- 将地图项附加到 JavaScript 地图对象。
buildings 数组中的每个对象都包含 building_outlines 数组中的单个对象。以下示例展示了如何在地图上显示建筑物轮廓：
//This function takes an argument of 'buildings', which is the buildings[] array returned by the API.
async function displayBuildingOutline(buildings) {
try {
//Import the Google Maps Data library.
const { Data } = await google.maps.importLibrary("maps")
//Loop though the array of building outlines.
buildings.forEach(building => {
const features = []
const buildingOutlines = building.building_outlines;
//Add each building outline to a Feature object, and push this to an array of Features.
buildingOutlines.forEach(buildingOutline => {
const feature = {
type: "Feature",
properties: {},
geometry: buildingOutline.display_polygon
}
features.push(feature);
});
//Create a new Google Maps Data object, and apply styling.
//We also assume the reference to the map on the page is named 'map'.
//This applies the Data object to the map on the page.
outlineLayer = new google.maps.Data({
map,
style: {
strokeColor: "#0085cc",
strokeOpacity: 1,
strokeWeight: 2,
fillColor: "#88d4fc",
fillOpacity: 0.5,
},
});
//Add the array of Features created earlier to the Data object, as GeoJson.
outlineLayer.addGeoJson({
type: "FeatureCollection",
features: features,
});
});
} catch (e) {
console.log('Building outlines failed. Error: ' + e)
}
}
使用上述代码，Geocoding API 在本文档前面示例响应中返回的建筑物轮廓会在地图上呈现如下所示：
边缘用例
您可能还会遇到以下极端情况；不过，上述示例代码仍然适用于这些情况：
- 包含多个建筑物轮廓的响应。
- 一个表示多个多边形的
building_outlines对象。
例如，地点 ID 为 ChIJGxgH9QBVHBYRl13JmZ0BFgo 的响应包含两个 building_outlines[] 数组结果：
"buildings": [
{
"building_outlines": [
{
"display_polygon": {
"coordinates": [
[
[
44.3313253363354,
13.636033631612
],
[
44.3312576355624,
13.6362094887862
],
[
44.3310854239923,
13.6361461767801
],
[
44.3311531250111,
13.6359703194634
],
[
44.3313253363354,
13.636033631612
]
]
],
"type": "Polygon"
}
}
],
"place_id": "ChIJ24NWUBhUHBYRSEmPBFa1wgc"
},
{
"building_outlines": [
{
"display_polygon": {
"coordinates": [
[
[
44.330737534504,
13.6357057440832
],
[
44.3307248314371,
13.6357390350529
],
[
44.3306985591742,
13.635729486373
],
[
44.3307114066013,
13.6356960265536
],
[
44.330737534504,
13.6357057440832
]
]
],
"type": "Polygon"
}
}
],
"place_id": "ChIJpzQOABlUHBYRxiOC9goY1fE"
}
]
使用上述 JavaScript 代码示例，我们能够在地图上渲染这两个轮廓：
反馈
这是一项实验性功能。欢迎通过 buildings-in-geocoding-feedback-channel@google.com 与我们分享反馈。