浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
摩托车路线规划
下载开发文档
接口说明

摩托车路线规划为开放平台高级服务,需申请开通权限后才能访问服务

API服务地址

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选填默认bd09II
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摩托车排量,单位ccint选填取值范围 [0,10000]
gps_direction起点的车头方向。 字段类型:int64 取值范 围:0-359int选填车头方向为与正北方向顺时针夹角,该参数用于辅助判断起点所在正逆向车道,提高算路准 确率。 当speed>1.5米/秒且gps_direction存在 时,采用该方向。gps_direction并不代表需填 写从gps获取的方向,可以填入校正后的方 向。请填写尽量准确的方向,其准确性很大程 度决定了计算的精度。
radius起点的定位精度,字段类型:float,取值范围 [0,2000]float选填配合gps_direction字段使用
speed起点车辆的行驶速度,字段类型:floatfloat选填单位:米/秒,配合gps_direction字段使用,当 speed>1.5米/秒且gps_direction存在时,采用 gps_direction的方向
output表示输出类型,可设置为xml或jsonstring选填默认为json
sn

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

string选填
timestamp时间戳,与SN配合使用int64SN存在时必填SN存在时必填
callback回调函数string选填仅再output=json时,该参数有效
返回参数
字段名称字段含义字段类型备注
status状态码int0:成功 1:服务内部错误 2:参数无效 7:无返回结果
message状态码对应的信息string
result返回的结果
restriction限行结果提示信息string1: 若无限行路 线,则返回空 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,3】 0:无限行 1:已规避限行, 路线合法 2:无法规避限行,路线非法 3:疫情相关的信息
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°] 注:角度为与正 北方向顺时针夹 角
distancestep的距离信息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分分段路况详情arrayarray
status路况指数int0: 无路况 1: 畅通 2: 缓行 3: 拥堵 4: 非常拥堵
geo_cnt从当前坐标点开 始,path中路况相 同的坐标点个数int
distance距离,从当前坐 标点开始path 中 路况相同的距 离,单位:米float注:单条线路中 所有distance的和 会与route的 distance字段存在 差异,不是完全 一致
示例代码
填写您的AK

输入AK可生成包含IP/SN校验方式的代码

<?php
// 此处填写你在控制台-应用管理-创建应用后获取的AK
$ak = '您的AK';
// 发起一个http get请求,并返回请求的结果
// $url字段为请求的地址
// $param字段为请求的参数
function request_get($url = '', $param = array()) {
if (empty($url) || empty($param)) {
return false;
}
$getUrl = $url . "?" . http_build_query($param);
$curl = curl_init(); // 初始化curl
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); // 跳过证书检查
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查SSL加密算法是否存在
curl_setopt($curl, CURLOPT_URL, $getUrl); // 抓取指定网页
curl_setopt($curl, CURLOPT_TIMEOUT, 1000); // 设置超时时间1秒
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); // curl不直接输出到屏幕
curl_setopt($curl, CURLOPT_HEADER, 0); // 设置header
$data = curl_exec($curl); // 运行curl
if (!$data) {
print("an error occured in function request_get(): " . curl_error($curl) . "\n");
}
curl_close($curl);
return $data;
}
// 请求地址
$url = 'https://api.map.baidu.com/direction/v2/motorcycle';
// 构造请求参数
$param['origin'] = '4846797.3,12948640.7';
$param['destination'] = '4836829.84,12967554.88';
$param['coord_type'] = 'bd09mc';
$param['ak'] = $ak;
$res = request_get($url, $param);
// 将原始返回的结果打印出来
print("请求的原始返回结果为:\n");
print($res . "\n");
?>
{"status":0,"message":"成功","type":2,"result":{"restriction":"","total":1,"routes":[{"origin":{"lng":116.480283,"lat":40.143297},"destination":{"lng":116.491991,"lat":40.143479},"tag":"方案一","distance":1007,"duration":123,"taxi_fee":14,"restriction_info":{"status":0,"desc":""},"toll":0,"toll_distance":0,"steps":[{"leg_index":0,"road_name":"英才北三街","direction":3,"distance":920.88,"road_type":4,"toll":0,"toll_distance":0,"adcodes":"110000","traffic_condition":[{"status":1,"geo_cnt":17,"distance":920.88}],"path":"116.480283,40.143297;116.480323,40.143298;116.480532,40.143290;116.480791,40.143274;116.484076,40.143168;116.484633,40.143166;116.485777,40.143104;116.485797,40.143104;116.487597,40.143113;116.487856,40.143117;116.488054,40.143160;116.488243,40.143174;116.488333,40.143195;116.488830,40.143293;116.490043,40.143364;116.490232,40.143377;116.490351,40.143390;116.491007,40.143421","start_location":{"lng":116.480283,"lat":40.143297},"end_location":{"lng":116.491007,"lat":40.143421}},{"leg_index":0,"road_name":"无名路","direction":3,"distance":8.58,"road_type":4,"toll":0,"toll_distance":0,"adcodes":"110000","traffic_condition":[{"status":1,"geo_cnt":1,"distance":8.58}],"path":"116.491007,40.143421;116.491106,40.143433","start_location":{"lng":116.491007,"lat":40.143421},"end_location":{"lng":116.491106,"lat":40.143433}},{"leg_index":0,"road_name":"顺于路","direction":3,"distance":75.82,"road_type":4,"toll":0,"toll_distance":0,"adcodes":"110000","traffic_condition":[{"status":1,"geo_cnt":2,"distance":75.82}],"path":"116.491106,40.143433;116.491394,40.143448;116.491991,40.143479","start_location":{"lng":116.491106,"lat":40.143433},"end_location":{"lng":116.491991,"lat":40.143479}}]}]}}
在线运行
参数备注必选
origin
4846797.3,12948640.7
destination
4836829.84,12967554.88
coord_type
bd09mc

上一篇

公交路线规划

下一篇

未来驾车路线规划

本篇文章对您是否有帮助?