## 一、前言说明
在使用百度地图的路书功能中,并
没有提供移动的信号以及移动结束的信号,但是很多时候都期望拿到移动的哪里了以及移动结束的信号,以便做出对应的处理,比如结束后需要触发一些对应的操作。经过搜索发现很多人都有这个需求,需要在js文件中加上一点代码才行,也就是在start开始的时候传入两个回调函数movestep和moveend,在js文件对应移动标注点的地方触发这个回调,在移动到末尾的时候再去触发moveend信号,这个回调参数中可以带上对应的对象以及坐标经纬度值。为什么还要带上对象或者唯一标识呢,因为可能有多个移动的点,需要这个唯一标识区分是谁发出来的。还有个注意点是,既然是改动过的js文件了,那肯定不能再引用网络地址上的那个js文件,就需要引用本地的改过的js文件。
关于路书功能,每个地图内核都有自己独特的实现方法和信号,比如高德地图提供的是moving信号,参数是走过的路径,并没有当前路径点,需要从这个路径集合中取末尾这个才是当前路径点,也可以通过调用标注点marker.getPosition方法来获取。天地图只提供了passOneNode事件,每移动一个点就触发一次,带了三个参数lnglat表示当前经纬度,index表示当前点索引, length表示当前路径点的长度数量,那怎么判断移动结束了呢,只需要判断index和length相等就行。腾讯地图就比较友善,两个事件都提供了,而且参数也是能拿到经纬度值。
## 二、功能特点
### 2.1 地图功能
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,支持
编译到安卓系统运行。
### 2.2 其他功能
1. 提供离线地图下载模块,可以选择不同的地图内核比如百度地图或者谷歌地图,不同的地图类型比如下载街道图还是卫星图,不同的地图层级,多线程极速下载。
2. 表格行实时显示对应的瓦片下载进度,有下载超时时间,重试次数,每个瓦片下载完成都发送信号通知,参数包括下载用时。
3. 提供省市轮廓图下载模块,自动下载各个地区的轮廓图,保存到脚本文件或者文本文件。
4. 支持手动调整不同区域的轮廓边界,调整后可以主动获取调整后的边界点集合。
5. 提供动态点位示例,手动在地图上选点并添加标注,附带自定义的信息比如速度和时间等。
6. 提供海量点位示例,批量添加标注点、点聚合、海量点。用于测试环境中支持的最大点位性能。
7. 提供动态轨迹示例,在地图上鼠标按下选择起点和终点后,查询路线,获取路径轨迹点,模拟轨迹平滑移动。可以筛选数据将过多的路径点筛选到设定的点数。
8. 提供轨迹回放示例,按照指定的轨迹点列表回放,也可以导入轨迹点数据进行回放。同时支持在街道图、卫星图、混合图中回放轨迹。
9. 提供省市区域地图示例,采用echart组件,同时支持闪烁点图、迁徙图、区域地图、世界地图、仪表盘等。可以设置标题、提示信息、背景颜色、文字颜色、线条颜色、区域颜色等各种颜色。
10. 省市区域地图示例,内置世界地图、全国地图、省份地图、地区地图,可以精确到县,所有地图全部离线使用。可设置城市的名称、值、经纬度集合。
11. 内置通用浏览器组件,同时支持webkit/webengine/miniblink等内核。提供网页控件示例,演示打开网页和本地网页文件。
12. 支持任意Qt版本、任意系统、任意编译器。
## 三、相关链接
1. 体验地址:[
https://pan.baidu.com/s/1ZxG-oyUKe286LPMPxOrO2A](https://pan.baidu.com/s/1ZxG-oyUKe286LPMPxOrO2A) 提取码:o05q 文件名:bin_map.zip
2. 国内站点:[
https://gitee.com/feiyangqingyun](https://gitee.com/feiyangqingyun)
3. 国际站点:[
https://github.com/feiyangqingyun](https://github.com/feiyangqingyun)
## 四、效果图
## 五、相关代码
```cpp
void MapObjFun::addLine(QStringList &html)
{
//添加轨迹线条/将移动对象的线条设置成新建的线条/参数point表示首个点
html <<
QString(" function addLine(flag, point, color, weight, opacity, arrow) {");
html << QString(" deletePolyline(flag);");
html << QString(" initPolyline(flag, point, color, weight, opacity, arrow);");
html << QString(" var polyline = findOverlay(polylines, flag);");
html << QString(" var index = findMove(flag);");
html << QString(" if (index >= 0) {");
html << QString(" moves[index].line = polyline;");
html << QString(" }");
html << QString(" }");
}
void MapObjFun::moveEvent(QStringList &html)
{
//移动每步回调
html << QString(" function moveStep(obj, pos) {");
html << QString(" var point = getPointString(pos);");
html << QString(" receiveData('movestep', obj.flag + '|' + point);");
//查看当前移动对象是否存在折线属性/存在则表示当前需要跟随绘制线条
html << QString(" var line = obj.line;");
html << QString(" if (line) {");
html << QString(" addDataByLine(line, point);");
html << QString(" }");
html << QString(" }");
//移动结束回调
html << QString(" function moveEnd(obj) {");
html << QString(" receiveData('moveend', obj.flag);");
html << QString(" }");
}
void MapObjFun::findMove(QStringList &html)
{
//查找移动对象
html << QString(" function findMove(flag) {");
html << QString(" for (var i = 0; i < moves.length; ++i) {");
html << QString(" if (flag == moves
.flag) {");
html << QString(" return i;");
html << QString(" }");
html << QString(" }");
html << QString(" return -1;");
html << QString(" }");
//设置移动对象
html << QString(" function setMove(move, flag, clear) {");
html << QString(" move.flag = flag;");
html << QString(" move.clear = clear;");
html << QString(" var index = findMove(flag);");
html << QString(" if (index >= 0) {");
html << QString(" deleteMoveMarker(flag);");
html << QString(" moves[index] = move;");
html << QString(" } else {");
html << QString(" moves.push(move);");
html << QString(" }");
html << QString(" }");
}
void MapObjFun::doMove(QStringList &html)
{
QString start = "start";
QString pause = "pause";
QString next = "start";
QString stop = "stop";
QString show = "show()";
if (mapCore == MapCore_GaoDe) {
start = "moveAlong";
pause = "pauseMove";
next = "resumeMove";
stop = "stopMove";
} else if (mapCore == MapCore_TengXun) {
start = "moveAlong";
pause = "pauseMove";
next = "resumeMove";
stop = "stopMove";
show = "setVisible(true)";
} else if (mapCore == MapCore_Google) {
start = "moveAlong";
pause = "pauseMove";
next = "resumeMove";
stop = "stopMove";
show = "setVisible(true)";
}
//执行移动动作/停止移动后主动删除对应的标注/不同地图内核开始的方法不一样
html << QString(" function doMove(flag, action) {");
html << QString(" var index = findMove(flag);");
html << QString(" if (index < 0) {return}");
html << QString(" var move = moves[index];");
html << QString(" if (action == 'start') {");
html << QString(" if (move.data) {");
html << QString(" move.%1;").arg(show);
html << QString(" move.%1(move.data, move.option);").arg(start);
html << QString(" } else {");
html << QString(" move.%1(moveStep, moveEnd);").arg(start);
html << QString(" }");
html << QString(" } else if (action == 'pause') {");
html << QString(" move.%1();").arg(pause);
html << QString(" } else if (action == 'next') {");
html << QString(" move.%1(moveStep, moveEnd);").arg(next);
html << QString(" } else if (action == 'stop') {");
html << QString(" move.%1();").arg(stop);
html << QString(" if (move.clear) {");
html << QString(" deleteMoveMarker(flag);");
html << QString(" deletePolyline(flag);");
html << QString(" }");
html << QString(" }");
html << QString(" }");
//开始移动/暂停移动/继续移动/停止移动
html << QString(" function moveStart(flag) {");
html << QString(" doMove(flag, 'start');");
html << QString(" }");
html << QString(" function movePause(flag) {");
html << QString(" doMove(flag, 'pause');");
html << QString(" }");
html << QString(" function moveNext(flag) {");
html << QString(" doMove(flag, 'next');");
html << QString(" }");
html << QString(" function moveStop(flag) {");
html << QString(" doMove(flag, 'stop');");
html << QString(" }");
}
```