服务文档
https://api.map.baidu.com/direction/v2/motorcycle?origin=4846797.3,12948640.7&destination=4836829.84,12967554.88&coord_type=bd09mc&ak=您的AK //GET请求
字段名称 | 字段含义 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
ak | 用户的访问权限,AK申请 | string | 必填 | |
origin | 支持以下对起点的描述: 1. 起点经纬度,小数点后不超过6位, 40.056878,116.30815(若使用POI 的 导航坐标即XXXX,将会提升路线规 划的准确性) 2. 名称(该参数仅对sdk和js api开放) | string | 必填 | 起点和终点的直线距离不得超过400km |
destination | 支持以下对终点的描述:终点经纬度,小数点后不超过6位,40.056878,116.30815(若使用POI 的导航坐标即XXXX,将会提升路线规划的准确性) 名称(该参数仅对sdk和js api开放) | string | 选填 | 起点和终点的直线距离不得超过400km |
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 | 选填 | 默认bd09ll |
tactics | 0:默认 3:不走高速 4:高 速优先 5:躲避拥堵 6:少收费 7:躲避拥堵&高速优先 8:躲避拥堵&不走高速 9:躲避拥堵&少收费 10:躲避拥堵&不走高速&少收费 11:不走高速&少收费 | int | 选填 | 默认0:默认策略 |
alternatives | 是否返回备选路线 类型:string 可选值: 0:返回一条推荐路线 1:返回1-3条路线供选择 | int | 选填 | 默认:0 |
plate_number | 车牌号,如 京A00022 用于规避车牌号限行路段。 1. 若有规避限行区域的可选路线, 则返回规避后的路线,不会返回限行 路线 2.若无规避限行的可选路线(如: 起终点在限行区域内,或所有符合偏 好的路线都无法规避限行区域),则返回限行路线中最优路线,并在返回字段 restriction 中提示用户路段被限行 | string | 选填 | 不填则不作规避 |
displacement | 摩托车排量,单位cc | int | 选填 | 取值范围 [0,10000] |
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存在时必填 | SN存在时必填 |
callback | 回调函数 | string | 选填 | 仅再output=json时,该参数有效 |
字段名称 | 字段含义 | 类型 | 备注 | ||
---|---|---|---|---|---|
status | 状态码 | int | 0:成功 1:服务内部错误 2:参数无效 7:无返回结果 | ||
message | 状态码对应的信息 | string | |||
result | 返回的结果 | ||||
restriction | 限行结果提示信息 | string | 1: 若无限行路 线,则返回空 2: 若无法规避限 行,则返回限行 提示信息 | ||
total | 返回方案的总数 | int | |||
routes | 返回的方案集 | array | 若请求参数设置 了符合规则的 departure_time, 则按照设定时间 的预测路况和限 行规则计算路 线。 若未设置 departure_time, 则按照当前时刻 的路况和限行规 则计算路线 | ||
origin | lng | 起点经度 | double | ||
lat | 起点纬度 | double | |||
destination | lng | 终点经度 | double | ||
lat | 终点纬度 | double | |||
tag | 方案标签 | string | |||
restriction_info | |||||
status | 限行状态 | int | 取值范围【0,2】 0:无限行 1:已规避限行, 路线合法 2:无法规避限 行,路线非法 | ||
desc | 限行提示语 | string | 当限行status为1或 2时,会有相应的 限行描述信息。 若该路线有多条 提示信息,则以 英文竖线分隔符 分隔,如: "已为您避开北京 限行区域" "无法为您避开北 京限行区域,请 合理安排出行" "起点在北京限行 区域,请合理安 排出行" "终点在北京限行 区域,请合理安 排出行" "起点在北京限行 区域,请合理安 排出行|终点在北 京限行区域,请 合理安排出行" | ||
distance | 方案距离,单 位:米 | int | |||
duration | 线路耗时,单 位:秒 | int | |||
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字段存在 差异,不是完全 一致 |
https://api.map.baidu.com/direction/v2/transit?origin=40.056878,116.30815&destination=31.222965,121.505821&ak=您的AK //GET请求
字段名称 | 字段含义 | 字段类型 | 是否必填 | 备注 |
---|---|---|---|---|
origin | 起点 | "double,double",格式为:纬度,经度,小数点后不超过6位,如:“40.056878,116.30815” | 必填 | |
destination | 终点 | "double,double",格式为:纬度,经度,小数点后不超过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 | 选填 | |
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 | 市内公交换乘策略 | int(0-5) | 选填 | 默认为0 可选值: 0 推荐 1 少换乘 2 少步行 3 不坐地铁 4 时间短 5 地铁优先 |
tactics_intercity | 跨城公交换乘策略 | int(0-2) | 选填 | 默认为0 可选值: 0 时间短 1 出发早 2 价格低 |
trans_type_intercity | 跨城交通方式策略 | int(0-2) | 选填 | 默认为0 可选值: 0 火车优先 1 飞机优先 2 大巴优先 |
ret_coordtype | 返 回值的坐标类型 | string | 选填 | 默认为百度经纬度坐标:bd09ll可选值:bd09ll:百度经纬度坐标gcj02:国测局坐标 |
output | 输出类型 | string | 选填 | 默认为json 可选值: json xml |
page_size | 返回每页几条路线 | int(1-10) | 选填 | 默认为10 |
page_index | 返回第几页 | int | 选填 | 默认为1 |
ak | 开发者密钥,AK申请 | string | 必填 | |
sn | 用户的权限签名,当AK设置为SN校验时,该参数必填 SN计算方法 | string | 必填 | |
timestamp | 时间戳,与SN配合使用 | string | SN存在时必填 | SN存在时必填。 |
callback | 回调函数,用于解决浏览器请求跨域问题 | string | 选填 | 仅在 output=json时该参数有效。 |
字段名称 | 字段含义 | 字段类型 | 备注 | |
---|---|---|---|---|
status | 状态码 | int | 0:成功 1:服务器内部错误 2:参数无效 1001:没有公交方案 1002:不支持跨域 | |
message | 状态码对应的信息 | string | ||
result | 返回的结果 | dict | 如果status为1001 或1002,此字段为null | |
origin | city_id | 起点城市ID | string | |
city_name | 起点城市名称 | string | ||
location | lng | 起点坐标的经度值 | double | 坐标系由ret_coordtype设置 |
lat | 终点坐标的纬度值 | double | ||
destination | city_id | 终点城市ID | string | |
city_name | 终点城市名称 | string | ||
location | lng | 终点坐标的经度值 | double | 坐标系由ret_coordtype设置 |
lat | 终点坐标的纬度值 | double | ||
taxi | detail | 出租车的详细信息 | array | 仅在同城请求时才返回 |
desc | 白天还是夜间 | string | ||
km_price | 每公里价格(元) | double | ||
start_price | 起步价(元) | double | ||
total_price | 总价(元) | double | ||
distance | 出租车预计里程数 | int | ||
duration | 出租车预计耗时 | int | ||
remark | 出租车备注信息 | string | ||
total | 所有路线的总数 | int | 符合条件的所有routes 的总数 | |
routes | 每页page_size 条,第page_index页的路线 | array | 请求中指定的page_index 和page_size 的部分。数组元素个数为page_size,每个元素代表从起点到终点的一条路线。 | |
distance | 本条路线的总距离(米) | int | ||
duration | 本条路线的总耗时(秒) | int | ||
arrive_time | 本条路线预计到达时间 | string | 格式为2016-04-05 17:06:10 | |
price | 本条路线的总票价(元) | double | 境外地区此字段值为null | |
price_detail | 车票详细信息 | array | 起终点为境内同城时此字段为一个数组,数组中的每一项都有ticket_type 和ticket_price 两个字段; 起终点为境内跨城时,该字段为一个空的数组。 | |
ticket_type | 票类型 | int(0-1) | 0 公交票价;1 地铁票价 | |
ticket_price | 价格(元) | double | 本类型的票的总价 | |
steps | 本条路线有几个step(步骤) | array | 数组,数组中的每一项是一步(step)。每条路线都由多个step组成。 起终点为同城时,比如从奎科大厦到西直门分3个step,第一步是奎科大厦步行到上地五街,第二步是上地五街到上地地铁站,第三步是上地地铁站到西直门; 起终点为跨城时,比如从奎科大厦到天津大学分3个step,第一步是奎科大厦到北京南站,第二步是北京南站到天津站,第三步是天津站到天津大学。 | |
schemes | 本step 中的有几个scheme(方案)或sub_step(子步骤) | array | 当起终点为同城时,一个step 中可能会有多个scheme(方案),上述同城的第二步上地五街到上地地铁站可以坐205或447,每一种是一个scheme; 当起终点为跨城时,一个step 中可能会有多个sub_step(子步骤),上述跨城的第一步从奎科大厦到北京南站分为多个sub_step(子步骤),这里的每个子步骤类似同城时的一个scheme(方案)。 | |
distance | 本step 的距离(米) | int | ||
duration | 本step 的耗时(秒) | int | ||
instructions | 本step 的描述 | string | ||
path | 本step 中的关键点坐标 | string | 坐标系由ret_coordtype设置,示例:“116.321858,40.039183;116.3216343,40.039141” | |
traffic_condition | 本step 中的路况信息 | array | 目前无输出 | |
start_location | lng | 本step 起点经度 | double | 坐标系由ret_coordtype设置 |
lat | 本step 起点纬度 | double | ||
end_location | lng | 本step 终点经度 | double | 坐标系由ret_coordtype设置 |
lat | 本step 终点纬度 | double | ||
vehicle_info | type | 本step 中交通方式的类型 | int | 1:火车 2:飞机 3:公交 4:驾车 5:步行 6:大巴 |
detail | 交通方式的具体信息 | 火车、飞机、大巴、公交4 种交通方式的这个字段有各自的格式,参见下面的文档,步行和驾车为null。 |
字段名称 | 字段含义 | 字段类型 | 备注 |
---|---|---|---|
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 | 抵达时间 |
字段名称 | 字段含义 | 字段类型 | 备注 |
---|---|---|---|
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 | 抵达时间 |
字段名称 | 字段含义 | 字段类型 | 备注 |
---|---|---|---|
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 | 终点公交站名称 |
字段名称 | 字段含义 | 字段类型 | 备注 |
---|---|---|---|
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 | 抵达时间 |
https://api.map.baidu.com/direction/v2/riding?origin=40.01116,116.339303&destination=39.936404,116.452562&ak=您的AK //GET请求
字段名称 | 字段含义 | 字段类型 | 是否必填 | 备注 |
---|---|---|---|---|
origin | 起点 | "double,double" | 是 | 起点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815 |
destination | 终点 | "double,double" | 是 | 终点经纬度,格式为:纬度,经度;小数点后不超过6位,40.056878,116.30815 |
origin_uid | 起点POI的uid(请尽量填写uid,将提升路线规划的准确性。使用地点检索服务获取uid , 使用地点输入提示服务获取uid ) | string | 否 | |
destination_uid | 终点POI的uid(请尽量填写uid,将提升路线规划的准确性。使用地点检索服务获取uid , 使用地点输入提示服务获取uid ) | string | 否 | |
coord_type | 输入坐标类型 | string | 否 | 默认bd09ll 允许的值为:bd09ll(百度经纬度坐标)、bd09mc(百度墨卡托坐标)、gcj02(国测局加密坐标)、wgs84(gps设备获取的坐标)。 |
ret_coordtype | 输出坐标类型 | string | 否 | 返回值的坐标类型,默认为百度经纬度坐标:bd09ll可选值:bd09ll:百度经纬度坐标gcj02:国测局坐标 |
output | 表示输出类型,可设置为xml或json | string | 否 | 默认为json |
riding_type | 骑行类型 | string | 否 | 默认0:0-普通 1-电动车 |
ak | 用户的访问权限,AK申请 | string | 是 | |
sn | 用户的权限签名,当AK设置为SN校验时,该参数必填 SN计算方法 | string | 否 | |
timestamp | 时间戳,与SN配合使用 | string | SN存在时必填 | |
callback | 回调函数,用于解决浏览器请求跨域问题 | string | 否 | 仅在 output=json 时,该参数有效。 |
字段名称 | 字段含义 | 备注 | ||
---|---|---|---|---|
status | 状态码 | 0:成功 1:服务内部错误 2:参数无效 2001:无骑行路线 | ||
message | 状态码对应的信息 | 例如 message:"ok" | ||
type | 返回数据类型 | |||
info | 版权信息 | |||
result | 返回的结果 | |||
routes | distance | 方案距离 | 单位:米 | |
duration | 线路耗时 | 单位:秒 | ||
steps | direction | 当前道路方向角 | ||
distance | 路段距离 | 单位:米 | ||
duration | 路段耗时 | 单位:秒 | ||
instructions | 路段描述 | 如“骑行50米“ | ||
name | 该路段道路名称 | 如“信息路“ 若道路未命名或百度地图未采集到该道路名称,则返回"无名路" | ||
path | 路段位置坐标描述 | |||
turn_type | 行驶转向方向 | 如“直行”、“左前 方转弯” | ||
stepOrigin location | lng | 路段起点经度 | ||
lat | 路段起点纬度 | |||
stepDestination location | lng | 路段终点经度 | ||
lat | 路段终点纬度 | |||
restrictions_status | 限行类型 | 0x01表示禁行;0x02表示逆行 | ||
restrictions_info | 限行信息 | 如 "包含禁行路段|包含逆行路段" | ||
links | link信息 | |||
length | link长度 | 单位:米 | ||
attr | link属性 | 0x01表示禁行;0x02表示逆行 | ||
originLocation | lng | 路线起点经度 | ||
lat | 路线起点纬度 | |||
destinationLocation | lng | 路线终点经度 | ||
lat | 路线终点纬度 | |||
restrictions_status | 限行类型 | 0x01表示禁行;0x02表示逆行 | ||
restrictions_info | 限行信息 | 如 "包含禁行路段|包含逆行路段" | ||
origin | originPt | lng | 起点经度 | |
lat | 起点纬度 | |||
destination | destinationPt | lng | 终点经度 | |
lat | 终点纬度 |
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,将提升路线规划的准确性,使用地点检索服务获取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 | 选填 | 默认bd09ll |
tactics | 0:默认 2:距离最短(只返回一条路线,不考虑限行和路况,距离最短且稳定,用于估价场景) 3:不走高速 4:高速优先 5:躲避拥堵 6:少收费 7: 躲避拥堵 & 高速优先 8: 躲避拥堵 & 不走高速 9: 躲避拥堵 & 少收费 10: 躲避拥堵 & 不走高速 & 少收费 11: 不走高速 & 少收费 12: 距离优先(考虑限行和路况,距离相对短且不一定稳定) 13:时间优先 | int | 选填 | 默认0:默认策略 |
alternatives | 是否返回备选路线 类型:string可选值:0:返回一条推荐路线 1:返回1-3条路线供选择 | string | 选填 | 默认: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 | 选填 | 不填则不返回suggest_departure_time字段 注意:该功能为高级付费服务,需通过反馈平台联系工作人员开通 |
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 |
字段名称 | 字段含义 | 类型 | 备注 | ||
---|---|---|---|---|---|
status | 状态码 | int | 0:成功 1:服务内部错误 2:参数无效 7:无返回结果 | ||
message | 状态码对应的信息 | string | |||
type | 默认返回2,开发者无需关注 | int | |||
result | 返回的结果 | ||||
restriction | 限行结果提示信息若无限行路线,则返回空若无法规避限行,则返回限行提示信息 | string | |||
duration | step的耗时 | int | 单位秒 | ||
total | 返回方案的总数 | int | |||
routes | 返回的方案集 | 若请求参数设置了符合规则的departure_time,则按照设定时间的预测路况和限行规则计算路线。 若未设置departure_time,则按照当前时刻的路况和限行规则计算路线 | |||
origin | lng | 起点经度 | double | ||
lat | 起点纬度 | double | |||
destination | lng | 终点经度 | double | ||
lat | 终点纬度 | double | |||
tag | 方案标签 | string | |||
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 | int | 路线分段 | |||
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以英文半角逗号相隔 | ||
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 |
修改于 2022-08-05 07:57:55