逆地理编码

逆地理编码的响应结果的格式由请求参数output指定。

parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

服务示例

https://restapi.amap.com/v3/geocode/regeo?output=xml&location=116.310003,39.991957&key=<用户的key>&radius=1000&extensions=all

参数	值	备注	必选
location		经纬度坐标;最多支持20个坐标点;多个点之间用"\|"分割。	是
poitype		支持传入POI TYPECODE及名称；支持传入多个POI类型，多值间用“\|”分隔	否
radius		查询POI的半径范围。取值范围：0~3000,单位：米	否
extensions	all base	返回结果控制	否
batch	false true	batch=true为批量查询。batch=false为单点查询	否
roadlevel		可选值：1，当roadlevel=1时，过滤非主干道路，仅输出主干道路数据	否

说明：location(116.310003,39.991957) 是所需要转换的坐标点经纬度，radius（1000）为返回的附近POI的范围，单位：米，extensions(all)为返回的数据内容，output（XML）用于指定返回数据的格式，Key 是高德Web服务 Key。详细可以参考上方的请求参数说明。

地理编码匹配级别列表

匹配级别	示例说明
国家	中国
省	河北省、北京市
市	宁波市
区县	北京市朝阳区
开发区	亦庄经济开发区
乡镇	回龙观镇
村庄	三元村
热点商圈	上海市黄浦区老西门
兴趣点	北京市朝阳区奥林匹克公园(南门)
门牌号	朝阳区阜通东大街6号
单元号	望京西园四区5号楼2单元
道路	北京市朝阳区阜通东大街
道路交叉路口	北四环西路辅路/善缘街
公交站台、地铁站	海淀黄庄站A1西北口
未知	未确认级别的POI

