公交路线规划

GET

/direction/v2/transit

火车：vehicle_info 中type=1（火车）时detail 字段格式

字段名称	字段含义	字段类型	备注
name	火车车次名称	string
price	总票价	double
booking	订票电话	string
departure_station	上车火车站名称	string
arrive_station	下车火车站名称	string
departure_time	发车时间	string	所乘的火车在上车火车站的发车时间
arrive_time	到站时间	string	所乘的火车在下车火车站的到站时间
start_info	start_name	string	起点站名
start_city	string	起点所在城市名称
start_time	string	出发时间
end_info	end_name	string	终点站名
end_city	string	终点所在城市名称
end_time	string	抵达时间

飞机：vehicle_info 中type=2（飞机）时detail 字段格式

字段名称	字段含义	字段类型	备注
name	航班名称	string
price	总票价	double
discount	折扣	double
airlines	航空公司	string
booking	订票网址	string
departure_station	登机机场名称	string
arrive_station	下飞机机场名称	string
departure_time	飞机起飞时间	string
arrive_time	飞机降落时间	string
start_info	start_name	string	起点站名
start_city	string	起点所在城市名称
start_time	string	出发时间
end_info	end_name	string	终点站名
end_city	string	终点所在城市名称
end_time	string	抵达时间

公交：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	指的是从上车站点到下车站点这个方向上的末班车发车时间
start_info	start_time	string	首班车时间
start_ uid	string	起点poi 的 uid
start_name	string	起点公交站名称
end_info	end_ time	string	末班车时间
end_ uid	string	终点POI 的 uid
end_name	string	终点公交站名称

大巴：vehicle_info 中type=6（大巴）时detail 字段格式

字段名称	字段含义	字段类型	备注
name	大巴班次名称	string
price	总票价	double
booking	订票网址	string
provider_name	合作方名称	string
provider_url	合作方官网地址	string
departure_station	上车汽车站名称	string
arrive_station	下车汽车站名称	string
departure_time	发车时间	string
arrive_time	到站时间	string
start_info	start_name	string	起点站名
start_city	string	起点所在城市名称
start_time	string	出发时间
end_info	end_name	string	终点站名
end_city	string	终点所在城市名称
end_time	string	抵达时间

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://api.map.baidu.com/direction/v2/transit?origin=40.056878,116.30815&destination=31.222965,121.505821&ak=&sn='

响应示例

{
  "status": 0,
  "message": "string",
  "result": "string",
  "origin": {
    "city_id": "string",
    "city_name": "string",
    "location": {
      "lng": "string",
      "lat": "string"
    }
  },
  "destination": {
    "city_id": "string",
    "city_name": "string",
    "location": {
      "lng": "string",
      "lat": "string"
    }
  },
  "taxi": {
    "detail": {
      "desc": "string",
      "km_price": 0,
      "start_price": 0,
      "total_price": 0
    },
    "distance": 0,
    "duration": 0,
    "remark": "string"
  },
  "total\t": 0,
  "routes": {
    "distance": 0,
    "duration": 0,
    "arrive_time": "string",
    "price": 0,
    "price_detail": {
      "ticket_type": 0,
      "ticket_price": 0
    },
    "steps": {
      "schemes": {
        "distance": 0,
        "duration": 0,
        "instructions": "string",
        "path": "string",
        "traffic_condition": [
          "string"
        ],
        "start_location": {
          "lng": 0,
          "lat": 0
        },
        "end_location": {
          "lng": "string",
          "lat": "string"
        },
        "vehicle_info": {
          "type": 0,
          "detail": "string"
        }
      }
    }
  }
}

请求参数

Query 参数

origin

number

起点

必需

示例值:

40.056878,116.30815

destination

number

终点

必需

示例值:

31.222965,121.505821

origin_uid

string

可选

POI 的 uid（在已知起点POI 的 uid 情况下，请尽量填写uid，将提升路线规划的准确性，使用地点检索服务获取uid ，使用地点输入提示服务获取uid )

