标题:Qt/C++超强悍地图组件/代码使用说明/要多简单有多简单
作者:liudianwu
日期:2025-04-21 09:05
内容:
## 一、前言说明
编写这个组件耗费了相当多的精力，从第一个版本算起来的话，前前后后花了有十年的时间，经历过十几年的风风雨雨，各种实际需求交织迭代，然后在2024年持续一整年的时间去重构，并在后期不断的增加不同的地图内核，从最开始只支持百度地图，到后面陆陆续续增加了高德地图、天地图、谷歌地图、leaflet开源地图的支持。
组件的设计初衷就是为了方便用户更容易使用，所以api接口设计必须简洁而且符合程序界的使用习惯，所以在这块也是打磨了很久，一开始代码文件比较少的时候，还支持就一个pri模块文件包含，后面又按照功能分类，地图下载单独一个目录，地图内核基类一个目录，地图子类实现一个目录，后面要增加新的地图内核，只需要新建一个子类继承基类即可。
## 二、代码使用
1. 将core_map（地图组件）/core_webview（浏览器组件）这两个组件目录拷贝到你的项目目录，并在pro中填写引入代码加入到你的项目中。$$PWD/../表示上级目录。
```cpp
include ($$PWD/../core_map/core_map.pri)
include ($$PWD/../core_webview/core_webview.pri)
```
2. 在pro中启用地图内核，比如百度地图内核对应需要在pro文件中增加一行定义DEFINES += baidux，天地图内核对应 DEFINES += tianx
3. 引入头文件。
```cpp
#include "webview.h"
#include "maphelper.h"
#include "mapobjbase.h"
```
4. 新建一个窗体，上面放一个布局，推荐用表格布局 gridlayout，可以放多个浏览器控件。
5. 实例化浏览器类和地图类。
```cpp
//实例化浏览器控件
WebView *webView = new WebView(this);
//加入到布局
webView->setLayout(ui->gridLayout);
//实例化地图类/参数2表示何种地图内核
MapObjBase *mapObj = MapHelper::getMapObj(this, MapCore_BaiDu);
//传入网页控件用于执行函数
mapObj->setWebView(webView);
//直接加载地图
mapObj->load();
//异步加载地图
//QMetaObject::invokeMethod(mapObj, "load", Qt::QueuedConnection);
```
6. 所有地图相关的函数接口在MapObjBase类中，可以打开mapobjbase.h查看具体说明。
7. 地图中大部分的功能都是通过执行js函数来触发，比如添加标注、添加折线图等。这些必须严格按照提供的js函数名称和参数来执行。对应示例都提供了相关的调用方法。
8. 部分函数接口。
```cpp
QString js;
//设置地图级别(值越大放大/越小缩小)
js = "setZoom ..