地图组件为了方便用户的操作,一般会满足各种需求场景,比如用鼠标拖曳地图,实体键盘按键上下左右移动,鼠标滚轮缩放地图大小,双击放大地图,这些常规的操作可以极大的方便用户操作,问题是,有时候又是需要禁用某些功能,不然会引起一些误操作,比如双击放大功能,如果不禁用,在某些场景要求双击标注点做一些操作,而此时地图又放大了,导致结果不可预期,所以上述的功能最好做成可以动态启用禁用。
第一版设计这些功能的时候,也是每个功能都写了一个变量,这样功能一多了,变量越来越多,每个变量还需要提供一个get/set,完全冗余了,所以后面也是将这块功能分组,控件是控件的功能枚举值,功能启用禁用又是一个分组,然后通过一个函数setenable,传入需要启用或者是禁用的功能枚举值标识,一个通用的js函数完成所有的处理,非常方便,这才是一个好的设计。
二、功能特点2.1 地图功能支持多种地图内核,默认采用百度地图,可选高德地图、天地图、腾讯地图、谷歌地图等。同时支持在线地图和离线地图两种模式,离线地图方便在不联网的场景中使用。支持各种地图控件的启用,比如地图导航、地图类型、缩略图、比例尺、全景导航、实时路况、绘图工具、结果面板等。支持多种地图功能的动态启用禁用,比如地图拖曳、键盘操作、滚轮缩放、双击放大、连续缩放、地图测距等。提供众多js函数接口用于交互,参数极其丰富,能够想到的应用场景需求都有。统一的信号槽机制,地图中的结果统一信号发送出去,收到后根据type类型区分。支持地图交互,比如鼠标按下获取对应位置的经纬度。单击标注点弹出对应点的信息。支持添加标注、删除标注、移动标注、清空标注。标注点可以指定图标图片和尺寸,支持gif动图,支持指定以图片中心对齐还是底部中心对齐。可以设置旋转角度,带富文本提示信息。标注点事件支持单击发信号通知和自己弹框显示信息。提供地址转坐标和坐标转地址接口。支持各种图形绘制,包括折线图、多边形、矩形、圆形、弧线等。可显示悬浮的绘图工具栏,直接在地图上划线、标注点、矩形、圆形等。支持各种区域搜索,比如矩形区域、圆形区域,可以按照关键字匹配将搜索结果显示在地图中。可动态添加离线的行政区边界点数据。可以搜索行政区划并获取该区域的边界点数据。数据可以保存到文件以便离线使用。支持点聚合功能,多个小标注点合并到一个大标注点,防止点密集导致交互不友好。可以添加海量点,每个点都可以单击获取对应坐标和信息。所有的覆盖物信息比如标注点、矩形、多边形、折线图等,都可以主动获取对应的信息比如坐标点和路径等。支持路径规划,支持公交路线、自驾路线、步行路线、骑行路线,不同查询支持不同策略,可选最少时间、最少换乘、不走高架等。路径规划结果可以显示在地图中,也可以获取到路径点坐标集合。这个数据可以保存到文件,以便发给机器人或者无人机做导航用来轨迹移动。可以设置不同的地图视图比如街道图、卫星图、混合图。可以设置不同的样式,比如午夜蓝、青草绿等样式风格。可以设置地图的旋转角度和倾斜角度。提供经纬度坐标纠偏转换功能,比如传入的GPS坐标需要转换到百度地图坐标或者高德地图坐标。各种坐标系转换全部离线函数,支持地球坐标系WGS-84、火星坐标系GCJ-02、百度坐标系BD-09之间的互相转换,涵盖了各种地图的坐标系。提供动态轨迹点移动功能,按照给定的经纬度坐标集合平滑移动。同时支持qwidget和qml,支持编译到安卓系统运行。2.2 其他功能提供离线地图下载模块,可以选择不同的地图内核比如百度地图或者谷歌地图,不同的地图类型比如下载街道图还是卫星图,不同的地图层级,多线程极速下载。表格行实时显示对应的瓦片下载进度,有下载超时时间,重试次数,每个瓦片下载完成都发送信号通知,参数包括下载用时。提供省市轮廓图下载模块,自动下载各个地区的轮廓图,保存到脚本文件或者文本文件。支持手动调整不同区域的轮廓边界,调整后可以主动获取调整后的边界点集合。提供动态点位示例,手动在地图上选点并添加标注,附带自定义的信息比如速度和时间等。提供海量点位示例,批量添加标注点、点聚合、海量点。用于测试环境中支持的最大点位性能。提供动态轨迹示例,在地图上鼠标按下选择起点和终点后,查询路线,获取路径轨迹点,模拟轨迹平滑移动。可以筛选数据将过多的路径点筛选到设定的点数。提供轨迹回放示例,按照指定的轨迹点列表回放,也可以导入轨迹点数据进行回放。同时支持在街道图、卫星图、混合图中回放轨迹。提供省市区域地图示例,采用echart组件,同时支持闪烁点图、迁徙图、区域地图、世界地图、仪表盘等。可以设置标题、提示信息、背景颜色、文字颜色、线条颜色、区域颜色等各种颜色。省市区域地图示例,内置世界地图、全国地图、省份地图、地区地图,可以精确到县,所有地图全部离线使用。可设置城市的名称、值、经纬度集合。内置通用浏览器组件,同时支持webkit/webengine/miniblink等内核。提供网页控件示例,演示打开网页和本地网页文件。支持任意Qt版本、任意系统、任意编译器。三、相关链接国内站点:https://gitee.com/feiyangqingyun国际站点:https://github.com/feiyangqingyun四、效果图五、相关代码 void MapHelper::loadEnableType(QListWidget *list){ QStringList listText; QList<int> listData; QList<bool> listCheck; listText << "地图拖曳" << "键盘操作" << "滚轮缩放" << "双击放大" << "双指缩放" << "连续缩放" << "惯性拖曳" << "地图测距"; listData << 1 << 2 << 3 << 4 << 5 << 6 << 7 << 10; listCheck << true << false << true << true << true << true << true << false; list->clear(); int count = listText.count(); for (int i = 0; i < count; ++i) { QListWidgetItem *item = new QListWidgetItem; item->setText(listText.at(i)); item->setData(Qt::UserRole, listData.at(i)); item->setCheckState(listCheck.at(i) ? Qt::Checked : Qt::Unchecked); list->addItem(item); }}void frmMapDemo::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight){ //为什么需要通过文本再去找到节点/而不是取选中的节点/因为不选中也可以勾选前面的复选框 QListWidgetItem *item; QString text = topLeft.data().toString(); int count = ui->listEnable->count(); for (int i = 0; i < count; ++i) { item = ui->listEnable->item(i); if (item->text() == text) { break; } } EnableType type = (EnableType)item->data(Qt::UserRole).toInt(); bool enable = (item->checkState() == Qt::Checked); mapObj->setEnable(type, enable);}void MapObjBaiDu::setEnable(){ //通用启用禁用函数 html << QString(" function setEnable(type, enable) {"); html << QString(" if (type == 1) {"); html << QString(" enable ? map.enableDragging() : map.disableDragging();"); html << QString(" } else if (type == 2) {"); html << QString(" enable ? map.enableKeyboard() : map.disableKeyboard();"); html << QString(" } else if (type == 3) {"); html << QString(" enable ? map.enableScrollWheelZoom() : map.disableScrollWheelZoom();"); html << QString(" } else if (type == 4) {"); html << QString(" enable ? map.enableDoubleClickZoom() : map.disableDoubleClickZoom();"); html << QString(" } else if (type == 5) {"); html << QString(" enable ? map.enablePinchToZoom() : map.disablePinchToZoom();"); html << QString(" } else if (type == 6) {"); html << QString(" enable ? map.enableContinuousZoom() : map.disableContinuousZoom();"); html << QString(" } else if (type == 7) {"); html << QString(" enable ? map.enableInertialDragging() : map.disableInertialDragging();"); html << QString(" } else if (type == 10) {"); html << QString(" initDistanceTool();"); html << QString(" enable ? distanceTool.open() : distanceTool.close();"); html << QString(" }"); html << QString(" }");}void MapObjGaoDe::setEnable(){ //通用启用禁用函数 html << QString(" function setEnable(type, enable) {"); html << QString(" if (type == 1) {"); html << QString(" map.setStatus({dragEnable:enable});"); html << QString(" } else if (type == 2) {"); html << QString(" map.setStatus({keyboardEnable:enable});"); html << QString(" } else if (type == 3) {"); html << QString(" map.setStatus({scrollWheel:enable});"); html << QString(" } else if (type == 4) {"); html << QString(" map.setStatus({doubleClickZoom:enable});"); html << QString(" } else if (type == 5) {"); html << QString(" map.setStatus({touchZoom:enable});"); html << QString(" } else if (type == 6) {"); html << QString(" map.setStatus({jogEnable:enable});"); html << QString(" } else if (type == 10) {"); html << QString(" initDistanceTool();"); html << QString(" enable ? distanceTool.turnOn() : distanceTool.turnOff();"); html << QString(" }"); html << QString(" }");}void MapObjTian::setEnable(){ //通用启用禁用函数 html << QString(" function setEnable(type, enable) {"); html << QString(" if (type == 1) {"); html << QString(" enable ? map.enableDrag() : map.disableDrag();"); html << QString(" } else if (type == 2) {"); html << QString(" enable ? map.enableKeyboard() : map.disableKeyboard();"); html << QString(" } else if (type == 3) {"); html << QString(" enable ? map.enableScrollWheelZoom() : map.disableScrollWheelZoom();"); html << QString(" } else if (type == 4) {"); html << QString(" enable ? map.enableDoubleClickZoom() : map.disableDoubleClickZoom();"); html << QString(" } else if (type == 5) {"); html << QString(" enable ? map.enablePinchToZoom() : map.disablePinchToZoom();"); html << QString(" } else if (type == 6) {"); html << QString(" enable ? map.enableContinuousZoom() : map.disableContinuousZoom();"); html << QString(" } else if (type == 7) {"); html << QString(" enable ? map.enableInertia() : map.disableInertia();"); html << QString(" } else if (type == 10) {"); html << QString(" initDistanceTool();"); html << QString(" enable ? distanceTool.open() : distanceTool.close();"); html << QString(" }"); html << QString(" }");}