地理编码响应中的 grounds
字段包含一个理由,该理由在填充后会提供有关地理编码所针对的直接管辖区域的背景信息。例如:
- 如果地理编码是位于公园内的博物馆,则场地可能是公园。
- 如果地理编码是商业街内的商店,则场地可能是商业街。
- 如果地理编码是体育中心内的餐厅,则场地可能是体育中心。
- 如果地理编码是大学内的一栋建筑,则场地可能是该大学。
- 如果地理编码是企业园区内的办公楼,则场地可能是企业园区。
原因包含以下值:
outline
包含场地所覆盖的地球表面积的近似多边形的 GeoJSON 编码,使用 RFC 7946 格式name
包含理由的名称,是一个具有子字段language_code
和text
的对象
对于一些(但并非所有)具有精确位置信息的地点(例如街道地址、建筑物和营业场所),系统会返回场地信息。代表较大区域(例如城市和地区)的地点不会随理由一起返回。
请求详情
您可以在以下类型的请求中获取导航点:
对于上述任何请求,您都必须提供以下参数:extra_computations=GROUNDS
。
示例请求
以下查询使用地点地理编码来获取美国新泽西州哈肯萨克一家购物中心内餐厅的场地:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJ-Wdg_3b6wokRjB1ux1e68XM&extra_computations=GROUNDS&key=YOUR_API_KEY
示例响应
上述查询的响应会显示理由:
{
"grounds" : {
"display_name" : {
"language_code" : "en",
"text" : "The Shops at Riverside"
},
"outline" : {
"coordinates" : [
[
[
-74.03276087437951,
40.9079393287367
],
[
-74.0328096444231,
40.9079123990298
],
[
-74.032853573312,
40.9078787684781
],
[
-74.0329374864265,
40.907833205165
],
[
-74.0329543407656,
40.9076763372261
],
[
-74.0329762155439,
40.9076367262102
],
[
-74.03299916612821,
40.9075190685498
],
[
-74.0330511635356,
40.9071219006983
],
[
-74.0331433244228,
40.9065102533867
],
[
-74.03309025123249,
40.906473864115
],
[
-74.0330778794394,
40.9064567729216
],
[
-74.03304363287749,
40.9063779338105
],
[
-74.03298374620459,
40.9062267374933
],
[
-74.03284191870981,
40.9060418308559
],
[
-74.0327045736519,
40.9058626714851
],
[
-74.0324668194403,
40.9055539457374
],
[
-74.03218782543171,
40.9051507995429
],
[
-74.03202878431971,
40.9049213427489
],
[
-74.031980910588,
40.9048524525955
],
[
-74.0318966384468,
40.9047239669456
],
[
-74.03188946634801,
40.9047059572771
],
[
-74.0318858802984,
40.904689357769
],
[
-74.03188605960089,
40.9046316335439
],
[
-74.0317557066551,
40.9044960202159
],
[
-74.03166641393911,
40.9044030668361
],
[
-74.031603120081,
40.9043369552179
],
[
-74.0315466397082,
40.9042767712891
],
[
-74.03149625561549,
40.9042231654583
],
[
-74.0314272240077,
40.9041493230684
],
[
-74.0313515581648,
40.9040692773688
],
[
-74.031280374868,
40.9039955812079
],
[
-74.0312140327287,
40.9040621334267
],
[
-74.03094346414279,
40.9042364679492
],
[
-74.0309237407716,
40.9042490145166
],
[
-74.0309043760051,
40.9042578521067
],
[
-74.0308932591939,
40.9042613909983
],
[
-74.0308821423819,
40.9042634259862
],
[
-74.0308654671629,
40.9042639218323
],
[
-74.0285474182009,
40.9040980324443
],
[
-74.0285409631984,
40.9041506567763
],
[
-74.0284695995455,
40.9041477672732
],
[
-74.0284391175751,
40.904464680407
],
[
-74.0284416278552,
40.9044690964629
],
[
-74.0284448553581,
40.9044713582818
],
[
-74.0284504138353,
40.9044724463848
],
[
-74.0284848405289,
40.9044735630073
],
[
-74.02849255067299,
40.9047420452213
],
[
-74.0285024124847,
40.9047613382318
],
[
-74.0285088674885,
40.9047682680531
],
[
-74.0285178327711,
40.9047717937456
],
[
-74.02860246501849,
40.9047800216474
],
[
-74.0284446760524,
40.9060030191662
],
[
-74.02847533732761,
40.9060129264131
],
[
-74.0288760851204,
40.9060525457656
],
[
-74.0285884791836,
40.9069432827033
],
[
-74.02962647637111,
40.9069961651161
],
[
-74.029634186469,
40.906997858665
],
[
-74.0296395656068,
40.9070004251279
],
[
-74.0296417172619,
40.9070019329367
],
[
-74.02964422752621,
40.907003491537
],
[
-74.02964691709499,
40.9070070305046
],
[
-74.02964763431331,
40.907010440501
],
[
-74.02964727570421,
40.9070133973578
],
[
-74.02964619987669,
40.9070203129561
],
[
-74.02999046437181,
40.9070453118125
],
[
-74.03005788276261,
40.9077398485747
],
[
-74.0300808336987,
40.9080079189719
],
[
-74.03036987181341,
40.9080202832536
],
[
-74.03096784939891,
40.9080511362848
],
[
-74.03120058499491,
40.9080502612003
],
[
-74.0314021215987,
40.9080639151613
],
[
-74.03163754620471,
40.9080799617702
],
[
-74.03186472260489,
40.9080952909298
],
[
-74.0319188719515,
40.9080990493699
],
[
-74.0320239431563,
40.9080594910787
],
[
-74.0324187665168,
40.9080114893404
],
[
-74.0325363885767,
40.907988144292
],
[
-74.0326864641787,
40.9079585672777
],
[
-74.03276087437951,
40.9079393287367
]
]
],
"type" : "Polygon"
}
},
}
使用与构建轮廓和入口中的示例类似的 JavaScript 代码,我们能够在地图上渲染场地轮廓:
反馈
这是一项实验性功能。欢迎发送电子邮件至 geocoding-feedback-channel@google.com 提供反馈。