产品服务
解决方案
文档与支持
定价
登录

所有文档

全球逆地理编码

逆地理编码智能体
下载开发文档
接口说明

逆地理编码智能体是在逆地理编码将经纬度坐标转换为详细地址信息,帮助用户精准描述坐标位置的基础上,通过与Deepseek AI大模型结合,利用其强大的推理能力,能够根据不同应用场景智能分析,返回最合理的地址描述结果。 同时,新接口简化了原有的参数设计,为开发者提供了更加便捷、易用的调用方式。

API服务地址

https://api.map.baidu.com/reverse_geocoding/agent?location=40.014523,116.3097813&coordtype=bd09ll&demand=我在打车,需要告诉司机我现在的位置&ak=您的ak
//GET请求

请求参数
参数名称参数含义示例类型默认值必选
ak

用户申请注册的key,自v2开始参数修改为“ak”,之前版本参数为“key”申请ak

E4805d16******93a3fe70
string
location根据经纬度坐标获取地址。
40.014523,116.309781
string
coordtype

传入的坐标类型,目前支持的坐标类型
包括:bd09ll(百度经纬度坐标)、
bd09mc(百度米制坐标)、gcj02ll(国
测局经纬度坐标,仅限中国)、wgs84ll
( GPS经纬度)

bd09ll、gcj02ll
stringbd09ll
ret_coordtype

返回的坐标类型,可选参数,添加后返
回国测局经纬度坐标或百度米制坐标

gcj02ll(国测局坐标,仅限中国)、
bd09mc(百度墨卡托坐标)
stringbd09ll
demand

用户的需求描述
(可以加入对场景,偏好等描述,提升
解析的精准度和匹配度,返回更贴合实
际需求的结果)

我在打车,告诉司机我现在的位置;
用附近打卡最多的餐厅描述我的位置;
string
返回参数
返回参数类型备注
statusint本次API访问状态,如果成功返回0,如果失败返回其他数字。(见服务状态码
resultobject返回的结果
locationobject经纬度坐标
lngfloat经度值
latfloat纬度值
addressComponentobject注意,国外行政区划,字段仅代表层级
countrystring国家
adcodeint行政区划代码
provincestring省名
citystring城市名,如果经纬度所在城市是省辖县或者省辖县级市,返回的city结果为空。
districtstring区县名
townstring乡镇名
town_codestring乡镇id
villagestring社区、村 (购买商用授权后可申请开通)
village_codestring社区、村id
streetstring道路名
street_numberstring道路门牌号
directionstring相对当前坐标点的方向,当有门牌号的时候返回数据
distancestring相对当前坐标点的距离,当有门牌号的时候返回数据
business_infoarray商圈信息
namestring商圈名称
locationobject商圈中心点经纬度坐标
lngfloat经度值
latfloat纬度值
distancestring参考位置到输入坐标的直线距离
directionstring参考位置到输入坐标的方位关系,如 北、南、内等
roadsarray道路信息
namestring周边道路名称
distancestring传入的坐标点距离道路的大概距离
directionstring输入点和道路的相对方向
locationstring坐标点
poiRegionsarray归属区域面信息列表
direction_descstring请求中的坐标与所归属区域面的相对位置关系
namestring归属区域面名称
tagstring归属区域面类型
distancestring离坐标点距离
uidstringpoi唯一标识
recommend_reasonstring大模型推荐的原因
recommend_address_poistring大模型推荐的结构化地址(包含POI信息)
poisarray周边poi数组(最多返回10条POI,大模型选择的POI在第一条)
addrstring地址信息
directionstring和当前坐标点的方向
distancestring离坐标点距离
namestringpoi名称
tagstringpoi类型,如’美食;中餐厅’。tag与poiType字段均为poi类型,建议使用tag字段,信息更详细。poi详细类别
pointfloatpoi坐标{x,y}
telstring电话
uidstringpoi唯一标识
服务状态码
返回码定义常见原因
0正常服务请求正常召回
1服务器内部错误该服务响应超时或系统内部错误,请留下联系方式
2参数错误坐标类型错误,location格式错误
10上传内容超过8MPost上传数据不能超过8M
101AK参数不存在请求消息没有携带AK参数
102MCODE参数不存在,mobile类型mcode参数必需对于Mobile类型的应用请求需要携带mcode参数,该错误码代表服务器没有解析到mcode
200APP不存在,AK有误请检查再重试根据请求的AK,找不到对应的APP
201APP被用户自己禁用,请在控制台解禁
202APP被管理员删除恶意APP被管理员删除
203APP类型错误当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone(类型22))及Browser(类型3),除此之外其他类型认为是APP类型错误
210APP IP校验失败在申请SERVER类型应用的时候选择IP校验,需要填写IP白名单,如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败
211APP SN校验失败SERVER类型APP有两种校验方式IP校验和SN校验,当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败
220APP Referer校验失败浏览器类型的APP会校验referer字段是否存且切在referer白名单里面,否则返回该错误码
230APP Mcode码校验失败服务器能解析到mcode,但和数据库中不一致,请携带正确的mcode
240APP 服务被禁用用户在API控制台中创建或设置某APP的时候禁用了某项服务,若需开通权限,可进入API控制台为AK勾选对应服务
250用户不存在根据请求的user_id, 数据库中找不到该用户的信息,请携带正确的user_id
251用户被自己删除该用户处于未激活状态
252用户被管理员删除恶意用户被加入黑名单
260服务不存在服务器解析不到用户请求的服务名称
261服务被禁用该服务已下线,请在控制台确认是否有该服务的权限。
302天配额超限,限制访问配额超限,如果想增加配额请联系我们
401当前并发量已经超过约定并发配额,限制访问并发控制超限,请控制并发量或联系我们

上一篇

全球逆地理编码

下一篇

更新日志

本篇文章对您是否有帮助?