百度地图开放平台

所有文档

境外路线规划

更新时间: 2026/10/27 15:33
公交路线规划
接口说明

根据起终点坐标规划境外公共交通出行路线和耗时,支持:
1. 支持设置市内公交换乘策略:推荐、少换乘、少步行、不坐地铁、时间短、地铁优先
2. 支持指定出发日期和出发时间区间,只返回符合发车时间的方案
3. 支持分页返回路线,每页最多10条
4. 返回路线的总距离、总耗时、预计到达时间、总票价,以及每一步可选的乘车方案、线路名称、上下车站点和首末班车时间
注:若返回状态码3001,表示暂不支持该国家/地区的公交路线规划

API服务地址

https://api.map.baidu.com/direction_abroad/v1/transit?origin=40.702963,-73.907852&destination=40.625416,-73.960852&ak=您的AK
//GET请求

请求参数
字段名称字段含义字段类型必填备注

ak

开发者密钥,AK申请

string

是

sn

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

string

否

timestamp

时间戳,与SN配合使用

string

SN存在时必填

origin

起点

double,double

是

起点经纬度,格式为:纬度,经度;小数点后不超过6位,如:40.702963,-73.907852

destination

终点

double,double

是

终点经纬度,格式为:纬度,经度;小数点后不超过6位,如:40.625416,-73.960852

coord_type

输入坐标类型

string

否

默认bd09ll

可选值:

bd09ll:百度经纬度坐标

gcj02:国测局坐标

wgs84:gps设备获取的坐标

ret_coordtype

输出坐标类型

string

否

返回值的坐标类型,默认为百度经纬度坐标:bd09ll

可选值:

bd09ll:百度经纬度坐标

gcj02:国测局坐标

tactics_incity

市内公交换乘策略

int

否

默认值:0,取值范围0-5

可选值:

0:推荐

1:少换乘

2:少步行

3:不坐地铁

4:时间短

5:地铁优先

departure_date

出发日期

string

否

可指定出发日期,如“20171030”

若不填,则默认为当天

departure_time

出发时间区间

string

否

默认为当前出发时间

格式为:hh:mm,如“08:00”:表示只查询发车时间在8点至24点的方案

output

输出类型

string

否

默认json

可选值:

json

xml

page_size

返回每页几条路线

int

否

默认为10,取值范围1-10

page_index

返回第几页

int

否

默认为1

callback

回调函数,用于解决浏览器请求跨域问题

string

否

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

返回参数
字段名称字段含义字段类型备注

status

状态码

int

0:成功

1:服务器内部错误

2:参数无效

1001:没有公交方案

3001:暂不支持该出行方式(此时说明不支持该国家/地区的出行路线规划)

message

状态码对应的信息

string

type

返回数据类型

int

取值范围1-2

result

返回的结果

dict

origin

city_id

起点城市id

int

city_name

起点城市名称

string

location

lng

起点坐标的经度

double

lat

起点坐标的纬度

double

destination

city_id

终点城市id

int

city_name

终点城市名称

string

location

lng

终点坐标的经度

double

lat

终点坐标的纬度

double

total

所有路线的总数

int

符合条件的所有routes的总数

routes

每页page_size条,第page_index页的路线

array

请求中指定的page_index和page_size的部分。数组元素个数为page_size,每个元素代表从起点到终点的一条路线

distance

本条路线的总距离(米)

int

-1代表无结果

duration

本条路线的总耗时(秒)

int

-1代表无结果

arrive_time

本条路线预计到达时间

string

格式为2016-04-05 17:06:10

price

本条路线的总票价(元)

double

-1代表不支持票价

steps

本条路线有几个step(步骤)

array

数组,数组中的每一项是一步(step)。每条路线都由多个step组成

以境内路线举例说明,比如从奎科大厦到西直门分3个step,第一步是奎科大厦步行到上地五街,第二步是上地五街到上地地铁站,第三步是上地地铁站到西直门

schemes

本step中有几个scheme(方案)

array

以境内路线举例说明,一个step中可能会有多个scheme(方案),上述同城的第二步上地五街到上地地铁站可以坐205或447,每一种是一个scheme

distance

本step的距离(米)

int

duration

本step的耗时(秒)

int

instructions

本step的描述

string

path

本step中的关键点坐标

string

“116.321858,40.039183;116.3216343,40.039141”

start_location

lng

本step起点经度

lat

本step起点纬度

end_location

lng

本step终点经度

lat

本step终点纬度

vehicle_info

type

本step中交通方式的类型

int

3:公交

5:步行

detail

交通方式的具体信息

公交格式,参见下方detail字段说明;步行为null

detail字段说明

vehicle_info中type=3(公交)时,detail字段格式如下:

字段名称字段含义字段类型备注

name

公交线路名称

string

type

市内公交的具体类型

int

只有同城公交才会有此字段

0:普通日行公交车;1:地铁、轻轨;2:机场巴士(前往机场);3:有轨电车;4:机场巴士(从机场返回);5:旅游线路车;6:夜班车;7:机场巴士(机场之间);8:轮渡;9:其他;10:快车;11:慢车;12:机场快轨(前往机场);13:机场快轨(从机场返回);14:机场轨道交通环路

stop_num

途经站点数

int

on_station

上车站点名称

string

off_station

下车站点名称

string

first_time

始发车发车时间

string

指的是从上车站点到下车站点这个方向上的始发车发车时间

last_time

末班车发车时间

string

指的是从上车站点到下车站点这个方向上的末班车发车时间

上一篇

步行路线规划

下一篇

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