逆地理编码智能体 | 百度地图API SDK

所有文档

全球逆地理编码

服务概览

快速开始

使用准备

接口文档

服务功能

全球逆地理编码逆地理编码智能体

相关资料

更新日志常见问题资源下载使用指南

更新时间: 2026/03/20 16:15

逆地理编码智能体

下载开发文档

前往示例中心在线体验

接口说明

逆地理编码智能体是在逆地理编码将经纬度坐标转换为详细地址信息，帮助用户精准描述坐标位置的基础上，通过与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	string	bd09ll	否
ret_coordtype	返回的坐标类型，可选参数，添加后返回国测局经纬度坐标或百度米制坐标	gcj02ll（国测局坐标，仅限中国）、 bd09mc（百度墨卡托坐标）	string	bd09ll	否
demand	用户的需求描述（可以加入对场景，偏好等描述，提升解析的精准度和匹配度，返回更贴合实际需求的结果）	我在打车，告诉司机我现在的位置；用附近打卡最多的餐厅描述我的位置；	string	无	是

返回参数

返回参数				类型	备注
返回参数	返回参数1	返回参数2	返回参数3	类型	备注
status				int	本次API访问状态，如果成功返回0，如果失败返回其他数字。（见服务状态码）
result				object	返回的结果
	location			object	经纬度坐标
		lng		float	经度值
		lat		float	纬度值
	addressComponent			object	注意，国外行政区划，字段仅代表层级
		country		string	国家
		adcode		int	行政区划代码
		province		string	省名
		city		string	城市名，如果经纬度所在城市是省辖县或者省辖县级市，返回的city结果为空。
		district		string	区县名
		town		string	乡镇名
		town_code		string	乡镇id
		village		string	社区、村 (购买商用授权后可申请开通)
		village_code		string	社区、村id
		street		string	道路名
		street_number		string	道路门牌号
		direction		string	相对当前坐标点的方向，当有门牌号的时候返回数据
		distance		string	相对当前坐标点的距离，当有门牌号的时候返回数据
	business_info			array	商圈信息
		name		string	商圈名称
		location		object	商圈中心点经纬度坐标
			lng	float	经度值
			lat	float	纬度值
		distance		string	参考位置到输入坐标的直线距离
		direction		string	参考位置到输入坐标的方位关系，如北、南、内等
	roads			array	道路信息
		name		string	周边道路名称
		distance		string	传入的坐标点距离道路的大概距离
		direction		string	输入点和道路的相对方向
		location		string	坐标点
	poiRegions			array	归属区域面信息列表
		direction_desc		string	请求中的坐标与所归属区域面的相对位置关系
		name		string	归属区域面名称
		tag		string	归属区域面类型
		distance		string	离坐标点距离
		uid		string	poi唯一标识
	recommend_reason			string	大模型推荐的原因
	recommend_address_poi			string	大模型推荐的结构化地址（包含POI信息）
	pois			array	周边poi数组（最多返回10条POI，大模型选择的POI在第一条）
		addr		string	地址信息
		direction		string	和当前坐标点的方向
		distance		string	离坐标点距离
		name		string	poi名称
		tag		string	poi类型，如’美食;中餐厅’。tag与poiType字段均为poi类型，建议使用tag字段，信息更详细。poi详细类别
		point		float	poi坐标{x,y}
		tel		string	电话
		uid		string	poi唯一标识

服务状态码

返回码	定义	常见原因
返回码	定义	常见原因
0	正常	服务请求正常召回
1	服务器内部错误	该服务响应超时或系统内部错误，请留下联系方式
2	参数错误	坐标类型错误，location格式错误
10	上传内容超过8M	Post上传数据不能超过8M
101	AK参数不存在	请求消息没有携带AK参数
102	MCODE参数不存在，mobile类型mcode参数必需	对于Mobile类型的应用请求需要携带mcode参数，该错误码代表服务器没有解析到mcode
200	APP不存在，AK有误请检查再重试	根据请求的AK，找不到对应的APP
201	APP被用户自己禁用，请在控制台解禁
202	APP被管理员删除	恶意APP被管理员删除
203	APP类型错误	当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone（类型22））及Browser（类型3），除此之外其他类型认为是APP类型错误
210	APP IP校验失败	在申请SERVER类型应用的时候选择IP校验，需要填写IP白名单，如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败
211	APP SN校验失败	SERVER类型APP有两种校验方式IP校验和SN校验，当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败
220	APP Referer校验失败	浏览器类型的APP会校验referer字段是否存且切在referer白名单里面，否则返回该错误码
230	APP Mcode码校验失败	服务器能解析到mcode，但和数据库中不一致，请携带正确的mcode
240	APP 服务被禁用	用户在API控制台中创建或设置某APP的时候禁用了某项服务，若需开通权限，可进入API控制台为AK勾选对应服务
250	用户不存在	根据请求的user_id, 数据库中找不到该用户的信息，请携带正确的user_id
251	用户被自己删除	该用户处于未激活状态
252	用户被管理员删除	恶意用户被加入黑名单
260	服务不存在	服务器解析不到用户请求的服务名称
261	服务被禁用	该服务已下线，请在控制台确认是否有该服务的权限。
302	天配额超限，限制访问	配额超限，如果想增加配额请联系我们
401	当前并发量已经超过约定并发配额，限制访问	并发控制超限，请控制并发量或联系我们

全球逆地理编码

更新日志

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