根据起终点坐标检索符合条件的驾车路线规划方案,支持以下功能:
1. 支持一次请求返回多条路线(备用路线)
2. 支持18个以内的途径点
3. 支持传入车牌规避限行路段
4. 支持传入起点车头方向,辅助判断起点所在正逆向车道,辅助更准确算路
5. 支持未来出行规划,指定未来7天任意出发时刻,将依据智能预测路况和道路限行规划合理路线
https://api.map.baidu.com/direction/v2/driving?origin=40.01116,116.339303&destination=39.936404,116.452562&ak=您的AK
//GET请求
字段名称 | 含义 | 字段类型 | 必填 | 备注 |
---|---|---|---|---|
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,将提升路线规划的准确性, | string | 选填 | |
destination_uid | POI 的 uid(在已知终点POI 的 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:默认 | int | 选填 | 默认0:默认策略 |
alternatives | 是否返回备选路线 | int | 选填 | 默认0 |
cartype | 车辆类型,区分车辆是普通燃油车或纯电动汽车。由于部分城市对燃油车和电动车限行规则有差异,该字段用于结合plate_number车牌号来规避限行。例如:纯电动汽车在北京本地无尾号限行,而燃油车需遵守尾号限行。 | int | 选填 | 默认0 |
plate_number | 车牌号,如 京A00022 | string | 选填 | 不填则不做规避 |
departure_time | 设置出发时间(支持未来7天),UNIX时间戳。 | string | 选填 | 默认为当前时间 |
ext_departure_time | 更多出发时间,UNIX时间戳。 | string | 选填 | 不填则不返回ext_duration字段 |
expect_arrival_time | 预期的到达时间,UNIX时间戳。 | 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 | 传入多个途经点,综合考虑路况、交规限行、 途经点的相对位置以及路线整体的绕路成本等,支持智能调整途经点顺序,给出最优路线。可选值: | int | 选填 | 默认0:不执行途经点智能规划 |
walkinfo | 起终点步导路线 | int | 选填 | 1 表示下发起终点步导路线; |
steps_info | 是否下发step详情 | int | 选填 | |
origin_bind_stategy | 起点绑路策略 | int | 选填 | 默认值0 |
dest_bind_stategy | 终点绑路策略 | int | 选填 | 默认值0 |
origin_road_type | 起点道路类型, | int | 选填 | 默认值0 |
字段名称 | 字段含义 | 字段类型 | 备注 | ||||
---|---|---|---|---|---|---|---|
status | 状态码 | int | 0:成功 1:服务内部错误 2:参数无效 7:无返回结果 | ||||
message | 状态码对应的信息 | string | |||||
type | 默认返回2,开发者无需关注 | int | |||||
result | 返回的结果 | ||||||
restriction | 限行结果提示信息 若无限行路线,则返回空 若无法规避限行,则返回限行提示信息 | string | |||||
total | 返回方案的总数 | int | |||||
routes | 返回的方案集 | 若请求参数设置了符合规则的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字段存在 差异,不是完全 一致 | ||||
end_walkinfo | 终点步导路线 | array | |||||
distance | 终点步导路线距离 | int | 单位米 | ||||
path | 终点步导路线坐标点 | string | |||||
start_walkinfo | 起点步导路线 | array | |||||
distance | 起点步导路线距离 | int | 单位米 | ||||
path | 起点步导路线坐标点 | string |
上一篇
下一篇
本篇文章对您是否有帮助?