轨迹上传至鹰眼云端后,鹰眼将免费保存最近1年的轨迹数据。开发者可以利用轨迹查询类接口查询任意24小时内的轨迹和里程信息。
在轨迹查询的同时,结合轨迹纠偏功能,可查询纠偏后的轨迹和里程。轨迹查询与轨迹纠偏密不可分,但为便于开发者阅读,本页仅介绍轨迹查询和里程计算功能,轨迹纠偏功能在另一页面详细介绍。
轨迹查询类接口包含3个接口:
1. 查询轨迹(gettrack),常用于回放历史轨迹场景
2. 查询当前最新轨迹点(getlatestpoint),常用于实时追踪最新位置的场景
3. 查询里程(getdistance),常用于只需计算里程,无需返回详细轨迹点的场景
查询轨迹
鹰眼提供轨迹查询接口供开发者查询某终端在任意24小时时间段内所有轨迹点的信息(注意:若开发者需查询多天超过24小时的轨迹,可分多次请求后,拼接轨迹)返回信息包括:
轨迹里程:查询时间区间内行驶的里程。里程计算分为总里程计算和覆盖收费道路里程计算(常用于物流、用车等行业校准过路费)
定位时间:轨迹点的定位时间
经纬度:轨迹点的坐标
方向:轨迹点的方向。在GPS定位时,取GPS数据中的方向;在无GPS时,将使用前后两个轨迹点计算方向补充该值
高度:轨迹点的高度。仅在GPS定位时,取GPS数据中高度信息;否则,无高度信息
速度:轨迹点的速度。在GPS定位时,取GPS数据中的速度;在无GPS时,将使用前后两个轨迹点计算速度补充该值
楼层:若该轨迹点在百度地图高精室内定位范围内,则将返回轨迹点所在楼层信息
定位精度:该轨迹点可能的误差范围。开发者可根据该值过滤一些误差较大的轨迹点
创建时间:鹰眼云端收到轨迹点的时间,采用的是鹰眼服务器时间。
对象名称:若该轨迹点附带图像等数据,则将返回轨迹点对应的图像唯一标识
自定义字段:开发者若创建了轨迹点自定义字段,并上传了该字段信息,则将返回相应信息。
查询当前最新轨迹点
在实时追踪终端的场景下,需要频繁查询当前点的最新位置。但受各种因素影响,实时位置经常会漂移,而单个轨迹点几乎无法纠偏。但若能加入前一段时间的轨迹点,结合上下文一起进行纠偏,则可提升当前轨迹点纠偏效果。
应用实例举例:定位跟踪器
getlatestpoint接口结合轨迹纠偏功能,在用户请求时,自动获取当前时间前一段时间的轨迹点辅助当前轨迹点纠偏,实现了实时纠偏的效果。
查询里程
查询轨迹(gettrack)接口中不仅返回轨迹点,也会返回里程。但为了满足开发者在某些场景中,无需获取详细轨迹点只需获取里程的需求,鹰眼提供了单独的里程查询接口(getdistance)。
不论是gettrack还是getdistance接口,对于中断的轨迹区间(前后轨迹点定位时间超过5分钟),鹰眼提供了几种选项供开发者选择进行里程补偿:
1. 不补偿,即轨迹中断区间里程为0
2. 使用直线距离补偿
3. 使用驾车/骑行/步行路线规划距离补偿
此外,除计算总里程外,鹰眼还支持计算轨迹覆盖收费道路的里程,用于帮助物流企业估算高速路费;支持计算行程中的低速里程,用于帮助网约车计费。