ak

AK

否

string

用户的访问权限，AK申请

备注：webapi的流量必填

token

token

否

string

备注：sdk的流量必填

sign

sign

否

string

备注：sdk的流量必填

origin

起点坐标

是

string

纬度在前，经度在后，经度和纬度用","分割，经纬度小数点后不得超过6位。

destination

终点坐标

是

string

纬度在前，经度在后，经度和纬度用","分割，经纬度小数点后不得超过6位。

origin_uid

起点 POI 的 UID

否

string

在已知起点POI 的 uid 情况下，请尽量填写uid，将提升路线规划的准确性

备注：我们针对海量POI建设有导航引导点，如果填写了该参数，将引导到更合理的位置，路线也将更加合理。

destination_uid

终点 POI 的 UID

否

string

在已知终点POI 的 uid 情况下，请尽量填写uid，将提升路线规划的准确性

备注：我们针对海量POI建设有导航引导点，如果填写了该参数，将引导到更合理的位置，路线也将更加合理。

waypoints

途经点坐标

否

string

最多支持18个以内的有序途经点。多个途经点坐标按顺序以英文竖线符号分隔，

示例： 40.465,116.314|40.232,116.352|40.121,116.453

coord_type

传入参数的坐标类型

否

string

bd09ll：百度经纬度坐标 [默认值]

bd09mc：百度墨卡托坐标

gcj02：国测局加密坐标）

wgs84：gps设备获取的坐标

ret_coordtype

返回结果坐标类型

否

string

bd09ll：百度经纬度坐标 [默认值]

gcj02：国测局加密坐标

sn

用户的权限签名

否

string

当AK设置为SN校验时，该参数必填SN计算方法

timestamp

时间戳，与SN配合使用

否

int

SN存在时必填

output

返回结果格式类型

否

string

可选值：json

callback

回调函数

否

string

callback 值是用户定义的函数名称，此参数只在 output 参数设置为 JSON 时有效。

car_vendor

车厂

否

string

car_model

车型

否

string

session_id

算路返回的session_id

否

string

示例：{"codr":"20260717R16183677387465CARYQ4T25|0_36.222481,120.140544_22.929628,113.150176_6","loc":"mirror"}@876

备注：api_navigate/v1/route_query 必须传入该参数；session_id 和 mrsl 会在算路的时候返回

mrsl

算路返回的mrsl

否

string

示例：["\"g\":\"6_1\",\"w\":\"AAAA\",\"p\":\"1\",\"label\":\"8\",\"s\":\"0\",\"seq\":\"0\"","\"g\":\"6_1\",\"p\":\"1\",\"label\":\"8\",\"s\":\"0\",\"seq\":\"1\""]

status

状态码

int

0：成功

1：服务内部错误（用户可以重试一次）

2：参数错误

9001：服务错误（用户不需重试）

其他错误码参考：https://lbsyun.baidu.com/faq/api?title=webapi/appendix

message

状态值的说明

string

result

object

限行结果提示

string

1. 若无限行路线，则返回空

2. 若无法规避限行，则返回限行提示信息

返回的路线数量

int

算路返回的session_id

string

调用路线信息查询（route_query）时需要传入该值

起点

object

lat

纬度

double

lng

经度

double

终点

object

lat

纬度

double

lng

经度

double

途经点列表

array

lat

纬度

double

lng

经度

double

路线集合

array

origin

路线的起点

object

destination

路线的终点

object

route_id

路线唯一标识

string

route_md5

路线md5

string

mrsl

mrsl

string

路线信息查询（route_query）时需要传入该值

distance

路线距离

int

单位：米

duration

路线耗时

int

单位：秒

traffic_light

路线上的红绿灯数量

int

taxi_fee

出租车费用

int

单位：元

toll

过路费

int

单位：元

此高速费为预估价格，与实际高速收费并不完全一致

toll_distance

收费路段里程

int

单位：米

tag

路线标签

string

例如：“红绿灯少”、“距离短”、“方案三”

score

路线评分

float

分值越大，路线相对越优。

steps

路线分段数据

array

参考下文中的 “路线分段 step结构”

route_source

智驾友好路线标识

int

0：未命中

1：命中

start_location

step的起点坐标

object

end_location

step的终点坐标

object

leg_index

途经点序号

int

途经点序号为从0开始的整数，用于标识step所属的途经点路段。

如：若该step属于起点至第一个途经点的路段，则其leg_index为0

start_link_index

step起点link索引

int

end_link_index

step终点link索引

int

distance

step的距离信息

int

单位：米

duration

step的耗时

int

单位：秒

road_name

道路名称

string

如“信息路“

若道路未命名或百度地图未采集到该道路名称，则返回"无名路"

instruction

step转向描述

string

road_type

道路类型

int

枚举值：返回0-9之间的值

0：高速路

1：城市高速路

2：国道

3：省道

4：县道

5：乡镇村道

6：其他道路

7：九级路

8：航线(轮渡)

9：行人道路

path

step的坐标点序列

string

多个坐标点之间用';'分隔，单个坐标的经纬度之间用','分隔

traffic_condition

step的路况详情

array

路况指数

int

0： 无路况

1： 畅通

2： 缓行

3： 拥堵

4： 非常拥堵

从当前坐标点开始，path中路况相同的坐标点个数

int

距离，从当前坐标点开始path 中路况相同的距离

float

单位：米

注：单条线路中所有distance的和会与route的distance字段存在差异，不是完全一致

adcodes

step途经的城市编码

string

若途经多个城市，则adcode以英文半角逗号相隔

如：110000,120000

link_num

step包含link个数

int

可以和linkids配合使用，确认当前step包含的linkid序列

direction

进入道路的角度

int

枚举值，返回值在0-11之间的一个值，共12个枚举值，以30度递进，即每个值代表角度范围为30度；其中返回"0"代表345度到15度，以此类推，返回"11"代表315度到345度"；分别代表的含义是：0-[345°-15°]；1-[15°-45°]；2-[45°-75°]；3-[75°-105°]；4-[105°-135°]；5-[135°-165°]；6-[165°-195°]；7-[195°-225°]；8-[225°-255°]；9-[255°-285°]；10-[285°-315°]；11-[315°-345°]

注：角度为与正北方向顺时针夹角

toll

step的过路费

int

单位：元

因一个收费路段可能覆盖多个step，部分情况下费用无法按step准确拆分，故分段step收费可能存在不准确情况

toll_distance

step的收费路段里程

int

单位：米

toll_gate_name

收费站名称

string

只有在进收费站和出收费站时才有

toll_gate_location

收费站位置

object

只有在进收费站和出收费站时才有