一、前言说明

这个轨迹回放的功能迭代过很多个版本，最初的版本是轨迹点的坐标每次都是删除折线再重新生成折线，后面发现有内存泄漏，地图js中并不会及时的释放没有用的对象，哪怕是用地图提供的clearoverlay的方法，也不会去释放，不知道是地图js没有处理好还是。第二个版本是先按需生成曲线对象，每次轨迹点更新后，就调用polyline对应的setpath方法去设置新的路径，这样如果只有一条路径，则只有一个折线对象，每次都是更新他的路径就好。最后不需要的时候再去删除这个折线就好，怎大大提升了效率，减轻了频繁分配内存的压力。

按照上面的方法基本可用了，那是不是就到此为止了呢？肯定不是的，你会发现现在的方法，可以移动，但是移动起来很僵硬不连贯不平滑，需要两个点的间隔很密集才看起来不僵硬，那怎么行呢，如果用户提供的只有两个点的直线呢，突然跳跃一下子就抛到了终点，看起来多么的失败。用户希望的是平滑移动而不是跳跃运动，这个时候就需要根据两个点之间再插入点，以便移动的时候是平滑的效果，至于这个插值谁来做，可以自己用算法实现，网上也提供了类似的算法，或者从路书js文件中查看到源码，也可以直接用提供的路书功能去实现。

在对各种地图内核实现平滑移动的过程中，发现百度地图和天地图都是提供了js文件对应的类去实现，而高德地图和腾讯地图是直接将此功能放在标注点marker对象中，调用对应的moveAlong方法即可。这是两种不同的实现策略，各有优缺点。

二、功能特点

1. 支持多种地图内核，默认采用百度地图，可选高德地图、天地图、腾讯地图等。
2. 同时支持在线地图和离线地图两种模式，离线地图方便在不联网的场景中使用。
3. 支持各种地图控件的启用，比如地图导航、地图类型、缩略图、比例尺、全景导航、实时路况、绘图工具、结果面板等。
4. 支持多种地图功能的动态启用禁用，比如地图拖曳、键盘操作、滚轮缩放、双击放大、连续缩放、地图测距等。
5. 提供众多js函数接口用于交互，参数极其丰富，能够想到的应用场景需求都有。
6. 统一的信号槽机制，地图中的结果统一信号发送出去，收到后根据type类型区分。
7. 支持地图交互，比如鼠标按下获取对应位置的经纬度。单击标注点弹出对应点的信息。
8. 支持添加标注、删除标注、移动标注、清空标注。
9. 标注点可以指定图标图片和尺寸，支持gif动图，支持指定以图片中心对齐还是底部中心对齐。可以设置旋转角度，带富文本提示信息。
10. 标注点事件支持单击发信号通知和自己弹框显示信息。
11. 提供地址转坐标和坐标转地址接口。
12. 支持各种图形绘制，包括折线图、多边形、矩形、圆形、弧线等。
13. 可显示悬浮的绘图工具栏，直接在地图上划线、标注点、矩形、圆形等。
14. 支持各种区域搜索，比如矩形区域、圆形区域，可以按照关键字匹配将搜索结果显示在地图中。
15. 可动态添加离线的行政区边界点数据。可以搜索行政区划并获取该区域的边界点数据。数据可以保存到文件以便离线使用。
16. 支持点聚合功能，多个小标注点合并到一个大标注点，防止点密集导致交互不友好。
17. 可以添加海量点，每个点都可以单击获取对应坐标和信息。
18. 所有的覆盖物信息比如标注点、矩形、多边形、折线图等，都可以主动获取对应的信息比如坐标点和路径等。
19. 支持路径规划，支持公交路线、自驾路线、步行路线、骑行路线，不同查询支持不同策略，可选最少时间、最少换乘、不走高架等。
20. 路径规划结果可以显示在地图中，也可以获取到路径点坐标集合。这个数据可以保存到文件，以便发给机器人或者无人机做导航用来轨迹移动。
21. 可以设置不同的地图视图比如街道图、卫星图、混合图。
22. 可以设置不同的样式，比如午夜蓝、青草绿等样式风格。
23. 可以设置地图的旋转角度和倾斜角度。
24. 提供经纬度坐标纠偏转换功能，比如传入的GPS坐标需要转换到百度地图坐标或者高德地图坐标。各种坐标系转换全部离线函数，支持地球坐标系WGS-84、火星坐标系GCJ-02、百度坐标系BD-09之间的互相转换，涵盖了各种地图的坐标系。
25. 提供动态轨迹点移动功能，按照给定的经纬度坐标集合平滑移动。
26. 同时支持qwidget和qml，支持编译到安卓系统运行。

三、使用说明

1. 第一步：选择地图内核，下拉地图内核可以动态切换地图内核。
2. 第二步：选择移动模式，支持多种移动模式，用来控制是否重新动态绘制当前轨迹进度以及是否循环移动。

• 重新绘制-单次：标注点移动到哪里，轨迹折线就绘制到哪里，只移动一次就结束。
• 重新绘制-循环：标注点移动到哪里，轨迹折线就绘制到哪里，移动完成后再次从起始点开始移动。
• 沿线运动-单次：标注点沿着路径点移动，只移动一次就结束。
• 沿线运动-循环：标注点沿着路径点移动，移动完成后再次从起始点开始移动。
• 沿线绘制-单次：标注点沿着路径点移动，同时以不同颜色绘制走过的路径，只移动一次就结束。
• 沿线绘制-循环：标注点沿着路径点移动，同时以不同颜色绘制走过的路径，移动完成后再次从起始点开始移动。

3. 第三步：选择移动速度，一般值越大速度越快。
4. 第四步：选择起始点和结束点坐标，文本框哪个右焦点，则鼠标左侧选点后的值就填在哪个文本框中。
5. 第五步：单击查询轨迹，查询结果路径中的经纬度坐标集合显示在右上角表格中。
6. 第六步：筛选数据，这一步可选，不筛选则以最原始的路径点数据进行。

• 筛选数据是根据设定的点数量，从原始数据中取平均值。数量表示最终筛选后的点数。
• 比如原始数据总数量是90个，点数填30，表示依次从90个数据中每3个点取一个，这样刚好是30个点。
• 为了保证数据完整性，第一个点和末位点一定在筛选数据中。也就是按照设定的点数取值后，可能会多出两个数据点。
• 为什么需要筛选？因为查询出来的轨迹点数量可能很多，比如几千几万个，如果每次移动一个点，这样速度很慢。
• 实际使用过程中还有一种情况是，无人机或者机器人，下发给他的经纬度坐标点数量有限制，这就也需要筛选数据。
• 筛选后如果想恢复数据，数量填0重新筛选即可，0表示不筛选直接用原始数据。

7. 第七步：保存轨迹，这一步可选，可以将当前查询的轨迹点保存到文本文件中，以便提供给轨迹回放模块使用。
8. 第八步：模拟轨迹，单击模拟轨迹按钮，会按照设定的速度模拟轨迹点移动，按钮字样变成停止模拟，再次单击则停止模拟。
9. 第九步：轨迹回放，这一步可选，单击轨迹回放按钮，弹出轨迹回放界面。

四、相关链接

1. 国内站点：https://gitee.com/feiyangqingyun
2. 国际站点：https://github.com/feiyangqingyun

五、效果图