ak

用户的访问权限，AK申请

string

必填

origin

起点经纬度，小数点后不超过6位，40.056878,116.30815

string

必填

起点经纬度，格式为：纬度,经度；小数点后不超过6位，40.056878,116.30815

destination

终点经纬度，小数点后不超过6位，40.056878,116.30815

string

必填

终点经纬度，格式为：纬度,经度；小数点后不超过6位，40.056878,116.30815

origin_uid

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

使用地点检索服务获取uid

使用地点输入提示服务获取uid)

string

选填

destination_uid

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

使用地点检索服务获取uid

使用地点输入提示服务获取uid

string

选填

waypoints

途径点坐标串，支持18个以内的有序途径点。多个途径点坐标按顺序以英文竖线符号分隔，示例： 40.465,116.314|40.232,116.352|40.121,116.453

string

选填

coord_type

坐标类型，可选参数，默认为bd09ll。允许的值为：bd09ll（百度经纬度坐标）、bd09mc（百度墨卡托坐标）、gcj02（国测局加密坐标）、wgs84（gps设备获取的坐标）。

string

选填

默认bd09II

ret_coordtype

返回结果坐标类型，默认为bd09ll，允许的值为：bd09ll（百度经纬度坐标）、gcj02（国测局加密坐标）

string

选填

默认bd09II

tactics

0：默认

2：距离最短（只返回一条路线，不考虑限行和路况，距离最短且稳定，用于估价场景）

3：不走高速

4：高速优先

5：躲避拥堵

6：少收费

7: 躲避拥堵 & 高速优先

8: 躲避拥堵 & 不走高速

9: 躲避拥堵 & 少收费

10: 躲避拥堵 & 不走高速 & 少收费

11: 不走高速 & 少收费

12: 距离优先（考虑限行和路况，距离相对短且不一定稳定）

13：时间优先

int

选填

默认0:默认策略

alternatives

是否返回备选路线

类型：string

可选值：

0：返回一条推荐路线

1：返回1-3条路线供选择

int

选填

默认0

cartype

车辆类型，区分车辆是普通燃油车或纯电动汽车。由于部分城市对燃油车和电动车限行规则有差异，该字段用于结合plate_number车牌号来规避限行。例如：纯电动汽车在北京本地无尾号限行，而燃油车需遵守尾号限行。

可选值：

0：普通汽车

1：纯电动汽车

int

选填

默认0

plate_number

车牌号，如 京A00022

用于规避车牌号限行路段。

1、若有规避限行区域的可选路线，则返回规避后的路线，不会返回限行路线

2、若无规避限行的可选路线（如：起终点在限行区域内，或所有符合偏好的路线都无法规避限行区域），则返回限行路线中最优路线，并在返回字段 restriction 中提示用户路段被限行

string

选填

不填则不做规避

departure_time

设置出发时间（支持未来7天），UNIX时间戳。

该字段将影响duration字段的返回，用于返回未来驾车路线耗时。取值范围：当前时间之后7天*24小时内任意时刻（超出时间范围将预估路线）

若设置该参数，则路线规划服务将依据设定时间预测路况和限行规则，并据此计算路线和耗时。详细说明

string

选填

默认为当前时间

注意：该功能为高级付费服务，需通过工单联系工作人员开通

ext_departure_time

更多出发时间，UNIX时间戳。

该字段将影响ext_duration字段的返回，用于返回驾车路线历史耗时（路线在指定出发时间的耗时）。目前支持输入过去7天内一个或多个出发时间戳（不超过12个），多个时间戳之间用","英文半角逗号隔开。示例： ext_departure_time=1526527619

ext_departure_time=1526527619,1526525384,1526523654

注：目前出发时间仅影响ext_duration字段，还不会影响路线计算和选择。即仍按照现在的路况计算并推荐路线，但将增加返回该路线在其他时间的耗时。详细说明

string

选填

不填则不返回ext_duration字段

注意：该功能为高级付费服务，需通过工单联系工作人员开通

expect_arrival_time

预期的到达时间，UNIX时间戳。

该字段将影响suggest_departure_time字段的返回，用于返回建议出发时间。取值范围：当前时间之后15分钟的任意时刻（小于这个时间则不做处理）

若设置此参数，则路线规划服务将依据设定时间计算路线和耗时，并给出建议出发时间

若算出的suggest_departure_time小于当前时间，则设置suggest_departure_time为-1。详细说明

string

选填

不填则不返回ext_duration字段

注意：该功能为高级付费服务，需通过工单联系工作人员开通

gps_direction

起点的车头方向。 字段类型：int64 取值范围：0-359

int

选填

车头方向为与正北方向顺时针夹角，该参数用于辅助判断起点所在正逆向车道，提高算路准确率。 当speed大于1.5米/秒且gps_direction存在时，采用该方向。gps_direction并不代表需填写从gps获取的方向，可以填入校正后的方向。请填写尽量准确的方向，其准确性很大程度决定了计算的精度。

radius

起点的定位精度，字段类型：float，取值范围[0,2000]

float

选填

配合gps_direction字段使用

speed

起点车辆的行驶速度，字段类型：float

float

选填

