地理编码

产品介绍

地理编码/逆地理编码 API 是通过 HTTP/HTTPS 协议访问远程服务的接口，提供结构化地址与经纬度之间的相互转化的能力。

结构化地址的定义：首先，地址肯定是一串字符，内含国家、省份、城市、区县、城镇、乡村、街道、门牌号码、屋邨、大厦等建筑物名称。按照由大区域名称到小区域名称组合在一起的字符。一个有效的地址应该是独一无二的。注意：针对大陆、港、澳地区的地理编码转换时可以将国家信息选择性的忽略，但省、市、城镇等级别的地址构成是不能忽略的。暂时不支持返回台湾省的详细地址信息。

使用 API 前请您先注册高德账号申请Key。

适用场景

地理编码：将详细的结构化地址转换为高德经纬度坐标。且支持对地标性名胜景区、建筑物名称解析为高德经纬度坐标。
结构化地址举例：北京市朝阳区阜通东大街6号转换后经纬度：116.480881,39.989410
地标性建筑举例：天安门转换后经纬度：116.397499,39.908722

逆地理编码：将经纬度转换为详细结构化的地址，且返回附近周边的POI、AOI信息。
例如：116.480881,39.989410 转换地址描述后：北京市朝阳区阜通东大街6号

使用限制

详细的服务调用量限制可点我查阅。

使用说明

第一步，申请Web服务API类型Key；

第二步，参考接口参数文档发起HTTP/HTTPS请求，第一步申请的 Key 需作为必填参数一同发送；

第三步，接收请求返回的数据（JSON或XML格式），参考返回参数文档解析数据。

如无特殊声明，接口的输入参数和输出数据编码全部统一为 UTF-8 编码方式。

返回结果参数说明
响应结果的格式可以通过请求参数 output 指定，默认为 JSON 形式。

服务示例

https://restapi.amap.com/v3/geocode/geo?address=北京市朝阳区阜通东大街6号&output=XML&key=<用户的key>

参数	值	备注	必选
address		填写结构化地址信息:省份＋城市＋区县＋城镇＋乡村＋街道＋门牌号码	是
city		查询城市，可选：城市中文、中文全拼、citycode、adcode	否

示例说明：address 是需要获取坐标的结构化地址，output（XML）用于指定返回数据的格式，Key是用户请求数据的身份标识，详细可以参考上方的请求参数说明。

curl --location 'https://restapi.amap.com/v3/geocode/geo?address=%E5%8C%97%E4%BA%AC%E5%B8%82%E6%9C%9D%E9%98%B3%E5%8C%BA%E9%98%9C%E9%80%9A%E4%B8%9C%E5%A4%A7%E8%A1%976%E5%8F%B7&city=%E5%8C%97%E4%BA%AC&sig=&output=JSON&callback=&key=%3Capi-key%3E'

{ "status": "1", "info": "OK", "infocode": "10000", "count": "1", "geocodes": [ { "formatted_address": "北京市朝阳区阜通东大街6号", "country": "中国", "province": "北京市", "citycode": "010", "city": "北京市", "district": "朝阳区", "township": [], "neighborhood": { "name": [], "type": [] }, "building": { "name": [], "type": [] }, "adcode": "110105", "street": "阜通东大街", "number": "6号", "location": "116.482086,39.990496", "level": "门牌号" } ] }

产品介绍#

适用场景#

使用限制#

使用说明#

请求参数

返回响应

产品介绍

适用场景

使用限制

使用说明