浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

所有文档

行驶里程分析

行驶里程分析
下载开发文档
接口说明

轻量行驶里程分析服务是一类Web API接口服务,用于分析行程轨迹相关的时空信息,目前支持分析行程的道路等级,反映车辆在各等级道路上的行驶里程。

使用说明

开发者通过车辆的行驶轨迹,自动分析其途经道路的等级,返回在不同等级道路上的行驶里程。

API服务地址

https://api.map.baidu.com/api_trackanalysis/v1/roadgrade?
//POST请求

请求参数
参数名称参数含义类型必选备注
ak用户的AK,授权使用string
point_list轨迹点序列string

最多不能超过2000个轨迹点,且轨迹里程不超过500公里,point_list格式为json, 其中每个point必须包含:

latitudedouble纬度,支持小数点后6位
longitudedouble经度,支持小数点后6位
coord_type_inputstring轨迹点的坐标系,支持以下值:bd09ll(百度经纬度坐标)、gcj02(国测局加密坐标)、wgs84(GPS所采用的坐标系)
loc_timeint轨迹点的定位时间,使用UNIX时间戳
speeddouble轨迹点的速度,单位:公里/小时
directionint轨迹点的方向,单位:范围为[0,359],0度为正北方向,顺时针方向递增
heightint轨迹点的高度,单位:米
radiusint定位时返回的定位精度,单位:米
rectify_option纠偏设置string(0-128)

”竖线相隔。默认值为:
need_mapmatch:1|transport_mode:auto|denoise_grade:1|vacuate_grade:1
取值规则为:
1. need_mapmatch(绑路)
是否需要将轨迹点绑路并补充道路形状点 ,示例:
need_mapmatch:0 不绑路
need_mapmatch:1 绑路
2. transport_mode(交通方式)
根据不同交通工具选择不同的纠偏策略和参数,目前支持:自动(即鹰眼自动识别的交通方式)、驾车、骑行和步行。示例:
transport_mode:auto
transport_mode:driving
transport_mode:riding transport_mode:walking
3. denoise_grade(去噪力度) 取值范围[0,5],数值越大去噪力度越大,代表越多的点会被当做噪点去除。若取值0,则代表不去噪。示例:
denoise_grade:0 (不去噪)
denoise_grade:1 (系统默认去噪)
denoise_grade:2(系统默认去噪,同时去除定位精度低于500的轨迹点,相当于保留GPS定位点、大部分Wi-Fi定位点和精度较高的基站定位点)
denoise_grade:3(系统默认去噪,同时去除定位精度低于100的轨迹点,相当于保留GPS定位点和大部分Wi-Fi定位点)
denoise_grade:4(系统默认去噪,同时去除定位精度低于50的轨迹点,相当于保留GPS定位点和精度较高的Wi-Fi定位点)
denoise_grade:5(系统默认去噪,同时去除定位精度低于20的轨迹点,相当于仅保留GPS定位点)
4. vacuate_grade(抽稀力度) 取值范围[0,5],数值越大抽稀度力度越大,代表轨迹会越稀疏。若取值0,则代表不抽稀。示例:
vacuate_grade:0(不抽稀)
vacuate_grade:2(抽稀力度为2)

supplement_mode里程补偿设置string(0-128)

默认值:no_supplement
在里程计算时,两个轨迹点定位时间间隔5分钟以上,被认为是中断。中断轨迹提供以下5种里程估算方式:
no_supplement:不补充,中断两点间距离不记入里程
straight:使用直线距离补充
driving:使用最短驾车路线距离补充
riding:使用最短骑行路线距离补充
walking:使用最短步行路线距离补充

sn用户的权限签名string

若用户所用ak的校验方式为sn校验时该参数必须。 sn校验说明