单位：米/秒，配合gps_direction字段使用，当speed大于1.5米/秒且gps_direction存在时，采用gps_direction的方向。

output

表示输出类型，可设置为xml或json

string

选填

默认为json

sn

用户的权限签名，当AK设置为SN校验时，该参数必填SN计算方法

string

选填

timestamp

时间戳，与SN配合使用

int64

SN存在时必填

callback

回调函数

string

选填

仅在output=json时，该参数有效

intelligent_plan

传入多个途经点，综合考虑路况、交规限行、 途经点的相对位置以及路线整体的绕路成本等，支持智能调整途经点顺序，给出最优路线。可选值：

0（默认值）：不执行途经点智能规划

1：执行途经点智能规划。详细说明

int

选填

默认0：不执行途经点智能规划

注意：该功能为高级付费服务，需通过工单联系工作人员开通

walkinfo

起终点步导路线

int

选填

1 表示下发起终点步导路线；

0 不下发起终点步导路线；

默认值为0

steps_info

是否下发step详情

1：下发step详情

0：不下发step详情

int

选填

origin_bind_stategy

起点绑路策略

0-起点绑路不剔除封闭道路

1-起点绑路剔除封闭道路

int

选填

默认值0

dest_bind_stategy

终点绑路策略

0-终点绑路不剔除封闭道路

1-终点绑路剔除封闭道路

int

选填

默认值0

origin_road_type

起点道路类型，

0 普通道路[默认。绑路策略不参考此入参]；

1高架上；2高架下；3主路；4辅路；(高速和匝道切换其实相当于主辅路切换)

int

选填

默认值0

status

状态码

int

0：成功

1：服务内部错误

2：参数无效

7：无返回结果

message

状态码对应的信息

string

type

默认返回2，开发者无需关注

int

result

返回的结果

限行结果提示信息

若无限行路线，则返回空

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

string

返回方案的总数

int

返回的方案集

若请求参数设置了符合规则的departure_time，则按照设定时间的预测路况和限行规则计算路线。

若未设置departure_time，则按照当前时刻的路况和限行规则计算路线

restriction_info

status

限行状态

int

取值范围【0,3】 0:无限行 1:已规避限行， 路线合法 2:无法规避限 行，路线非法 3：疫情相关的信息

desc

限行提示语

string

当限行status为1或 2时，会有相应的 限行描述信息。 若该路线有多条 提示信息，则以 英文竖线分隔符 分隔，如: "已为您避开北京 限行区域" "无法为您避开北 京限行区域，请 合理安排出行" "起点在北京限行 区域，请合理安 排出行" "终点在北京限行 区域，请合理安 排出行" "起点在北京限行 区域，请合理安 排出行|终点在北 京限行区域，请 合理安排出行"

origin

lng

起点经度

double

lat

起点纬度

double

destination

lng

终点经度

double

lat

终点纬度

double

tag

方案标签

string

traffic_light

红绿灯数量

int

route_id

如无特殊需要，开发者无需关注

string

distance

方案距离，单位：米

int

duration

未来驾车路线耗时，单位：秒

int

若请求参数设置了符合规则的departure_time，则按照设定出发时间的预测路况计算路线耗时。

若未设置departure_time，则按照当前时刻的路况计算路线耗时

注意：该功能为高级付费服务，需通过工单联系工作人员开通

ext_duration

驾车路线历史耗时（扩展），单位：秒

int

若设置了请求参数ext_departure_time，则返回该字段；

若ext_departure_time设置了一个或多个出发时间则以英文半角逗号","分隔返回多个扩展耗时；

若扩展耗时计算失败，则返回-1。

注意：该功能为高级付费服务，需通过工单联系工作人员开通

suggest_departure_time

建议出发时间，单位：秒

int64

若请求参数设置了符合规则的expect_arrival_time，则按照预计到达时间预测路况计算路线，并给出建议出发时间。

若算出的suggest_departure_time小于当前时间，则设置

suggest_departure_time为-1。

注意：该功能为高级付费服务，需通过工单联系工作人员开通

taxi_fee

出租车费用，单位：元

int

toll

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

int

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

toll_distance

收费路段里程，单位：米

int

steps

array

路线分段

leg_index

途径点序号

int

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

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°]

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

distance

step的距离信息

int

单位米

road_name

分段的道路名称

string

如“信息路“

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

road_type

分段的道路类型

int

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

0：高速路

1：城市高速路

2：国道

3：省道

4：县道

5：乡镇村道

6：其他道路

7：九级路

8：航线(轮渡)

9：行人道路

toll

分段道路收费， 单位:元

int

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

toll_distance

分段道路收费路程，单位：米

int

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

adcodes

分段途经的城市 编码

string

若途经多个城 市，则adcode以英 文半角逗号相隔 如: 110000,120000

traffic_condition

分段路况详情

array

status

路况指数

int

0: 无路况 1: 畅通 2: 缓行 3: 拥堵 4: 非常拥堵

geo_cnt

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

int

distance

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

float

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

终点步导路线

array

distance

终点步导路线距离

int

单位米

path

终点步导路线坐标点

string

起点步导路线

array

distance

起点步导路线距离

int

单位米

path

起点步导路线坐标点

string