百度地图开放平台
更新时间: 2026/11/02 10:46
小客车标准导航 - 行中导航
接口说明

如果算完路后,还需要调用行中刷新、行中偏航、行中切换路线等接口做行中导航,需在行前算路时指定 state=0。指定该值后,服务端会保存和维护整个导航过程中的session状态。
如果要使用行中导航的功能,则所有请求(包括行前算路)必须都传入 state 参数,否则服务端不会保存路线信息。

使用说明

该功能为高级子功能,需要开通高级权限后方可使用。
如果您已开通了该功能,可使用返回的 route_id 继续调用「小客车标准导航 - 行中刷新 / 行中偏航 / 行中切换路线」接口。

API服务地址

https://api.map.baidu.com/api_navigate/v1/route_plan?origin=40.01116,116.339303&destination=39.936404,116.452562&state=0&ak=您的AK
//GET请求

行中导航需在每次请求中传入 state:行前算路(route_plan)传 0,行中刷新(route_refresh)传 1,行中偏航(yaw)传 2,行中切换路线(route_switch)传 3 或 4。
请求参数
参数名称参数含义字段类型必选备注

state

请求类型

如果算完路后,还需要调用其他API做行中导航。需指定该值为0。指定该值后,服务端会保存和维护整个导航过程中的session状态。

取值:

0:行前算路

1:行中刷新

2:行中偏航

3:行中切换路线

4:行中切换路线,不下发诱导(如果客户端已经拉取过诱导,司机又来回切换路线的话,需要调用state=4;目前服务端会记录切换路线的行为,后续服务端也可能做改动;建议跟百度地图app保持一样的调用逻辑)

传参说明:

1. 初始算路时(用户首次开始路线规划,未开始导航):传state=0,百度会下发多条路线

2. 导航过程中,分两种情况:(1)每两分钟请求一次state=1 刷新路况、ETA;(2)如果判断用户发生偏航,立即发起一次state=2 偏航算路请求

备注:

如果要使用行中算路的功能(刷新路况、偏航算路),则所有请求(包括首次起点算路),必须都传入state参数,否则服务端不会保存路线信息,将无法使用行中算路的功能。

用户需保证仅车机导航场景的算路,才传入state参数,其他使用场景不要传入state参数,否则将占用百度的存储空间。

state=1 如果添加了 alternatives=1 时可以下发多条路线:

• 如果设置ext_info & 0x20 != 0,备选路线会下发全量诱导数据;端上如果要切换路线,则调用一次state=4。异常处理:API返回结果中使用 has_guidance 字段标识路线是否已经有诱导数据;如果发现该字段为false,端上可以调用state=3重新拉取一下这条路线的诱导数据。

• 如果设置ext_info & 0x20 == 0,备选路线不会下发诱导数据;端上如果要切换路线,则通过调用state=3拉取诱导并切换路线。

【注】state=1 和 state=2 如果异常(例如:传入的route_id已经失效),API会走重新算路的逻辑;state=3/4 如果有异常,直接返回错误码。

【诱导数据下发情况】

• state=0:如果传入 extensions=guidance 就会下发所有路线的全量诱导数据。

• state=1:1)所有路线都没有发生变化 或者 主路线没变而备选路线发生变化:需同时满足 ext_info & 0x20 > 0、这条路线没有制作过诱导数据或route_id不在传入参数cur_routes列表中、传入参数extensions=guidance,才会下发这条路线的诱导数据;2)主路线发生变化:如果服务返回的 api_restype==2,主路线默认下发诱导,备选路线诱导下发逻辑同1);如果 api_restype 是其他值,服务会走state=0的逻辑。

• state=2 偏航算路:如果传入 extensions=guidance 就会下发所有路线的全量诱导数据。

• state=3 切换路线:服务只下发这条路线以及它的诱导数据。

int

否

注:该功能为高级子功能,需通过工单联系工作人员开通

route_id

路线id

行前算路会返回每条路线的route_id,行中的请求需要传入该字段。

刷新和偏航:传司机端当前的路线;

切换路线:传目标路线的route_id

string

否

返回参数
返回参数含义类型备注

routes

路线集合

array

route_id

路线唯一标识

string

行中请求需要传入该值:刷新和偏航传司机端当前的路线,切换路线传目标路线的route_id

如您需要使用行中导航,请点击工单联系工作人员开通。

上一篇

扩展数据下发

下一篇

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