Qt5 互动地图，实现无人机地面站效果

一、概述

本文主要通过Qt5+opmapcontrol实现一个简单的无人机地面站效果。opmapcontrol是一个比较古老的QT开源地面站库，可选择谷歌地图，必应地图， 雅虎地图，GIS等。可直接使用源码，也可以编译生成库进行调用。
实现效果：

二、环境

Qt：5.15.2
编译器： Qt 5.15.2 MinGW 64-bit
系统：windows 10

三. 功能特点

（1） 支持缓存地图
（2）支持选择各厂商地图，以及切换街道地图
（3）支持地图互动：拖动、放大缩小
（4）支持添加航点，以及航点的编辑、删除、保存、加载、航点信息显示
（5）支持设置home，以及安全区域
（6）支持显示运动轨迹

四.opmapcontrol

从github上下载下来的源码包调用的时候，不同版本的Qt会有些小bug，可以直接搜opmapcontrol。
CSDN免积分下载链接（包含编译好的库、和简单的调用demo）：
https://download.csdn.net/download/ever__ever/89290882?spm=1001.2014.3001.5503
（以下为opmapcontrol中mapwidget子项目各个类的功能讲解，只想知道如何使用的话可以跳过本节，直接前往第五节）
这个库中我们主要看mapwidget子项目，里面提供了对地图、无人机、航点、轨迹、home等相关操作的接口。

1. OPMapWidget类

这个类主要继承QGraphicsView，提供一个地图交互场景视图。
（1）void SetShowDiagnostics(bool const & value)
设置是否显示诊断信息。当传入的值为true时，会创建定时器用于刷新诊断信息，同时创建GPS对象（如果不存在），并设置透明度。当传入的值为false时，会清除诊断信息、定时器、GPS对象等。
（2）void SetUavPic(QString UAVPic)
用于设置无人机的图片。如果无人机对象存在，会调用其SetUavPic函数设置图片。
（3）UAVItem* AddUAV(int id)
用于添加一个新的无人机对象，并将其添加到地图中。它返回指向新添加的无人机对象的指针。
（4）void AddUAV(int id, UAVItem* uav)
用于添加一个已存在的无人机对象，并将其添加到地图中。
（5）void DeleteUAV(int id)
用于删除指定ID的无人机对象。
（6）UAVItem* GetUAV(int id)
用于获取指定ID的无人机对象。
（7）const QList<UAVItem*> GetUAVS()
用于获取所有无人机对象的列表。
（8）WayPointLine *WPLineCreate(WayPointItem *from, WayPointItem *to, QColor color, bool dashed, int width)
用于创建两个航点之间的连线。
（9）WayPointLine *WPLineCreate(HomeItem *from, WayPointItem *to, QColor color, bool dashed, int width)
用于创建Home点到航点之间的连线。

2. Configuration类
   它主要用于集中管理地图控件的大部分配置选项。

这个类包含了一些成员变量，如EmptytileBrush、EmptyTileText、EmptyTileBorders等，用于配置地图空白瓦片的绘制、文本、边框等样式。同时，它还包含了一些成员函数，用于设置和获取地图的访问模式、语言、内存缓存使用情况、缓存文件的位置等。
总的来说，Configuration类的作用是提供一个集中管理地图控件配置选项的地方，使得在代码中可以方便地对这些配置进行设置和获取。

3. GPSItem类

继承自QObject和QGraphicsItem的类，用于在地图上表示一个无人机（UAV）。提供了一系列函数用于管理无人机的位置、轨迹以及到达状态等属性，以及相应的信号与槽机制用于与其他对象进行交互。
这个类的作用主要有以下几点：

• **表示无人机：**GPSItem类用于在地图上绘制表示无人机的图形元素，可以根据给定的参数设置无人机的位置、高度和朝向。
• **设置无人机轨迹：**可以根据不同的轨迹类型设置无人机的轨迹显示方式，包括按时间间隔绘制轨迹点或按距离间隔绘制轨迹点等。
• **管理轨迹显示：**可以设置是否显示无人机的轨迹以及轨迹线，并提供相应的函数来控制轨迹的显示和清除。
• **自动设置到达状态：**可以设置无人机自动根据距离到达航点，并根据设定的距离自动设置航点到达状态。

4. HomeItem类

继承自QObject和QGraphicsItem的类，用于在地图上表示一个home点的位置。提供了一系列函数用于管理home的位置、安全区域以及相应的交互功能。
这个类的作用主要有以下几点：

