产品服务
解决方案
文档与支持
定价
登录

所有文档

行驶里程分析

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

轻量行驶里程分析服务是一类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该道路等级对应的轨迹里程,单位:米
请求示例
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}]

上一篇

使用准备

下一篇

更新日志

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