浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
服务介绍
服务文档
使用指南
更新日志
轨迹分析服务

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

功能介绍
轨迹分析API

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


接口功能介绍
轻量轨迹分析API
http://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(绑路)
是否需要将轨迹点绑路并补充道路形状点 ,示例:
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
此段轨迹的里程数 double t符合条件的所有轨迹点总里程,单位:米
road_grade_info 道路等级信息

road_grade
string 道路等级,包括:
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 城市高速




distance double 该道路等级对应的轨迹里程,单位:米
请求示例
yingyan_demo.png

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}]
返回示例
 
{
    "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


产品发布
全新轨迹重合率分析API Beta V1.0产品上线
  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消