高德地图 API
  1. 地理/逆地理编码
高德地图 API
  • 概述
  • 入门指南
  • 开发指南
    • 获取Key
    • 错误码说明
    • 流量限制说明
    • 天气对照表
    • 更新日志
    • 相关下载
    • 路径规划
      • 概述
      • 步行路径规划
      • 公交路径规划
      • 骑行路径规划
      • 驾车路径规划
      • 未来路径规划
      • 距离测量
    • 路径规划2.0
      • 概述
      • 驾车路线规划
      • 步行路线规划
      • 骑行路线规划
      • 电动车路线规划
      • 公交路线规划
    • 行政区域查询
      • 概述
      • 行政区域查询
    • 地理/逆地理编码
      • 地理编码
        GET
      • 逆地理编码
        GET
    • 搜索POI
      • 概述
      • 关键字搜索
      • 周边搜索
      • 多边形搜索
      • ID查询
      • AOI边界查询
    • 搜索POI 2.0
      • 概述
      • 关键字搜索
      • 周边搜索
      • 多边形区域搜索
      • ID搜索
    • 交通事件
      • 概述
      • 交通事件查询
    • IP定位
      • 概述
      • IP定位
    • 静态地图
      • 概述
      • 请求参数及用法
    • 坐标转换
      • 概述
      • 坐标转换
    • 天气查询
      • 概述
      • 天气查询
    • 输入提示
      • 概述
      • 输入提示
    • 交通态势
      • 概述
      • 矩形区域交通态势
      • 圆形区域交通态势
      • 指定线路交通态势
    • 轨迹纠偏
      • 概述
      • 轨迹纠偏
    • 三方数据空间检索接口
      • 概述
      • 关键字搜索
      • 多边形搜索
      • 周边搜索
      • 属性筛选
  1. 地理/逆地理编码

地理编码

GET
https://restapi.amap.com/v3/geocode/geo

产品介绍#

地理编码/逆地理编码 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是用户请求数据的身份标识,详细可以参考上方的请求参数说明。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://restapi.amap.com/v3/geocode/geo?address=北京市朝阳区阜通东大街6号&Key='
响应示例响应示例
{
    "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": "门牌号"
        }
    ]
}

请求参数

Query 参数

返回响应

🟢200成功
application/json
Body

【高德地图】API开发者 微信交流群

用微信扫右侧二维码,加入【高德地图】API开发者 交流群,互助沟通

扫码加入交流群
修改于 2022-12-13 06:32:46
上一页
行政区域查询
下一页
逆地理编码
Built with