destination_uid

string

可选

POI 的 uid（在已知终点POI 的 uid 情况下，请尽量填写uid，将提升路线规划的准确性，使用地点检索服务获取uid ，使用地点输入提示服务获取uid )

coord_type

string

可选

起终点的坐标类型；默认为bd09ll 可选值： bd09ll（百度经纬度坐标） gcj02（国测局加密坐标） wgs84（gps 设备获取的坐标）

departure_date

string

可选

出发日期；可指定出发日期，若不填默认规则如下： 1. 若为起终点为同城：则默认为当天 2. 若为起终点为跨城：则默认第二天

departure_time

string

可选

出发时间区间；格式为： 1. hh:mm-hh:mm，如”08:00-14:00”：表示只查询发车时间在8点至14点之间的方案 2. hh:mm，如”08:00” ：表示只查询发车时间在8点至24点的方案

tactics_incity

integer

可选

市内公交换乘策略；默认为0 可选值： 0 推荐 1 少换乘 2 少步行 3 不坐地铁 4 时间短 5 地铁优先

tactics_intercity

integer

可选

跨城公交换乘策略；默认为0 可选值： 0 时间短 1 出发早 2 价格低

trans_type_intercity

integer

可选

跨城交通方式策略；默认为0 可选值： 0 火车优先 1 飞机优先 2 大巴优先

ret_coordtype

string

可选

返回值的坐标类型；默认为百度经纬度坐标：bd09ll 可选值： bd09ll：百度经纬度坐标 gcj02：国测局坐标

output

string

可选

输出类型；默认为json 可选值: json xml

page_size

integer

可选

返回每页几条路线；默认为10

page_index

integer

可选

返回第几页；默认为1

timestamp

string

可选

时间戳，与SN配合使用；SN存在时必填。

callback

string

可选

回调函数，用于解决浏览器请求跨域问题；仅在 output=json时该参数有效。

string

必需

开发者的访问密钥，必填项。v2之前该属性为key。申请秘钥

默认值:

string

可选

可选，若开发者所用AK的校验方式为SN校验时该参数必须。

默认值:

返回响应

🟢200成功

application/json

Body

status

integer

必需

状态码；0：成功 1：服务器内部错误 2：参数无效 1001：没有公交方案 1002：不支持跨域

message

string

状态码对应的信息

必需

result

string

必需

返回的结果；如果status为1001 或1002，此字段为null

origin

object

必需

city_id

string

起点城市ID

必需

city_name

string

起点城市名称

必需

location

object

必需

destination

object

必需

city_id

string

终点城市ID

必需

city_name

string

终点城市名称

必需

location

object

必需

taxi

object

必需

detail

object

出租车的详细信息

必需

distance

integer

出租车预计里程数

必需

duration

integer

出租车预计耗时

必需

remark

string

出租车备注信息

必需

total

integer

必需

所有路线的总数；符合条件的所有routes 的总数

routes

object

必需

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

distance

integer

必需

本条路线的总距离（米）

duration

integer

必需

本条路线的总耗时（秒）

arrive_time

string

必需

本条路线预计到达时间；格式为2016-04-05 17:06:10

price

integer

必需

本条路线的总票价（元）；境外地区此字段值为null

price_detail

object

必需

车票详细信息；起终点为境内同城时此字段为一个数组，数组中的每一项都有ticket_type 和ticket_price 两个字段；起终点为境内跨城时，该字段为一个空的数组。

steps

object

必需

本条路线有几个step（步骤）；数组，数组中的每一项是一步（step）。每条路线都由多个step组成。起终点为同城时，比如从奎科大厦到西直门分3个step，第一步是奎科大厦步行到上地五街，第二步是上地五街到上地地铁站，第三步是上地地铁站到西直门；起终点为跨城时，比如从奎科大厦到天津大学分3个step，第一步是奎科大厦到北京南站，第二步是北京南站到天津站，第三步是天津站到天津大学。

摩托车路线规划

骑行路线规划