地址描述符会向标准的反向地理编码响应返回额外信息,这些信息有助于使用地标和区域来描述纬度和经度坐标。请查看地址描述符演示,了解该 API。
反向地理编码请求 - 其他参数
可选参数
以下是可包含在反向地理编码请求中的可选参数:
反向地理编码示例
以下查询包含德里某个位置的纬度/经度值:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&key=YOUR_API_KEY&enable_address_descriptor=true
响应
上面的查询会返回一个额外的 address_descriptor
,如下所示:
{
"address_descriptor" : {
"areas" : [
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Turkman Gate"
},
"place_id" : "ChIJ_7LLvyb9DDkRMKKxP9YyXgs"
},
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Chandni Chowk"
},
"place_id" : "ChIJWcXciBr9DDkRUb4dCDykTwI"
},
{
"containment" : "NEAR",
"display_name" : {
"language_code" : "en",
"text" : "Katar Ganj"
},
"place_id" : "ChIJH3cWUyH9DDkRaw-9CjvcRvY"
}
],
"landmarks" : [
{
"display_name" : {
"language_code" : "en",
"text" : "Delite Cinema"
},
"straight_line_distance_meters" : 29.9306755065918,
"place_id" : "ChIJLfiYDCT9DDkROoEa7NdupUM",
"travel_distance_meters" : 418.7794799804688,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "establishment", "movie_theater", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "YES Bank"
},
"straight_line_distance_meters" : 66.83731079101562,
"place_id" : "ChIJFYHM3yb9DDkRRKGkZl2mpSQ",
"travel_distance_meters" : 489.0340270996094,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "UCO Bank"
},
"straight_line_distance_meters" : 25.38849639892578,
"place_id" : "ChIJ-c6_wCb9DDkRjIk1LeqRtGM",
"travel_distance_meters" : 403.2246398925781,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "atm", "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Delhi By Cycle Meeting Point"
},
"straight_line_distance_meters" : 44.02867126464844,
"place_id" : "ChIJNxVfkSb9DDkRJD22l-eGFdM",
"travel_distance_meters" : 97.41281890869141,
"spatial_relationship" : "AROUND_THE_CORNER",
"types" : [
"establishment",
"point_of_interest",
"tourist_attraction",
"travel_agency"
]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Axis Bank Branch"
},
"straight_line_distance_meters" : 102.3495178222656,
"place_id" : "ChIJr3uaDCT9DDkR8roHTVSn1x4",
"travel_distance_meters" : 330.8566284179688,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
}
]
},
... Results (reverse geocoding response) ...
每个 address_descriptor
对象中有两个数组:landmarks
和 areas
。landmarks
数组包含最多 5 个按相关性排序的结果,这些结果会考虑与所请求坐标的邻近度、地标的存在程度及其可见性。每个地标结果都包含以下值:
place_id
是地标结果的地点 ID。请参阅地点 ID 概览。display_name
是地标的显示名称,包含language_code
和text
。straight_line_distance_meters
表示输入坐标和地标结果之间的点对点距离(以米为单位)。travel_distance_meters
是指输入坐标和地标结果之间经由道路网(忽略道路限制)所经过的距离(以米为单位)。spatial_relationship
是输入坐标与地标结果之间的估算关系:- 当以下项均不适用时,
"NEAR"
是默认关系。 - 当输入坐标包含在与地标关联的结构边界内时,值为
"WITHIN"
。 - 当输入坐标与地标或地标的接入点直接相邻时,使用
"BESIDE"
。 "ACROSS_THE_ROAD"
(当输入坐标与路线另一侧的地标直接相反时)。"DOWN_THE_ROAD"
(当输入坐标与地标沿着同一路线时,而不沿着"BESIDES"
或"ACROSS_THE_ROAD"
时)。- 当输入坐标沿垂直路线作为地标(限制为一个转弯)时,使用
"AROUND_THE_CORNER"
。 - 当输入坐标在空间上靠近地标,但远离其接入点时,使用
"BEHIND"
。 types
是地标的地点类型。
areas
对象最多包含 3 个响应,其自身限制为表示小区域的地点,例如社区、子市行政区和大型综合体。包含所请求坐标的区域会首先列出,并按从小到大的顺序排列。每个 areas
结果包含以下值:
place_id
是区域结果的地点 ID。请参阅地点 ID 概览。display_name
是该区域的显示名,包含language_code
和text
。containment
是输入坐标与区域结果之间的估计包含关系:- 当以下项均不适用时,
"NEAR"
是默认关系。 - 当输入坐标靠近区域的中心时为
"WITHIN"
。 - 当输入坐标靠近区域边缘时为
"OUTSKIRTS"
。
覆盖范围
此功能仅在部分国家/地区提供。
反馈
这是一项实验性功能,如果您能提供反馈,我们将不胜感激。请发送电子邮件至 address-descriptors-feedback@google.com 与我们联系。