origin

是

string

起点坐标

格式为：纬度,经度。如：21.22345,112.11478

origin_bind_strategy

否

int32

起点绑路策略

0:绑定封闭道路，1:不绑定封闭道路；默认0

destination

是

string

终点坐标

格式与起点坐标相同

dest_bind_strategy

否

int32

终点绑路策略

0:绑定封闭道路，1:不绑定封闭道路；默认0

waypoints

否

string

途经点坐标

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

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

coord_type

否

string

输入坐标类型

坐标类型，可选参数，默认为bd09ll

允许的值为：

bd09ll（百度经纬度坐标）

bd09mc（百度墨卡托坐标）

gcj02（国测局加密坐标）

wgs84（gps设备获取的坐标）

ret_coordtype

否

string

输出坐标类型

返回结果坐标类型，默认为bd09ll

允许的值为：

bd09ll（百度经纬度坐标）

gcj02（国测局加密坐标）

height

否

double

车辆高度

单位：米，取值[0, 10.0]，默认1.8，会按照填写数字进行限行规避

width

否

double

车辆宽度

单位：米，取值[0, 10.0]，默认1.9，会按照填写数字进行限行规避

weight

否

double

车辆总重

车辆总重=车辆自身重量+货物重量，单位：吨，取值[0,100]，默认2.5，会按照填写数字进行限行规避

length

否

double

车辆长度

单位：米，取值[0, 25.0]，默认4.2，会按照填写数字进行限行规避

axle_weight

否

double

轴重

单位：吨，取值[0,50]，默认2，会按照填写数字进行限行规避

axle_count

否

int32

轴数

取值[0,50]，默认2，会按照填写数字进行限行规避

is_trailer

否

int32

是否是挂车

0：不是(默认)

1：是

plate_province

否

string

车牌号省份

默认：空字串

plate_number

否

string

车牌号（省份以外号码）

默认：空字串

plate_color

否

int32

车牌颜色

0：蓝色（默认）

1：黄

2：黑

3：白

4：绿

departure_time

否

int32

出发时间

Unix时间戳(秒)，默认为当前时间，支持未来7天内的区间：（now_timestamp - 600, now_timestamp + 7 * 86400）

eta_timestamp

否

int32

ETA时间戳

0：实时ETA

1：静态ETA（历史均值）

未来时间戳：返回未来(历史) ETA （now_timestamp - 600, now_timestamp + 7 * 86400） 其他时间返回参数错误

注：根据departure_time算路，只是返回的duration按次字段规定填充

tactics

否

int32

驾驶策略

0：默认 （时间优先）

1：距离优先

3：少走高速

4：高速优先

5：躲避拥堵

6：少收费

7：经济路线

8：距离优先+少走高速

9：躲避拥堵+少走高速

10：少收费+少走高速

11：躲避拥堵+少收费

12：躲避拥堵+少收费+少走高速

13：躲避拥堵+高速优先

way_tactics

否

int32

途经点算路时各分段算路偏好

0,1...

各偏好间以逗号分隔，枚举值参考tactics字段说明，且个数为 途经点个数+1

如有1个途经点，则需传递2个偏好对应 起点→途经点； 途经点→终点 分段的偏好

alternatives

否

int32

是否返回备选路线

0：返回一条推荐路线 （默认）

1：返回1到3条备选路线

displacement

否

int32

百公里油耗，单位mL

vehicle_usages

否

string

货车用途

如果设置该字段，会根据货车用途进行限行规避

如：0,17

0-默认；17-危险物品

危化物品功能为高级付费服务，需通过反馈平台联系工作人员开通

power_type

否

int32

动力类型

默认汽油

0-所有；1-汽油；2-柴油；3-电动；4-混合

truck_type

否

int32

卡车类型

1-微；2-轻；3-中；4-重；

emission_limit

否

int32

排放标准

取值范围1-6，对应国1-国6标准

load_weight

否

int32

核定载重

单位吨[0,1000]

avoid_type

否

int32

货车政策交规（如交通部门发布的分时段区域限行政策）剥离

0：政策交规默认生效；

1：算路时忽略针对货车的政策交规（道路上实体交通标牌限制仍正常生效）

experience_track

否

string

用户指定经验轨迹

lat,lng,timestamp;lat,lng,timestamp;lat,lng,timestamp .....

轨迹点间英文分号分割

如无时间戳可设置为0，所有轨迹点个数小于2000。坐标类型受参数coord_type约定

