轨迹查询 - 百度地图 API

简介

轨迹上传至鹰眼云端后，鹰眼将免费保存最近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. 使用驾车/骑行/步行路线规划距离补偿

此外，除计算总里程外，鹰眼还支持计算轨迹覆盖收费道路的里程，用于帮助物流企业估算高速路费；支持计算行程中的低速里程，用于帮助网约车计费。