逆地理编码
GET
https://restapi.amap.com/v3/geocode/regeo逆地理编码的响应结果的格式由请求参数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 |
请求参数
传入内容规则:经度在前,纬度在后,经纬度间以“,”分割,经纬度小数点后不要超过 6 位。如果需要解析多个经纬度的话,请用"|"进行间隔,并且将 batch 参数设置为 true,最多支持传入 20 对坐标点。每对点坐标之间用"|"分割。
以下内容需要 extensions 参数为 all 时才生效。 逆地理编码在进行坐标解析之后不仅可以返回地址描述,也可以返回经纬度附近符合限定要求的POI内容(在 extensions 字段值为 all 时才会返回POI内容)。设置 POI 类型参数相当于为上述操作限定要求。参数仅支持传入POI TYPECODE,可以传入多个POI TYPECODE,相互之间用“|”分隔。该参数在 batch 取值为 true 时不生效。获取 POI TYPECODE 可以参考POI分类码表
搜索半径 radius取值范围在0~3000,默认是1000。单位:米
返回结果控制 extensions 参数默认取值是 base,也就是返回基本地址信息; extensions 参数取值为 all 时会返回基本地址信息、附近 POI 内容、道路信息以及道路交叉口信息。
道路等级 以下内容需要 extensions 参数为 all 时才生效。 可选值:0,1 当roadlevel=0时,显示所有道路 当roadlevel=1时,过滤非主干道路,仅输出主干道路数据
数字签名请参考数字签名获取和使用方法
返回数据格式类型 可选输入内容包括:JSON,XML。设置 JSON 返回结果数据将会以JSON结构构成;如果设置 XML 返回结果数据将以 XML 结构构成。
回调函数 callback 值是用户定义的函数名称,此参数只在 output 参数设置为 JSON 时有效。
是否优化POI返回顺序 以下内容需要 extensions 参数为 all 时才生效。 homeorcorp 参数的设置可以影响召回 POI 内容的排序策略,目前提供三个可选参数: 0:不对召回的排序策略进行干扰。 1:综合大数据分析将居家相关的 POI 内容优先返回,即优化返回结果中 pois 字段的poi顺序。 2:综合大数据分析将公司相关的 POI 内容优先返回,即优化返回结果中 pois 字段的poi顺序。
示例代码
返回响应
返回结果状态值 返回值为 0 或 1,0 表示请求失败;1 表示请求成功。
返回状态说明,当 status 为 0 时,info 会返回具体错误原因,否则返回“OK”。详情可以参考 info状态表
逆地理编码列表 batch 字段设置为 true 时为批量请求,此时 regeocodes 标签返回,标签下为 regeocode 对象列表;batch 为false 时为单个请求,会返回 regeocode 对象;regeocode 对象包含的数据如下:
结构化地址信息 结构化地址信息包括:省份+城市+区县+城镇+乡村+街道+门牌号码 如果坐标点处于海域范围内,则结构化地址信息为:省份+城市+区县+海域信息
道路信息列表 请求参数 extensions 为 all 时返回如下内容
道路交叉口列表 请求参数 extensions 为 all 时返回如下内容
poi信息列表 请求参数 extensions 为 all 时返回如下内容
aoi信息列表 请求参数 extensions 为 all 时返回如下内容
{
"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"
}
]
}
}