轻量行驶里程分析服务是一类Web API接口服务，用于分析行程轨迹相关的时空信息，目前支持分析行程的道路等级，反映车辆在各等级道路上的行驶里程。
开发者通过车辆的行驶轨迹，自动分析其途经道路的等级，返回在不同等级道路上的行驶里程。
https://api.map.baidu.com/api_trackanalysis/v1/roadgrade? //POST请求
| 参数名 | 参数含义 | 类型 | 是否必填 | 备注 | |
|---|---|---|---|---|---|
| ak | 用户的AK，授权使用 | string | 是 | ||
| point_list | 轨迹点序列 | string | 是 | 最多不能超过2000个轨迹点，且轨迹里程不超过500公里， point_list格式为json, 其中每个point必须包含： | |
| |
latitude |
|
double | 是 |
纬度，支持小数点后6位 |
| |
longitude | |
double |
是 |
经度，支持小数点后6位 |
| |
coord_type_input | |
string | 是 |
轨迹点的坐标系，支持以下值： bd09ll（百度经纬度坐标）、 gcj02（国测局加密坐标）、 wgs84（GPS所采用的坐标系） |
| |
loc_time |
|
int |
是 |
轨迹点的定位时间， 使用UNIX时间戳 |
| |
speed |
|
double |
否 |
轨迹点的速度，单位：公里/小时 |
| |
direction |
|
int |
否 |
轨迹点的方向， 单位：范围为[0,359], 0度为正北方向，顺时针方向递增 |
| |
height |
|
int |
否 |
轨迹点的高度，单位：米 |
| |
radius |
|
int |
否 |
定位时返回的定位精度，单位：米 |
| rectify_option | 纠偏设置 | string(0-128) | 否 | ”竖线相隔。默认值为： need_mapmatch:1|transport_mode:auto|denoise_grade:1|vacuate_grade:1 取值规则为： 1. need_mapmatch（绑路） | |
| 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 |
此段轨迹的里程数 | double | t符合条件的所有轨迹点总里程，单位：米 | |||||||||||||||||||||
| road_grade_info | 道路等级信息 | |||||||||||||||||||||||
| |
road_grade |
string | 道路等级，包括：
| |||||||||||||||||||||
| |
distance | double | 该道路等级对应的轨迹里程，单位：米 | |||||||||||||||||||||
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}]
{
"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
}
]
}
API请求中需要用到中文或一些特殊字符的参数，如query、region等，为了避免提交到后台乱码，需要对这几个参数值进行编码处理，转换成UTF-8字符的二字符十六进制值，凡是不在下表中的字符都需要进行编码。
| 字符集合 | 字符 |
| URL非保留字 |
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~ |
| URL保留字 |
! * ' ( ) ; : @ & = + $ , / ? % # [ ] |
如果中文参数中使用URL保留字字符的字面意思，例如：region关键字取值为"?北京"，检索关键字包含一个问号，此问号也必须进行编码。
附注：
javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
php中可以使用函数urlencode对特殊字符进行编码。
WGS84：为一种大地坐标系，也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
GCJ02：是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09：为百度坐标系，在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标
正/逆地理编码服务默认输入输出坐标类型为百度坐标（BD09），同时可通过参数（"coord_type","ret_coordtype"）控制输入输出坐标类型。输入坐标支持以上三种坐标系，输出坐标支持-国测局坐标（GCJ02）和百度坐标（BD09）
注意：不同类型坐标如需转换，请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法，以免影响坐标转换精度。
服务相关配额及并发请求限制请访问开发者权益页面查看。
2019年6月17日
Beta V1.0