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/

四、效果图

五、相关代码

void MapBaiDu::addMarker(QStringList &list)
{
    //动态添加点
    //name      表示标注点名称 显示在图标旁边的文本 为空则不显示
    //addr      表示标注点地址
    //title     表示弹框信息html格式标题
    //tips      表示弹框信息html格式内容
    //width     表示弹框的宽度
    //point     表示经纬度坐标
    //action    表示单击以后触发什么动作 0-不处理 1-自己弹框 2-发送信号
    //animation 表示动画效果 0-不处理 1-跳动 2-坠落
    //iconfile  表示图标文件路径,不设置则采用默认图标,注意图片的尺寸
    //iconindex 表示图标对应在图片中的索引,本地文件则当做图片尺寸
    list << QString("  function addMarker(name, addr, title, tips, width, point, action, animation, iconfile, iconindex) {");
    list << QString("    var list = point.split(',');");
    //设置点经纬度坐标
    list << QString("    var pot = new BMap.Point(list[0], list[1]);");
    //设置文本文字 offset为对应标签显示的位置偏移值
    list << QString("    var label = new BMap.Label(name, {\"offset\":new BMap.Size(20, -10)});");

    //设置图标,不设置则采用默认图标
    list << QString("    if (!iconfile) {");
    list << QString("      var marker = new BMap.Marker(pot);");
    list << QString("    } else if (iconfile == 'http://lbsyun.baidu.com/jsdemo/img/fox.gif') {");
    list << QString("      var icon = new BMap.Icon(iconfile, new BMap.Size(300, 157));");
    list << QString("      var marker = new BMap.Marker(pot, {icon: icon});");
    list << QString("    } else if (iconfile == 'http://api.map.baidu.com/img/markers.png') {");
    list << QString("      var icon = new BMap.Icon(iconfile, new BMap.Size(23, 25), {offset: new BMap.Size(10, 25), imageOffset: new BMap.Size(0, 0 - iconindex * 25)});");
    list << QString("      var marker = new BMap.Marker(pot, {icon: icon});");
    list << QString("    } else {");
    list << QString("      var size = 50;");
    list << QString("      if (iconindex) {");
    list << QString("        size = iconindex;");
    list << QString("      }");
    list << QString("      label = new BMap.Label(name, {\"offset\":new BMap.Size(size, -10)});");
    list << QString("      var icon = new BMap.Icon(iconfile, new BMap.Size(size, size));");
    list << QString("      var marker = new BMap.Marker(pot, {icon: icon});");
    list << QString("    }");

    list << QString("    map.addOverlay(marker);");
    list << QString("    if (name != '') {");
    list << QString("      marker.setLabel(label);");
    list << QString("    }");
    list << QString("    addClick(marker, name, addr, title, tips, width, action);");

    //弹跳效果-BMAP_ANIMATION_BOUNCE 坠落效果-BMAP_ANIMATION_DROP
    list << QString("    if (animation == 1) {");
    list << QString("      marker.setAnimation(BMAP_ANIMATION_BOUNCE);");
    list << QString("    } else if (animation == 2) {");
    list << QString("      marker.setAnimation(BMAP_ANIMATION_DROP);");
    list << QString("    }");

    list << QString("  }");
}

void MapBaiDu::addClick(QStringList &list)
{
    //自定义方法显示标注详细信息,可以改成自己的内容,标准html格式

    //默认格式如下,在传入的信息为空的时候应用
    QString title = "<div style=\"color:#CE5521;font-size:15px;\">' + name + '</div>";
    QStringList tips;
    tips << "<table><tr style=\"vertical-align:top;line-height:25px;font-size:12px;\">";
    tips << "<td>地址：</td><td>' + addr + '</td>";
    tips << "</tr></table>";

    list << QString("  function addClick(marker, name, addr, title, tips, width, action){");

    list << QString("    if (title == '' && name != '') {");
    list << QString("      title = '%1';").arg(title);
    list << QString("    }");

    list << QString("    if (tips == '' && addr != '') {");
    list << QString("      tips = '%1';").arg(tips.join(""));
    list << QString("    }");

    list << QString("    var infoWindow = new BMap.InfoWindow(tips, {title:title, width:width});");

    //单击以后弹出提示信息或者发送信号出去
    list << QString("    var markerClick = function() {");
    list << QString("      if (action == 1) {");
    list << QString("        marker.openInfoWindow(infoWindow);");
    list << QString("      } else if (action == 2) {");
    list << QString("        receiveData('marker', '名称: '+ name + '  地址: ' + addr);");
    list << QString("      }");
    list << QString("    };");

    //添加单击监听器
    list << QString("    marker.addEventListener('click', markerClick);");
    list << QString("  }");
}