• **表示home的位置：**HomeItem类用于在地图上绘制表示home的图形元素，可以设置home的位置坐标和海拔高度。
• **显示安全区域：**可以设置是否显示home的安全区域，并提供相应的函数进行控制。
• **提供信号与槽机制：**通过信号与槽机制，可以实现当home的位置发生变化时通知其他对象，以及当home位置被双击时触发相应的事件。
• **提供鼠标事件处理：**可以处理鼠标的移动、按下、释放和双击等事件，以便实现交互功能。

5. MapGraphicItem类
   MapGraphicItem 类是一个用于地图显示和交互的主要图形项。它是一个继承自 QObject 和 QGraphicsItem 的类，是地图小部件中核心的图形项，负责管理地图的显示和交互，以及地图相关的逻辑处理。

这个类的作用主要有以下几点：

• **显示地图：**负责在地图小部件上绘制地图，并处理地图的显示逻辑。
• **地图交互：**处理鼠标事件（移动、点击、滚动等）和键盘事件，以实现地图的交互功能，如拖拽、缩放、选择区域等。
• **地图坐标转换：**提供方法将经纬度坐标转换为本地坐标，以及将本地坐标转换为经纬度坐标。
• **地图操作：**包括设置地图的缩放级别、旋转角度、地图类型等。
• **地图重绘：**在需要更新地图显示时，负责重新绘制地图。
• **地图逻辑：**处理地图的逻辑操作，如获取地图类型、设置当前位置、设置鼠标滚轮缩放类型等。

6. TrailItem类

用于在地图上显示路径轨迹的图形项，它可以根据传入的经纬度坐标和颜色刷，在地图上绘制路径。

7. UAVItem类

表示无人机（UAV）的图形项，用于在地图上显示无人机的位置、航向、速度等信息。可以根据无人机的位置和状态信息进行绘制，同时提供了一系列方法和信号，用于处理与无人机相关的逻辑。
这个类的作用主要有以下几点：

• **初始化无人机项：**通过构造函数初始化无人机项，传入地图图形项、父部件指针和无人机图片路径等参数。
• **设置无人机信息：**提供一系列方法，用于设置无人机的位置、NED（北东地）坐标、地面速度、空速、航向角速度等信息。
• **绘制无人机：**实现 paint 方法，用于在地图上绘制无人机。绘制时可以根据当前无人机的位置、航向等信息进行绘制。
• **边界矩形：**实现 boundingRect 方法，返回无人机项的边界矩形，用于在场景中定位无人机项的位置。
• **类型标识：**定义了 type 方法，返回无人机项的类型标识，方便识别无人机项。
• **信号与槽：**提供多个槽函数，用于处理无人机位置更新、透明度设置等操作。还定义了一些信号，用于与其他部件进行通信，如当无人机达到航点时发出信号等。

8. WayPointItem类

表示航点的图形项，用于在地图上显示航点的位置、描述和相关信息。可以根据航点的位置和状态信息进行绘制，同时提供了一系列方法和信号，用于处理与航点相关的逻辑。
这个类的作用主要有以下几点：

• **初始化航点项：**提供多个构造函数，用于初始化航点项，可以传入航点的经纬度坐标、海拔高度、描述信息等参数。
• **设置航点信息：**提供一系列方法，用于设置和获取航点的描述、是否到达、航点编号、经纬度坐标、海拔高度等信息。
• **绘制航点：**实现 paint 方法，用于在地图上绘制航点的图标，并根据航点是否到达以及是否显示航点编号进行绘制。
• **边界矩形：**实现 boundingRect 方法，返回航点项的边界矩形，用于在场景中定位航点项的位置。
• **类型标识：**定义了 type 方法，返回航点项的类型标识，方便识别航点项。

五.主程序结构