返回参数
参数名含义类型备注
status状态码int详见状态码定义
message响应信息string对status的中文描述
total忽略掉page_index,page_size后的轨迹点数量代表一共有多少条符合条件的track
distance此段轨迹的里程数doublet符合条件的所有轨迹点总里程,单位:米
road_grade_info道路等级信息
road_gradestring道路等级,包括:
ROAD_GRADE_VILLAGE 乡镇村道
ROAD_GRADE_SIDEWALK 步行道路
ROAD_GRADE_PROVINCIAL 省道
ROAD_GRADE_OTHER 其它道路
ROAD_GRADE_NINE 特服道路
ROAD_GRADE_NATIONAL 国道
ROAD_GRADE_HIGHWAY 高速道路
ROAD_GRADE_FERRY 轮渡
ROAD_GRADE_COUNTY 县道
ROAD_GRADE_CITYHIGHWAY 城市高速
distancedouble该道路等级对应的轨迹里程,单位:米
示例代码
填写您的AK

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

<?php
// 此处填写你在控制台-应用管理-创建应用后获取的AK
$ak = '您的AK';
// 发起一个http post请求,并返回请求的结果
// $url字段为请求的地址
// $param字段为请求的参数
function request_post($url = '', $param = array()) {
if (empty($url) || empty($param)) {
return false;
}
$curl = curl_init(); // 初始化curl
curl_setopt($curl, CURLOPT_URL, $url); // 设置指定url
curl_setopt($curl, CURLOPT_TIMEOUT, 1000); // 设置超时时间1秒
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); // curl不直接输出到屏幕
curl_setopt($curl, CURLOPT_HEADER, 0); // 设置header
// 以下两行不对https做证书及服务器校验,真实项目中请根据实际情况调整。
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($curl, CURLOPT_POST, 1); // 设置POST
curl_setopt($curl, CURLOPT_POSTFIELDS, $param);
$data = curl_exec($curl); // 运行curl
if (!$data) {
print("an error occured in function request_post(): " . curl_error($curl) . "\n");
}
curl_close($curl);
return $data;
}
// 请求地址
$url = 'https://api.map.baidu.com/api_trackanalysis/v1/roadgrade';
// 构造请求
$param['ak'] = $ak;
$param['point_list'] = '['.
'{"latitude":39.22682,"coord_type_input":"gcj02","longitude":117.283027,"loc_time":1632817534},'.
'{"latitude":39.223979,"coord_type_input":"gcj02","longitude":117.285641,"loc_time":1632817592},'.
'{"latitude":39.220022,"coord_type_input":"gcj02","longitude":117.285826,"loc_time":1632817652},'.
'{"latitude":39.213075,"coord_type_input":"gcj02","longitude":117.281162,"loc_time":1632817712},'.
'{"latitude":39.207602,"coord_type_input":"gcj02","longitude":117.270462,"loc_time":1632817773}'.
']';
$param['rectify_option'] = 'transport_mode:auto|denoise_grade:1|vacuate_grade:1';
// 只支持x-www-form-urlencoded格式的请求
$param = http_build_query($param);
// 发送请求
$res = request_post($url, $param);
// 将原始返回的结果打印出来
print("请求的原始返回结果为:\n");
print($res . "\n");
?>
{
"status": 0,
"message": "成功",
"total":19,
"distance":2982.47,
"road_grade_info":[
{
"road_grade":"其它道路",
"distance":243.99
},
{
"road_grade":"县道",
"distance":455.08
},
{
"road_grade":"高速道路",
"distance":2283.39
}
]
}
在线运行
参数备注必选
point_list
轨迹点序列
请求示例
POST BODY中请求参数填写示例
ak:<您的ak>
point_list:[{"latitude":39.22682,"coord_type_input":"gcj02","longitude":117.283027,"loc_time":1632817534},{"latitude":39.223979,"coord_type_input":"gcj02","longitude":117.285641,"loc_time":1632817592},{"latitude":39.220022,"coord_type_input":"gcj02","longitude":117.285826,"loc_time":1632817652},{"latitude":39.213075,"coord_type_input":"gcj02","longitude":117.281162,"loc_time":1632817712},{"latitude":39.207602,"coord_type_input":"gcj02","longitude":117.270462,"loc_time":1632817773}]

上一篇

使用准备

下一篇

更新日志

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