如果传递此参数，则必须采用post方式发送Http请求，header中content-type设置为application/x-www-form-urlencoded，并且所有参数放置在body中进行发送

注意：该功能为高级付费功能，需通过反馈平台联系工作人员开通

navigable

否

int64

是否启用导航

设置该参数，可以支持将货车路线规划API算路结果传入货车导航SDK中并调起导航

1: 启用

0: 关闭

默认值为0

disable_ferry

否

int32

是否禁用轮渡

0: 不对轮渡做限制，可以走轮渡。默认

1: 禁用轮渡交通方式，不再考虑轮渡路线

ak

是

string

用户的AK，授权使用

sn

否

string

用户的权限签名，若用户所用AK的校验方式为SN校验时该参数必须。参考：

sn校验说明

status

int32

取值范围：

0：成功

1：服务内部错误

2：参数错误

更多状态码详见附录

message

string

状态码对应的信息

result

kv

返回的结果

kv

车牌限行信息（城市级别）

若一条路线触发多个限行，仅返回其中一个

type

string

可能取值如下：

0：无限行；1：本地车限行；2：外地车限行，3：本地车尾号限行；4：外地车尾号限行；5：其他限行

info

string

限行信息的文字

int32

返回方案的总数

string

路线扩展信息，如session_id，算路时间等，json结构字符串，原样透传

array

返回的方案集

route_id

string

该字段仅用于排查问题，无实际含义

origin

lng

double

起点经度

lat

double

起点纬度

destination

lng

double

终点经度

lat

double

终点纬度

traffic_light_num

int

红绿灯个数

tag

string

方案标签

track_idx

int32

轨迹索引，和输入的多段经验轨迹对应，说明此路线是参考哪个经验轨迹点计算的

-1: 不参考经验轨迹点计算的路线

大于等于0: 和经验轨迹点对应，索引从0开始

unavoid_polygons_idx

string

未规避的避让区域索引，从0开始，如都已规避，则返回空字符串

distance

double

方案距离，单位：米

duration

int32

线路耗时，单位：秒（历史eta）

toll

int32

此路线道路收费，单位：元

注意：该字段为高级付费服务，需通过反馈平台联系工作人员开通

toll_distance

double

收费路段里程，单位：米

注意：该字段为高级付费服务，需通过反馈平台联系工作人员开通

oil_cost

double

油费，单位元

steps

array

路线分段

leg_index

int32

途径点序号，为从0开始的整数，用于标识step所属的途径点路段 如：若该step属于起点至第一个途径中的路段，则其leg_index为0

direction

int32

进入道路的角度。

枚举值，返回值在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°] 注：角度为与正北方向顺时针夹角

distance

double

step的距离信息，单位：米

duration

int32

线路耗时，单位：秒（历史eta）

adcodes

string

经过的城市列表，市级，英文逗号分隔

adcodes_name

string

经过的城市列表，市级，英文逗号分隔(中文)

road_name

string

分段的道路名称

road_type

int32

分段的道路类型 枚举值：返回0-9之间的值

0：高速路

1：城市高速路

2：国道

3：省道

4：县道

5：乡镇村道

6：其他道路

7：九级路

8：航线(轮渡)

9：行人道路

toll_gate_name

string

收费站名称

注意：该字段为高级付费服务，需通过反馈平台联系工作人员开通

toll_gate_location

lng

double

收费站位置：经度

注意：该字段为高级付费服务，需通过反馈平台联系工作人员开通

lat

double

收费站位置：纬度

注意：该字段为高级付费服务，需通过反馈平台联系工作人员开通

start_location

lng

double

分段起点经度

lat

double

分段起点纬度

end_location

lng

double

分段终点经度

lat

double

分段终点纬度

path

string

分段坐标

traffic_condition

array

分段路况详情（填历史路况）

status

int

路况指数

0 无路况数据 1 畅通 2 缓行 3 拥堵 4 严重拥堵

geo_cnt

int

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

注：绘制路况时，指标指向第一个path的第一个点，往后数n个点组成的路段路况是一样的，计数时不算指标所在的点（当前step所有geo_cnt的和为path中的点数减1

distance

double

路况指数

0 无路况数据 1 畅通 2 缓行 3 拥堵 4 严重拥堵距离，从当前坐标点开始path 中路况相同的距离，单位：米

waypoints_toll

array

途径点费用，根据leg_index对应，leg_index值为途径点费用数组索引值