Qt编写地图综合应用23标注点交互

一、前言

地图项目应用中，标注点的交互使用频率非常高，这应该是最常用的场景，比如从数据库中读取出来设备的信息包括经纬度坐标，然后需要在地图上显示对应的设备，这就需要用addMarker函数来动态添加标注点，关于封装的这个函数，陆陆续续经历过好多年的完善，很奇怪为啥这么简单的功能还需要完善，其实这也是实战项目应用中不断积累的，满足各种简单的和复杂的应用场景而来，这个函数带有很多参数，至少10个，接下来就罗列下具体的参数含义以及遇到的需求场景。

• v0.1：addMarker(name, point)，很简单，初学者级别，只需要传入名称和经纬度坐标。
• v0.2：addMarker(name, addr, title, tips, point)，多了三个参数，分别是地址、标题、提示内容，最开始做的时候是传入的字符串内容是啥就显示啥，后面发现还不够灵活，比如很多用户就需要自定义内容甚至颜色进行提示信息显示，这就需要支持html格式的内容。
• v0.3：addMarker(name, addr, title, tips, width, point, action)，多了两个参数，一个表示弹框的宽度，当设定了宽度的话就按照设定的值展示，action有3种选择，表示单击以后触发什么动作 0-不处理 1-自己弹框 2-发送信号，默认0表示不处理，如果添加标注点的时候填入的1则按照设定的提示内容进行弹框，2则不弹框，但是会将标识信息信号的形式发给界面，让界面自己处理，比如单击一个标注点以后弹窗显示对应点的实时视频。
• v0.4：addMarker(name, addr, title, tips, width, point, action, animation, iconfile, iconindex)，多了三个参数，animation表示动画效果 0-不处理 1-跳动 2-坠落，用来区分不同的设备，iconfile 表示图标文件路径，不设置则采用默认图标，注意图片的尺寸，iconindex 表示图标对应在图片中的索引，本地文件则当做图片尺寸。提示信息会根据尺寸自动调整到合适位置显示。
• v0.5：增加删除标注点函数deleteMarker(name)和移动标注点函数moveMarker(name, point)，如果name为空则表示所有标注点。

二、功能特点

1. 同时支持在线地图和离线地图两种模式。
2. 同时支持webkit内核、webengine内核、miniblink内核、IE内核。
3. 支持设置多个标注点，信息包括名称、地址、经纬度。
4. 可设置地图是否可单击、拖动、鼠标滚轮缩放。
5. 可设置协议版本、秘钥、主题样式、中心坐标、中心城市、地理编码位置等。
6. 可设置地图缩放比例和级别，缩略图、比例尺、路况信息等控件的可见。
7. 支持地图交互，比如鼠标按下获取对应位置的经纬度。
8. 支持查询路线，可设置起点位置、终点位置、路线模式、路线方式、路线方案（最少时间、最少换乘、最少步行、不乘地铁、最短距离、避开高速）。
9. 可显示点线面工具，可直接在地图上划线、点、矩形、圆形等。
10. 可设置行政区划，指定某个城市区域绘制图层，在线地图自动输出行政区划边界点集合到js文件给离线地图使用。
11. 可静态或者动态添加多个覆盖物。支持点、折线、多边形、矩形、圆形、弧线、点聚合等。
12. 提供函数接口处理经纬度解析成地址和地址解析成经纬度坐标。
13. 提供的demo直接可以单独选点执行对应的处理比如路线查询。
14. 可以拿到路线查询到的点坐标信息集合，比如用于机器人坐标导航等。
15. 封装了丰富的函数比如删除指定点和所有点，删除指定覆盖物和所有覆盖物等。
16. 标注点弹框信息可以自定义内容，标准html格式。
17. 标注点单击事件可选 0-不处理 1-自己弹框 2-发送信号。
18. 标注点可设置动画效果 0-不处理 1-跳动 2-坠落
19. 标注点可设置本地图片文件等。
20. 函数接口友好和统一，使用简单方便，就一个类。
21. 支持js动态交互添加点、删除点、清空点、重置点，不需要刷新页面。
22. 支持任意Qt版本、任意系统、任意编译器。

三、体验地址

1. 体验地址：https://pan.baidu.com/s/1ZxG-oyUKe286LPMPxOrO2A 提取码：o05q 文件名：bin_map.zip
2. 国内站点：https://gitee.com/feiyangqingyun
3. 国际站点：https://github.com/feiyangqingyun
4. 个人主页：https://blog.csdn.net/feiyangqingyun
5. 知乎主页：https://www.zhihu.com/people/feiyangqingyun/

四、效果图

1.gif

2.gif

五、相关代码

void MapBaiDu::addMarker(QStringList &list) { //动态添加点 //name 表示标注点名称 显示在图标旁边的文本 为空则不显示 //addr 表示标注点地址 //title 表示弹框信息html格式标题 //tips 表示弹框信息html格式内容 //width 表示弹框的宽度 //point 表示经纬度坐标 //action 表示单击以后触发什么动作 0-不处理 1-自己弹框 2-发送信号 //animation 表示动画效果 0-不处理 1-跳动 2-坠落 //iconfile 表示图标文件路径,不设置则采用默认图标,注意图片的尺寸 //iconindex 表示图标对应在图片中的索引,本地文件则当做图片尺寸 list ' + name + '