一、概述

本文主要通过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/mapwidget

            LIBS += -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);
    // plan
    connect(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));
    });
    // 置于home
    connect(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 values
    m_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 menus
    setupMenu();
}

*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 settings
        accessMode = (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 configurations
        configuration->SetAccessMode(accessMode);
        configuration->SetCacheLocation(cacheLocation);
        SetMapType(mapType);

        // set accessMode actions
        if (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 actions
    m_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 menu
    m_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