├── UAVMapDemo
├── UAVMapDemo.pro
├── main.cpp （程序入口：加载样式表）
├── mainwindow.h （主界面，没什么操作）
├── mainwindow.cpp
├── mainwindow.ui
├── 3rdparty (包括opmapcontrol的头文件和库文件）
│ ├── opmapcontrol
│ │ └── include
│ │ └── MinGW
├── MapControl
│ ├── MapControl.pri
│ ├── MapWidget.h （继承OPMapWidget，调用opmapwidget相关接口实现地图和无人机操作）
│ ├── MapWidget.cpp
│ ├── UAS_types.h （存放一些数据类型和转化）
│ ├── UAS_types.cpp
├── Robot
│ ├── Robot.pri
│ ├── uavmanagerwidget.h （无人机地面站界面，实现模型飞行、起飞、降落等接口）
│ ├── uavmanagerwidget.cpp
│ ├── uavmanagerwidget.ui
│ ├── mapsetmiddleform.h （一个小界面，不用关心）
│ ├── mapsetmiddleform.h
│ ├── mapsetmiddleform.h
├── res
│ ├── image （图片资源）
│ ├── styleSheet （样式资源）
│ │ └── default.qss

六.程序源码主要部分说明

1. pro文件

添加opmapcontrol相关头文件和库文件

CONFIG(debug, debug|release){win32-g++ {}else:msvc {}
}
else {win32-g++ {INCLUDEPATH += $$PWD/3rdparty/opmapcontrol/include/mapwidgetLIBS += -L$$PWD/3rdparty/opmapcontrol/MinGW -lopmapwidget}else:msvc {}
}

2. UAVManagerWidget 无人机地面站界面

initWidget() ： 新建一个配置文件，存放经纬度、home点经纬度、缩放比例、添加一个无人机类，编号为0，不显示无人信息，设置无人机的位置为home位置。
handleUISignals() : 处理界面上的一些ui信号，加了一个定时器，用于模拟飞行。
flySimulation() : 模拟飞行，随机经纬度。

void UAVManagerWidget::initWidget()
{m_mapSetForm = new MapSetMiddleForm();m_mapSetForm->setRobotBtnName(u8"无人机");m_conf = new QSettings("./MapControl/data/UAV.ini", QSettings::IniFormat);int zoom;m_homeLat = m_conf->value("mapWidget_home_lat", 34.257287).toDouble();m_homeLng = m_conf->value("mapWidget_home_lng", 108.888931).toDouble();m_uavLat = m_homeLat;m_uavLng = m_homeLng;zoom = m_conf->value("lastZoom", 13).toInt();internals::PointLatLng p(m_homeLat, m_homeLng);ui->widget_map->SetCurrentPosition(p);ui->widget_map->SetZoom(zoom);ui->widget_map->setConf(m_conf);uav = ui->widget_map->AddUAV(0);uav->SetNumber(0);uav->SetShowUAVInfo(false);uav->SetMapFollowType(mapcontrol::UAVMapFollowType::Types::CenterMap);uav->SetUAVPos(p, 10);
}void UAVManagerWidget::handleUISignals()
{// 连接connect(ui->btn_connect, &QPushButton::clicked, this, &UAVManagerWidget::connectUav);// 起飞connect(ui->btn_takeoff, &QPushButton::clicked, this, &UAVManagerWidget::uavTakeoff);// 降落connect(ui->btn_land, &QPushButton::clicked, this, &UAVManagerWidget::uavLand);// 返回connect(ui->btn_back, &QPushButton::clicked, this, &UAVManagerWidget::uavGoHome);// planconnect(ui->btn_plan, &QPushButton::clicked, this, &UAVManagerWidget::flyByWaypoint);// 地图中心点connect(ui->btn_home, &QPushButton::clicked, this, [=]() {m_mapSetForm->setCurrentPos(ui->widget_map->CurrentPosition().Lng(),ui->widget_map->CurrentPosition().Lat());QPoint buttonPos = ui->btn_home->mapToGlobal(ui->btn_home->rect().center());int dialogX = buttonPos.x() + ui->btn_home->width() - 15;int dialogY = buttonPos.y() - m_mapSetForm->height() / 2;m_mapSetForm->showWidget(QPoint(dialogX, dialogY));});// 置于homeconnect(m_mapSetForm, &MapSetMiddleForm::signal_setHome, this, [=]() {ui->widget_map->SetCurrentPosition(internals::PointLatLng(m_homeLat, m_homeLng));});// 置于无人机connect(m_mapSetForm, &MapSetMiddleForm::signal_setRobot, this, [=]() {if (uav) {ui->widget_map->SetCurrentPosition(internals::PointLatLng(m_uavLat, m_uavLng));}});// 置于自定义中心connect(m_mapSetForm, &MapSetMiddleForm::signal_setCustom, this, [=](double lng, double lat) {if (uav) {ui->widget_map->SetCurrentPosition(internals::PointLatLng(lat, lng));}});// 无人机超出home设定安全范围connect(uav,SIGNAL(UAVLeftSafetyBouble(internals::PointLatLng)),this,SLOT(uavWarnning(internals::PointLatLng)));// 用于模拟飞行的定时器，随机生成无人机位置timer = new QTimer(this);connect(timer, SIGNAL(timeout()), this, SLOT(flySimulation()));// 模拟飞行按钮connect(ui->btn_simFly, &QPushButton::clicked, this, [=]() {if (ui->btn_simFly->isChecked()) {timer->start(100);} else {timer->stop();}});
}void UAVManagerWidget::flySimulation()
{m_uavLat += 0.000001;m_uavLng += QRandomGenerator::global()->bounded(0.000001) - 0.000005;internals::PointLatLng ll(m_uavLat, m_uavLng);uav->SetUAVPos(ll, 10);
}

3. MapWidget 地图窗口，继承OPMapwidget。

MapWidget() : 构造函数,选择必应地图，其他的需要科学上网。

MapWidget::MapWidget(QWidget* parent): mapcontrol::OPMapWidget(parent)
{m_conf = NULL;configuration->SetAccessMode(core::AccessMode::CacheOnly);configuration->SetTileMemorySize(200);configuration->SetCacheLocation("./data/");SetZoom(4);SetMinZoom(4);// 地图选择必应SetMapType(MapType::BingHybrid);// 显示罗盘SetShowCompass(true);// set initial valuesm_bSelectArea = 0;m_pSelectArea1.SetLat(-9999);m_pSelectArea1.SetLng(-9999);m_pSelectArea2.SetLat(-9999);m_pSelectArea2.SetLng(-9999);m_homeShow = 1;m_homeAlt = 440;m_homePos.SetLat(-9999);m_homePos.SetLng(-9999);m_homeSafearea = 100;m_flightHeight = 20;// setup menussetupMenu();
}

*setConf(QSettings conf) : **配置文件设置，地图加载接口（服务器、缓存）、地图类型、缓存位置、home点和安全区域设置。

void MapWidget::setConf(QSettings* conf)
{m_conf = conf;if (m_conf == NULL)return;// map type & access mode{MapType::Types mapType;core::AccessMode::Types accessMode;QString cacheLocation;// load settingsaccessMode = (core::AccessMode::Types)m_conf->value("mapWidget_accessMode",(int)(core::AccessMode::CacheOnly)).toInt();mapType = (MapType::Types)m_conf->value("mapWidget_mapType",(int)(MapType::GoogleSatellite)).toInt();cacheLocation = m_conf->value("mapWidget_cacheLocation", "./MapControl/data/").toString();// set configurationsconfiguration->SetAccessMode(accessMode);configuration->SetCacheLocation(cacheLocation);SetMapType(mapType);// set accessMode actionsif (accessMode == core::AccessMode::ServerAndCache) {m_actMapAccess_ServerAndCache->setChecked(true);m_actMapAccess_Cache->setChecked(false);} else if (accessMode == core::AccessMode::CacheOnly) {m_actMapAccess_ServerAndCache->setChecked(false);m_actMapAccess_Cache->setChecked(true);}}// home & safe area{m_homeShow = m_conf->value("mapWidget_home_show", m_homeShow).toInt();m_homePos.SetLat(m_conf->value("mapWidget_home_lat", m_homePos.Lat()).toDouble());m_homePos.SetLng(m_conf->value("mapWidget_home_lng", m_homePos.Lng()).toDouble());m_homeAlt = m_conf->value("mapWidget_home_alt", m_homeAlt).toDouble();m_homeSafearea = m_conf->value("mapWidget_home_safeArea", m_homeSafearea).toDouble();m_flightHeight = m_conf->value("mapWidget_flightHeight", m_flightHeight).toDouble();if (m_homeShow) {this->SetShowHome(true);this->Home->SetCoord(m_homePos);this->Home->SetAltitude((int)(m_homeAlt));this->Home->SetSafeArea((int)(m_homeSafearea));m_actHome_ShowHide->setChecked(true);} else {m_actHome_ShowHide->setChecked(false);}}
}

**setupMenu() **: 右键菜单，提供对地图、航点、home、安全区域等各个功能的接口。

int MapWidget::setupMenu(void)
{// setup actionsm_actMapType = new QAction(tr(u8"地图类型"), this);connect(m_actMapType, SIGNAL(triggered()), this, SLOT(actMapType_SelectMap()));m_actMapAccess_ServerAndCache = new QAction(tr(u8"服务器和缓存"), this);m_actMapAccess_ServerAndCache->setCheckable(true);m_actMapAccess_ServerAndCache->setChecked(false);connect(m_actMapAccess_ServerAndCache, SIGNAL(triggered()),this, SLOT(actMapAccess_ServerAndCache()));m_actMapAccess_Cache = new QAction(tr(u8"缓存"), this);m_actMapAccess_Cache->setCheckable(true);m_actMapAccess_Cache->setChecked(true);connect(m_actMapAccess_Cache, SIGNAL(triggered()), this, SLOT(actMapAccess_Cache()));m_actWaypoint_add = new QAction(tr(u8"航点添加"), this);connect(m_actWaypoint_add, SIGNAL(triggered()), this, SLOT(actWaypoint_add()));m_actWaypoint_del = new QAction(tr(u8"航点删除"), this);connect(m_actWaypoint_del, SIGNAL(triggered()), this, SLOT(actWaypoint_del()));m_actWaypoint_edit = new QAction(tr(u8"航点编辑"), this);connect(m_actWaypoint_edit, SIGNAL(triggered()), this, SLOT(actWaypoint_edit()));m_actWaypoint_clear = new QAction(tr(u8"航点清除"), this);connect(m_actWaypoint_clear, SIGNAL(triggered()), this, SLOT(actWaypoint_clear()));m_actWaypoint_save = new QAction(tr(u8"航点保存"), this);connect(m_actWaypoint_save, SIGNAL(triggered()), this, SLOT(actWaypoint_save()));m_actWaypoint_load = new QAction(tr(u8"航点加载"), this);connect(m_actWaypoint_load, SIGNAL(triggered()), this, SLOT(actWaypoint_load()));m_actSelectArea_beg = new QAction(tr(u8"选择区域起点"), this);connect(m_actSelectArea_beg, SIGNAL(triggered()), this, SLOT(actSelectArea_beg()));m_actSelectArea_end = new QAction(tr(u8"选择区域终点"), this);connect(m_actSelectArea_end, SIGNAL(triggered()), this, SLOT(actSelectArea_end()));m_actSelectArea_clear = new QAction(tr(u8"选择区域清除"), this);connect(m_actSelectArea_clear, SIGNAL(triggered()), this, SLOT(actSelectArea_clear()));m_actHome_Set = new QAction(tr(u8"设置Home"), this);connect(m_actHome_Set, SIGNAL(triggered()), this, SLOT(actHome_Set()));m_actHome_Safearea = new QAction(tr(u8"设置Home安全区域"), this);connect(m_actHome_Safearea, SIGNAL(triggered()), this, SLOT(actHome_Safearea()));m_actHome_ShowHide = new QAction(tr(u8"显示/隐藏Home"), this);m_actHome_ShowHide->setCheckable(true);m_actHome_ShowHide->setChecked(true);connect(m_actHome_ShowHide, SIGNAL(triggered()), this, SLOT(actHome_ShowHide()));m_actCacheMap = new QAction(tr(u8"缓存地图"), this);connect(m_actCacheMap, SIGNAL(triggered()), this, SLOT(actCacheMap()));m_actTrail_clear = new QAction(tr(u8"清除轨迹"), this);connect(m_actTrail_clear, SIGNAL(triggered()), this, SLOT(actClearTrail()));// setup menum_popupMenu = new QMenu("Menu");QMenu* menuAccessMode = m_popupMenu->addMenu(u8"接口类型");m_popupMenu->addAction(m_actMapType);m_popupMenu->addAction(m_actCacheMap);m_popupMenu->addSeparator();m_popupMenu->addAction(m_actTrail_clear);m_popupMenu->addSeparator();m_popupMenu->addAction(m_actWaypoint_add);m_popupMenu->addAction(m_actWaypoint_del);m_popupMenu->addAction(m_actWaypoint_edit);m_popupMenu->addAction(m_actWaypoint_clear);m_popupMenu->addAction(m_actWaypoint_save);m_popupMenu->addAction(m_actWaypoint_load);m_popupMenu->addSeparator();m_popupMenu->addAction(m_actSelectArea_beg);m_popupMenu->addAction(m_actSelectArea_end);m_popupMenu->addAction(m_actSelectArea_clear);m_popupMenu->addSeparator();m_popupMenu->addAction(m_actHome_Set);m_popupMenu->addAction(m_actHome_Safearea);m_popupMenu->addAction(m_actHome_ShowHide);menuAccessMode->addAction(m_actMapAccess_ServerAndCache);menuAccessMode->addAction(m_actMapAccess_Cache);return 0;
}

七.最终效果

八.源代码链接

https://download.csdn.net/download/ever__ever/89291117?spm=1001.2014.3001.5503