百度地图开放平台

所有文档

未来驾车出行

服务概览

快速开始

使用准备

接口文档

相关资料

更新日志
更新时间: 2026/10/27 15:35
未来驾车出行API
接口说明

根据起终点坐标和出发时间,预估未来一段时间内不同出发时刻的驾车路线,支持:
1. 从指定出发时间起每隔15分钟取一个时间点,单次最多返回24个未来时间点的路线规划结果
2. 支持设置途经点,并支持传入起终点POI的uid,提升算路准确性
3. 支持传入车辆类型(普通汽车/纯电动汽车/插电混动车)和车牌号,规避限行路段
4. 返回每条路线的距离、耗时、过路费、收费路段长度、红绿灯数量、限行状态,以及分段路况信息

API服务地址

https://api.map.baidu.com/api_car_future/v1/route_plan?origin=30.705992,122.444628&destination=30.658294,122.562679&firsttime=1775098800&count=4&ak=您的AK
//GET请求

请求参数
字段名类型描述必填示例备注

ak

string

开发者密钥,AK申请

是

origin

string

起点坐标

是

30.70599214413032,122.44462820767737

格式:纬度,经度

origin_uid

string

起点poi的uid

否

destination

string

终点坐标

是

30.658294627297327,122.5626789935388

格式:纬度,经度

destination_uid

string

终点poi的uid

否

waypoints

string

途经点序列

否

coord_type

string

传入坐标的类型

否

ret_coordtype

string

返回结果坐标类型

否

gcj02

cartype

int

车辆类型

否

0:普通汽车 [默认值]

1:纯电动汽车

2:插电混动车

plate_number

string

车牌号

否

晋A12345

steps_info

int

是否返回路线分段信息

否

1:默认返回

0:指定不返回路线分段数据

firsttime

int64

出发时间,第一个时间戳;必须是900的倍数

是

1775098800

服务端会每隔15分钟取一个时间点预估对应的未来路线

count

int

未来时间点数量

否

4

最多支持24个

返回参数
字段名类型描述备注

status

int

状态码

0:成功

1:服务内部错误

2:参数错误

其他:失败

message

string

错误描述

result

object

failed

array

计算失败的未来时间点

每个成员是一个int类型的秒级时间戳

groups

array

路线分组

future_time

int

未来时间点,秒级

restriction

string

限行提示

total

int

路线数量

routes

array

路线列表

origin

object

路线起点坐标

lng

double

经度

lat

double

纬度

destination

object

路线终点坐标

lng

double

经度

lat

double

纬度

restriction_info

object

限行状态

status

int

限行状态

路线的限行状态,提示语类型

0:不限行

1:已规避限行,路线合法

2:无法规避限行,路线非法

desc

string

限行描述信息

traffic_light

int

红绿灯数量

distance

int

路线距离

duration

int

路线耗时

toll

int

过路费

toll_distance

int

收费路段长度

steps

array

路线分段

leg_index

int

途经点序号

途经点序号为从0开始的整数,用于标识step所属的途经点路段。如:若该step属于起点至第一个途经点之间的路段,则其leg_index为0

start_location

object

分段起点坐标

lng

double

经度

lat

double

纬度

end_location

object

分段终点坐标

lng

double

经度

lat

double

纬度

distance

int

路段距离

duration

int

路段耗时

road_name

string

路段名

path

string

路线形状点序列

adcodes

string

分段的城市编码

traffic_condition

array

路况

status

int

路网指数

0:无路况

1:畅通

2:缓行

3:拥堵

4:非常拥堵

geo_cnt

int

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

distance

double

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

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

上一篇

使用准备

下一篇

更新日志
本篇文章对您是否有帮助?