{ "status": "1", "info": "OK", "infocode": "10000", "regeocode": { "formatted_address": "北京市朝阳区望京街道方恒国际中心B座方恒国际", "addressComponent": { "country": "中国", "province": "北京市", "city": [], "citycode": "010", "district": "朝阳区", "adcode": "110105", "township": "望京街道", "towncode": "110105026000", "neighborhood": { "name": "方恒国际中心", "type": "商务住宅;楼宇;商住两用楼宇" }, "building": { "name": "方恒国际中心B座", "type": "商务住宅;楼宇;商务写字楼" }, "streetNumber": { "street": "阜通东大街", "number": "6号", "location": "116.482086,39.990496", "direction": "东", "distance": "51.0778" }, "businessAreas": [ { "location": "116.470293,39.996171", "name": "望京", "id": "110105" }, { "location": "116.494356,39.971563", "name": "酒仙桥", "id": "110105" }, { "location": "116.492891,39.981321", "name": "大山子", "id": "110105" } ] }, "pois": [ { "id": "B000A7HFVV", "name": "方恒国际B座", "type": "商务住宅;楼宇;商务写字楼", "tel": "010-84718888", "direction": "西", "distance": "40.4263", "location": "116.481018,39.990414", "address": "阜通东大街6号", "poiweight": "0.555236", "businessarea": "望京" }, { "id": "B000A83MMC", "name": "方恒国际中心1号楼", "type": "商务住宅;楼宇;商务写字楼", "tel": "010-84718888", "direction": "东北", "distance": "68.6402", "location": "116.481926,39.990982", "address": "阜通东大街6号院1-102", "poiweight": "0.505924", "businessarea": "望京" }, { "id": "B0FFFZDF2D", "name": "方恒国际中心A座", "type": "商务住宅;楼宇;商务写字楼", "tel": "010-84718888;010-84107066", "direction": "西南", "distance": "120.132", "location": "116.480826,39.989510", "address": "望京阜通东大街6号院", "poiweight": "0.323749", "businessarea": "望京" }, { "id": "B0FFKHRN7C", "name": "万科时代中心A座(望京小街)", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "东", "distance": "156.993", "location": "116.483300,39.990207", "address": "望京街9号", "poiweight": "0.307686", "businessarea": "望京" }, { "id": "B000A8W8WG", "name": "万科时代中心·望京", "type": "商务住宅;楼宇;商务写字楼", "tel": "010-59203600", "direction": "东", "distance": "230.384", "location": "116.484121,39.989992", "address": "望京街9号", "poiweight": "0.532723", "businessarea": "望京" }, { "id": "B0FFLHP4F9", "name": "万科时代中心B1座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "东", "distance": "239.212", "location": "116.484239,39.990895", "address": "望京街9号万科时代中心", "poiweight": "0.306886", "businessarea": "望京" }, { "id": "B0FFF39MB1", "name": "悠乐汇B区E座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "西", "distance": "244.928", "location": "116.478740,39.989817", "address": "望京园601号", "poiweight": "0.152389", "businessarea": "望京" }, { "id": "B0FFM13SUU", "name": "万科时代中心·望京E座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "东", "distance": "253.651", "location": "116.484341,39.989812", "address": "望京街9号望京国际商业中心", "poiweight": "0.306905", "businessarea": "望京" }, { "id": "B000A8386B", "name": "悠乐汇D座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "西", "distance": "283.028", "location": "116.478185,39.990192", "address": "望京园602号", "poiweight": "0.480336", "businessarea": "望京" }, { "id": "B0FFFQ6V3I", "name": "联络大厦A座", "type": "商务住宅;楼宇;商务写字楼", "tel": "010-84786158", "direction": "东北", "distance": "304.303", "location": "116.484265,39.992185", "address": "望京街10号院", "poiweight": "0.32746", "businessarea": "望京" }, { "id": "B0FFFAIVNJ", "name": "方恒时代", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "东北", "distance": "325.92", "location": "116.484074,39.992624", "address": "望京阜通东大街和望京街交汇口东北角", "poiweight": "0.32228", "businessarea": "望京" }, { "id": "B000A8W954", "name": "宝能中心B座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "西南", "distance": "306.4", "location": "116.478967,39.988499", "address": "望京阜通东大街12号宝能中心", "poiweight": "0.292616", "businessarea": "望京" }, { "id": "B0FFMFDGSL", "name": "悠乐汇B区C座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "西", "distance": "334.057", "location": "116.477570,39.990581", "address": "望京园603-5号", "poiweight": "0.305106", "businessarea": "望京" }, { "id": "B0FFKHMFKK", "name": "万科时代中心D座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "东", "distance": "349.595", "location": "116.485498,39.989797", "address": "望京东路与望京街交叉口西100米", "poiweight": "0.307676", "businessarea": "望京" }, { "id": "B000A87S6I", "name": "宝能中心", "type": "商务住宅;楼宇;商务写字楼", "tel": "010-84779999", "direction": "西南", "distance": "350.548", "location": "116.478763,39.988102", "address": "望京阜通东大街12号", "poiweight": "0.464987", "businessarea": "望京" }, { "id": "B0FFFLJ5D0", "name": "方恒时代中心B座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "东北", "distance": "350.606", "location": "116.483942,39.992995", "address": "望京街10号", "poiweight": "0.32746", "businessarea": "望京" }, { "id": "B0FFFCRZN9", "name": "悠乐汇A4区", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "西", "distance": "302.078", "location": "116.478302,39.989272", "address": "望京园602号", "poiweight": "0.134653", "businessarea": "望京" }, { "id": "B0FFL46U8C", "name": "万科时代中心·望京C座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "东南", "distance": "139.259", "location": "116.482654,39.989586", "address": "望京小街与阜荣街交叉口东北约140米", "poiweight": "0.307175", "businessarea": "望京" }, { "id": "B0FFHR17JG", "name": "万科时代中心A3座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "东", "distance": "147.736", "location": "116.483108,39.989990", "address": "望京小街与望京街交叉口西南200米", "poiweight": "0.331208", "businessarea": "望京" }, { "id": "B000AA707Y", "name": "悠乐汇A2座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "西南", "distance": "388.148", "location": "116.477484,39.988799", "address": "望京园602号", "poiweight": "0.48", "businessarea": "望京" }, { "id": "B0GRXX9WTX", "name": "万科时代中心F座1区", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "东南", "distance": "155.527", "location": "116.482640,39.989379", "address": "望京街9号", "poiweight": "0.16251", "businessarea": "望京" }, { "id": "B000A9PRMW", "name": "卡特彼勒大厦", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "北", "distance": "366.699", "location": "116.482579,39.993654", "address": "望京街8号", "poiweight": "0.325694", "businessarea": "望京" }, { "id": "B000A8WBT7", "name": "宝能中心A座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "西南", "distance": "375.817", "location": "116.478643,39.987881", "address": "阜通东大街12号", "poiweight": "0.281822", "businessarea": "望京" }, { "id": "B0FFL5C4R0", "name": "VOLKSWAGEN FINANCIAL SERVICES", "type": "商务住宅;楼宇;商务写字楼|公司企业;公司;公司|金融保险服务;金融保险服务机构;金融保险机构", "tel": "010-65897542", "direction": "南", "distance": "316.761", "location": "116.482340,39.987691", "address": "望京街道阜荣街15号院3号楼", "poiweight": "0.307135", "businessarea": "望京" }, { "id": "B000AA0SRW", "name": "奔驰大厦", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "北", "distance": "381.276", "location": "116.481841,39.993882", "address": "望京街8号", "poiweight": "0.325694", "businessarea": "望京" }, { "id": "B0GRHMQCU3", "name": "国际竹藤大厦B座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "西南", "distance": "205.671", "location": "116.480120,39.988940", "address": "阜荣街与阜通东大街交叉口东南约100米", "poiweight": "0.305106", "businessarea": "望京" }, { "id": "B0GRHMPAEH", "name": "国际竹藤大厦C座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "西南", "distance": "213.087", "location": "116.479871,39.989002", "address": "阜荣街与阜通东大街交叉口南约80米", "poiweight": "0.305106", "businessarea": "望京" }, { "id": "B000A87S4U", "name": "悠乐汇A区", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "西", "distance": "388.882", "location": "116.477193,39.989280", "address": "望京园609号", "poiweight": "0.502325", "businessarea": "望京" }, { "id": "B0FFKHMFHT", "name": "万科时代中心F座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "东南", "distance": "222.874", "location": "116.483305,39.989022", "address": "望京东路与阜荣街交叉口北200米", "poiweight": "0.307676", "businessarea": "望京" }, { "id": "B0GRHYP9DW", "name": "国际竹藤大厦A座", "type": "商务住宅;楼宇;商务写字楼", "tel": [], "direction": "西南", "distance": "235.325", "location": "116.479640,39.988891", "address": "阜通东大街8号", "poiweight": "0.305106", "businessarea": "望京" } ], "roads": [ { "id": "010J50F0010203327", "name": "阜通东大街", "direction": "东南", "distance": "61.2781", "location": "116.481,39.9908" }, { "id": "010J50F001020619494", "name": "望京小街", "direction": "西", "distance": "114.321", "location": "116.483,39.99" }, { "id": "010J50F00102014654", "name": "阜荣街", "direction": "东北", "distance": "151.642", "location": "116.481,39.9893" } ], "roadinters": [ { "direction": "东", "distance": "180.733", "location": "116.479567,39.989775", "first_id": "010J50F00102014654", "first_name": "阜荣街", "second_id": "010J50F0010203327", "second_name": "阜通东大街" } ], "aois": [ { "id": "B000A837FH", "name": "方恒国际", "adcode": "110105", "location": "116.482086,39.990496", "area": "50578.472594", "distance": "0", "type": "120203" } ] } }

请求参数

Query 参数

location

string

必需

传入内容规则：经度在前，纬度在后，经纬度间以“,”分割，经纬度小数点后不要超过 6 位。如果需要解析多个经纬度的话，请用"|"进行间隔，并且将 batch 参数设置为 true，最多支持传入 20 对坐标点。每对点坐标之间用"|"分割。

示例值:

116.481488,39.990464

poitype

string

可选

以下内容需要 extensions 参数为 all 时才生效。逆地理编码在进行坐标解析之后不仅可以返回地址描述，也可以返回经纬度附近符合限定要求的POI内容（在 extensions 字段值为 all 时才会返回POI内容）。设置 POI 类型参数相当于为上述操作限定要求。参数仅支持传入POI TYPECODE，可以传入多个POI TYPECODE，相互之间用“|”分隔。该参数在 batch 取值为 true 时不生效。获取 POI TYPECODE 可以参考POI分类码表

示例值:

商务写字楼

radius

string

可选

搜索半径 radius取值范围在0~3000，默认是1000。单位：米

示例值:

1000

extensions

string

可选

返回结果控制 extensions 参数默认取值是 base，也就是返回基本地址信息； extensions 参数取值为 all 时会返回基本地址信息、附近 POI 内容、道路信息以及道路交叉口信息。

示例值:

all

roadlevel

string

可选

道路等级以下内容需要 extensions 参数为 all 时才生效。可选值：0，1 当roadlevel=0时，显示所有道路当roadlevel=1时，过滤非主干道路，仅输出主干道路数据

示例值:

sig

string

可选

数字签名请参考数字签名获取和使用方法

output

string

可选

返回数据格式类型可选输入内容包括：JSON，XML。设置 JSON 返回结果数据将会以JSON结构构成；如果设置 XML 返回结果数据将以 XML 结构构成。

示例值:

JSON

callback

string

可选

回调函数 callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。

homeorcorp

string

可选

是否优化POI返回顺序以下内容需要 extensions 参数为 all 时才生效。 homeorcorp 参数的设置可以影响召回 POI 内容的排序策略，目前提供三个可选参数： 0：不对召回的排序策略进行干扰。 1：综合大数据分析将居家相关的 POI 内容优先返回，即优化返回结果中 pois 字段的poi顺序。 2：综合大数据分析将公司相关的 POI 内容优先返回，即优化返回结果中 pois 字段的poi顺序。

parameters

string

可选

Key

string

必需

用户在高德地图官网申请Web服务API类型Key

默认值:

返回响应

🟢200成功

application/json

Body

status

string

必需

返回结果状态值返回值为 0 或 1，0 表示请求失败；1 表示请求成功。

info

string

必需

返回状态说明，当 status 为 0 时，info 会返回具体错误原因，否则返回“OK”。详情可以参考 info状态表

regeocodes

object

必需

逆地理编码列表 batch 字段设置为 true 时为批量请求，此时 regeocodes 标签返回，标签下为 regeocode 对象列表；batch 为false 时为单个请求，会返回 regeocode 对象；regeocode 对象包含的数据如下：

formatted_address

string

必需

结构化地址信息结构化地址信息包括：省份＋城市＋区县＋城镇＋乡村＋街道＋门牌号码如果坐标点处于海域范围内，则结构化地址信息为：省份＋城市＋区县＋海域信息

addressComponent

object

地址元素列表

必需

roads

object

必需

道路信息列表请求参数 extensions 为 all 时返回如下内容

roadinters

object

必需

道路交叉口列表请求参数 extensions 为 all 时返回如下内容

pois

object

必需

poi信息列表请求参数 extensions 为 all 时返回如下内容

aois

object

必需

aoi信息列表请求参数 extensions 为 all 时返回如下内容

地理编码匹配级别列表#

请求参数

返回响应

地理编码匹配级别列表