同步对话 | AI向导 | 百度地图开放平台文档中心

所有文档

AI向导

快速开始

使用准备

接口文档

服务功能

同步对话流式对话 OpenAI协议格式 A2A协议格式

相关资料

更新日志

服务概览

更新时间: 2026/09/10 15:04

同步对话

API服务地址

https://api.map.baidu.com/api_aic/v1/search
// POST请求 Content-Type: application/x-www-form-urlencoded

同步接口需要等待大模型返回完整回答后再一次性给出结果，耗时随询问内容浮动，普遍在 4s–7s。

调用本服务前请先申请「AI向导高级权限」，否则会返回高级权限校验失败。

导航方式优先级

优先识别 query 意图。例如「开车去xxx」会返回驾车导航。
意图不明显时（例如「去颐和园的路线」），若 cuid 属于百度地图用户且在 App 端设置过驾车导航偏好，则优先使用偏好。
若 cuid 不属于百度地图用户，默认使用驾车导航。

请求参数

参数名称	含义	类型	是否必填	说明
参数名称	含义	类型	是否必填	说明
id	调用方唯一 ID，长度不超过 200	string	是	建议使用设备 ID 或用户唯一标识
query	对话文本，长度不超过 200	string	是	普通对话如「帮我介绍一下颐和园」；地点推荐如「推荐几个天安门附近的火锅店」；路线规划如「帮我规划一条开车去天安门的路线」
loc_lng	当前位置经度	string	是
loc_lat	当前位置纬度	string	是
coord_type	输入坐标类型	string	否	可选值：bd09ll（百度经纬度，默认）、bd09mc（百度墨卡托）、gcj02（国测局加密坐标）、wgs84（GPS 坐标）
ret_coord_type	输出坐标类型	string	否	可选值：bd09ll（默认）、gcj02
ak	访问密钥	string	是	在百度地图开放平台创建应用后获取
reset_context	是否重置上下文。0 不重置，1 重置	int	否	开通多轮对话权限时默认开启上下文，reset_context 默认为 0。未开通时固定单轮，该参数无效。上下文默认保留最近五轮，超出后滚动丢弃最旧对话。为保证多轮效果，新一轮对话的第一次请求建议将 reset_context 设为 1
advanced_mode	是否开启智能出游。0 否，1 是	string	否	需要开通高级权限
direction	方位角	float	否	问山问水功能使用。正北为 0°，顺时针，例如 90° 为正东，180° 为正南
text_stream	文本是否流式返回。0 否，1 是	int	否	默认 0，需搭配流式接口
force_model	强制出游场景使用的大模型类型	string	否	ds：deepseek 模型
selected_model	强制出游场景使用的大模型版本	string	否	deepseek_r1：deepseek 模型 R1 版本
extra_pois	query-poi 改写	string	否	JSON 数组，例如 [{"poi_uid":"","poi_name":"故宫","poi_x":"116.280592","poi_y":"40.004567","coord_type":"bd09ll"}]。传入后，「开车去故宫」会按指定坐标算路。多轮对话时若未持续携带，可能被上下文影响
block_bus_taxis	是否屏蔽公共交通中的打车路线。0 否，1 是	int	否	默认 0
multi_route	是否返回多交通路线。0 否，1 是	int	否	默认 0。启用后算路返回多交通方式回答：gptmodel_future_multi_route（未来出行）、gptmodel_navigate_multi_route（普通算路）

请求示例：


{
    "query": "故宫附近的美食",
    "id": "39CC3177**74AF556B|VYFRRMJLG",
    "loc_lng": 116.30157634933593,
    "loc_lat": 40.0502618943843,
    "coord_type": "gcj02",
    "ret_coord_type": "gcj02",
    "ak": "您的密钥",
    "reset_context": 1
}

返回参数

参数名称	类型	含义	是否必定返回	说明
参数名称	类型	含义	是否必定返回	说明
session_id	string	对话 session_id	是
dialogue_id	string	对话 ID	是
query	string	对话文本	是
answer_type	string	回答类别	是	见下方枚举说明
conversation	array	对话流	否	answer_type = gptmodel_flow 时返回
poi_data	object	地点检索数据	否	answer_type = gptmodel_poi 时返回
navigation_data	object	导航数据	否	answer_type = gptmodel_navigate 时返回
poi_clarify_data	object	POI 澄清数据	否	answer_type = gptmodel_poi_clarify 时返回
onwaysearch_clarify_data	object	沿途搜 POI 数据	否	answer_type = gptmodel_onway_search_clarify 时返回
travel_data	object	出游规划数据	否	answer_type = gptmodel_travel 时返回
future_data	object	未来出行数据	否	answer_type = gptmodel_future 时返回
multi_route_data	object	多路线数据	否	answer_type 为多交通方式时返回

answer_type 枚举

取值	说明
取值	说明
gptmodel_flow	对话流，返回 conversation
gptmodel_poi	地点推荐，返回 poi_data
gptmodel_navigate	地图导航，返回 navigation_data，type 为 drive / bike / walk / public
gptmodel_travel	出游规划，返回 travel_data，需开通高级权限
gptmodel_future	未来出行，返回 future_data
gptmodel_poi_clarify	普通 POI 澄清（起终点不明确）
gptmodel_onway_search_clarify	沿途搜澄清（判断有沿途搜意图，澄清途经点）
gptmodel_navigate_multi_route	普通算路的多交通方式回答
gptmodel_future_multi_route	未来出行的多交通方式回答

各 answer_type 的详细字段与示例见「流式对话」。同步接口与流式接口的业务数据结构保持一致。

服务状态码

返回码	定义	英文描述	常见原因
返回码	定义	英文描述	常见原因
-2	内部错误		如路线计算还原失败等内部异常
-1	参数错误		必填参数缺失，或参数值超出校验范围
0	正常	ok	服务请求成功
1	服务器内部错误		服务响应超时或系统内部错误
2	请求参数非法	Parameter Invalid	必要参数拼写错误或漏传
3	权限校验失败	Verify Failure	权限校验未通过
4	配额校验失败	Quota Failure	当日调用次数已超限，请前往配额控制台提升额度
5	ak不存在或者非法	AK Failure	未传入 ak，或 ak 已被删除
8	数据解析失败	Parse Proto Failure	一般为 query 输入有误，如特殊字符、全角符号
9	高级权限校验失败	Permission Denied	未开通 AI向导高级权限
101	AK参数不存在		请求未携带 AK 参数
200	APP不存在，AK有误请检查再重试		根据请求的 ak 找不到对应 APP
201	APP被用户自己禁用，请在控制台解禁
202	APP被管理员删除		恶意 APP 被管理员删除
203	APP类型错误		当前控制台支持 Server / Mobile / Browser 类型
210	APP IP校验失败		SERVER 类型勾选 IP 校验时，请求 IP 不在白名单
211	APP SN校验失败		请求 SN 与服务端计算值不一致
240	APP 服务被禁用		请在 API 控制台为该 AK 勾选对应服务
250	用户不存在		根据 user_id 找不到用户信息
251	用户被自己删除		该用户处于未激活状态
252	用户被管理员删除		恶意用户被加入黑名单
260	服务不存在		服务器解析不到请求的服务名称
261	服务被禁用		该服务已下线
302	天配额超限，限制访问		配额超限，如需提升请联系我们
401	当前并发量已经超过约定并发配额，限制访问		请控制并发量或联系我们提升配额

配额与 AK 管理请前往：API控制台、配额管理。

使用准备

流式对话

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

API服务地址