百度地图 API

使用准备

服务状态码

地点

地点检索及联想

地理编码

全球逆地理编码

坐标转换

地址解析聚合

城乡类型判别

时区

推荐上车点

路线

服务概览

轻量级路线规划

GET

骑行路线规划

GET

步行路线规划

GET

公交路线规划

GET

货车路线规划

GET

批量算路

物流路⽹计算

地理编码开发中

GET/geocoding/v3/?address=北京市海淀区上地十街10号&ak=&city=北京市&ret_coordtype=gcj02ll&sn=&output=json&callback=showLocation&extension_analys_level=1

创建时间: 2025-06-02 21:09

请求参数

Query 参数

参数名	示例值	是否必填	参数类型	描述说明
address	北京市海淀区上地十街10号	是	string	待解析的地址。最多支持128个字节。可以输入两种样式的值，分别是：1、标准的结构化地址信息，如北京市海淀区上地十街十号【推荐，地址结构越完整，解析精度越高】2、支持“路与路交叉口”描述方式，如北一环路和阜阳路的交叉路口
ak		是	string	用户申请注册的key，自v2开始参数修改为“ak”，之前版本参数为“key”
city	北京市	是	string	地址所在的城市名。用于指定上述地址所在的城市，当多个城市都有上述地址时，该参数起到过滤作用，但不限制坐标召回城市。
ret_coordtype	gcj02ll	是	string	返回的坐标类型，可选参数，添加后返回国测局经纬度坐标或百度米制坐标
sn		是	string	若用户所用ak的校验方式为sn校验时该参数必须
output	json	是	string	输出格式为json或者xml
callback	showLocation	是	string	将json格式的返回值通过callback函数返回以实现jsonp功能
extension_analys_level	1	是	string	是否触发解析到最小地址结构功能

响应示例

成功响应

HTTP状态码：500

内容格式：application/json

数据结构

statusinteger

可选

本次API访问状态，如果成功返回0，如果失败返回其他数字。

resultobject

可选

locationobject

可选

preciseinteger

可选

位置的附加信息，是否精确查找。1为精确查找，即准确打点；0为不精确，即模糊打点。

confidenceinteger

可选

描述打点绝对精度（即坐标点的误差范围）。

comprehensioninteger

可选

描述地址理解程度。分值范围0-100，分值越大，服务对地址理解程度越高

levelstring

可选

可以打点到地址文本中的真实地址结构

analys_levelstring

可选

可以解析地址文本中的最小地址结构

响应示例

{
    "status": 0,
    "result": {
      "location": {
        "lng": 116.30762232672,
        "lat": 40.056828485961
      },
      "precise": 1,
      "confidence": 80,
      "comprehension": 100,
      "level": "门址"
    }
  }

最后更新: -

GET地点输入提示

服务概览