## 一、前言说明
搞地图软件
开发很多年，遇到过各种形形色色的需求，包括之前中东的用户，需要中东的英文地图，而且还要离线支持，后面搞了个天地图杂交谷歌离线瓦片完成的。最近又遇到个新的需求，那就是希望天地图能够支持21级别的瓦片地图，查阅了官方文档资料，天地图默认只支持到18级别的，这就难搞了，后面尝试了把缩放级别最大级别设置21，发现比例尺是可以缩放的，也就是功能是具备的，只是
没有瓦片地图
文件，也就是卡在在线的瓦片地图文件，天地图的服务器只提供到了18级别，这是源头的
问题，那如果换成离线的呢，之前就已经把天地图离线js文件都搞定了，所有在线功能都能离线实现，所以赶紧试试离线瓦片的效果，发现也是最大只能到18级别，尽管已经放了21级别的离线瓦片地图文件，这就很奇怪了，缩放也能正常到21级别，瓦片文件也有，查看打印信息，居然没有去触发加载21级别的文件，所以上终极大法，打开离线js文件，全局搜maxZoom字样，找到了T.TileLayer = T.re.extend({等几处地方，居然写死了最大18，怪不得，原来代码中也限制了最大到18级别，而且离线瓦片的地方也有，在代码 = new T.TileLayer(的后面，写的也是18，只要把这几处全部改成21，运行一看真的有了，非常完美。
所以总结就是，天地图的本身底层是无所谓支持到多少层级的，只不过受限于瓦片的层级，在线的默认只能到18级别，离线的可以通过修改对应js文件来实现到更大的级别。
为什么有这个需求？因为无人机行业的兴起，现在无人机移动的时候，如果是18级别，移动个几米，看不清楚很大的变化，如果在21级别，那就很明显了，精度高多了。
## 二、效果图
## 三、代码使用
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。如果是vsqt环境，添加的位置大概在属性-》配置属性-》C/C++-》预处理器。
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_Tian);
//传入网页控件用于执行函数
mapObj->setWebView(webView);
//直接加载地图
mapObj->load();
//异步加载地图
//QMetaObject::invokeMethod(mapObj, "load", Qt::QueuedConnection);
```
6. 所有地图相关的函数接口在MapObjBase类中，可以打开mapobjbase.h查看具体说明。
7. 地图中大部分的功能都是通过执行js函数来触发，比如添加标注、添加折线图等。这些必须严格按照提供的js函数名称和参数来执行。对应示例都提供了相关的调用方法。
8. 部分函数接口。
```cpp
QString js;
//设置地图级别(值越大放大/越小缩小)
js = "setZoom(9)";
//街道图卫星图切换(0-街道图/1-卫星图/2-混合图)
js = "setMapType(1)";
//添加一个标记(北京那边)
js = QString("addMarker('测试点', '测试地址', '', '', 100, '%1', 2)").arg("116.475836,40.251114");
//最终通过浏览器控件执行
webView->runJs(js);
```
9. 浏览器组件使用示例。
```cpp
//实例化浏览器控件
WebView *webView = new WebView(this);
//加入到布局
webView->setLayout(ui->verticalLayout);
//打开网址
webView->load("https://www.baidu.com", "", "");
```
10. 特别强调，浏览器控件的加载，会自动根据布局的大小调整自己的大小，如果窗体还没
显示就调用了load，那么很可能地图出不来，原因是因为窗体没显示的时候，Qt中所有控件的尺寸都是不确定的，只有显示后才是确定的，所以一定要显示后再去加载地图。这种现象主要发生在需要主动调整浏览器控件尺寸的浏览器控件中，比如miniblink或者cef，如果是webkit或者webengine就不需要。
```cpp
int main(int argc, char *argv[])
{
QApplication a(argc, argv);
frmMain w;
w.show();
//下面表示异步加载地图
QMetaObject::invokeMethod(&w, "loadMap", Qt::QueuedConnection);
return a.exec();
}
```
## 四、相关地址
1. 国内站点：[
https://gitee.com/feiyangqingyun](https://gitee.com/feiyangqingyun)
2. 国际站点：[
https://github.com/feiyangqingyun](https://github.com/feiyangqingyun)
3. 个人作品：[
https://blog.csdn.net/feiyangqingyun/article/details/97565652](https://blog.csdn.net/feiyangqingyun/article/details/97565652)
4. 文件地址：[
https://pan.baidu.com/s/1ZxG-oyUKe286LPMPxOrO2A](https://pan.baidu.com/s/1ZxG-oyUKe286LPMPxOrO2A) 提取码：o05q 文件名：bin_map.zip
## 五、功能特点
### 5.1 地图功能
1. 支持多种地图内核，默认采用百度地图，可选高德地图、天地图、腾讯地图、谷歌地图等。
2. 同时支持在线地图和离线地图两种模式，离线地图方便在不联网的场景中使用。
3. 支持各种地图控件的启用，比如地图导航、地图类型、缩略图、比例尺、全景导航、实时路况、绘图工具、结果面板等。
4. 支持多种地图功能的动态启用禁用，比如地图拖曳、键盘操作、滚轮缩放、双击放大、连续缩放、地图测距等。
5. 提供众多js函数接口用于交互，参数极其丰富，能够想到的应用场景需求都有。
6. 统一的信号槽机制，地图中的结果统一信号发送出去，收到后根据type类型区分。
7. 支持地图交互，比如鼠标按下获取对应位置的经纬度。单击标注点弹出对应点的信息。
8. 支持添加标注、删除标注、移动标注、清空标注。
9. 标注点可以指定图标图片和尺寸，支持gif动图，支持指定以图片中心对齐还是底部中心对齐。可以设置旋转角度，带富文本提示信息。
10. 标注点事件支持单击发信号通知和自己弹框显示信息。
11. 提供地址转坐标和坐标转地址接口。
12. 支持各种图形绘制，包括折线图、多边形、矩形、圆形、弧线等。
13. 可显示悬浮的绘图工具栏，直接在地图上划线、标注点、矩形、圆形等。
14. 支持各种区域搜索，比如矩形区域、圆形区域，可以按照关键字匹配将搜索结果显示在地图中。
15. 可动态添加离线的行政区边界点
数据。可以搜索行政区划并获取该区域的边界点数据。数据可以保存到文件以便离线使用。
16. 支持点聚合功能，多个小标注点合并到一个大标注点，防止点密集导致交互不友好。
17. 可以添加海量点，每个点都可以单击获取对应坐标和信息。
18. 所有的覆盖物信息比如标注点、矩形、多边形、折线图等，都可以主动获取对应的信息比如坐标点和路径等。
19. 支持路径规划，支持公交路线、自驾路线、步行路线、骑行路线，不同查询支持不同策略，可选最少时间、最少换乘、不走高架等。
20. 路径规划结果可以显示在地图中，也可以获取到路径点坐标集合。这个数据可以保存到文件，以便发给机器人或者无人机做导航用来轨迹移动。
21. 可以设置不同的地图视图比如街道图、卫星图、混合图。
22. 可以设置不同的样式，比如午夜蓝、青草绿等样式风格。
23. 可以设置地图的旋转角度和倾斜角度。
24. 提供经纬度坐标纠偏转换功能，比如传入的GPS坐标需要转换到百度地图坐标或者高德地图坐标。各种坐标系转换全部离线函数，支持地球坐标系WGS-84、火星坐标系GCJ-02、百度坐标系BD-09之间的互相转换，涵盖了各种地图的坐标系。
25. 提供动态轨迹点移动功能，按照给定的经纬度坐标集合平滑移动。
26. 同时支持qwidget和qml，支持
编译到安卓系统运行。
### 5.2 其他功能
1. 提供离线地图下载模块，可以选择不同的地图内核比如百度地图或者谷歌地图，不同的地图类型比如下载街道图还是卫星图，不同的地图层级，多线程极速下载。
2. 表格行实时显示对应的瓦片下载进度，有下载超时时间，重试次数，每个瓦片下载完成都发送信号通知，参数包括下载用时。
3. 提供省市轮廓图下载模块，自动下载各个地区的轮廓图，保存到脚本文件或者文本文件。
4. 支持手动调整不同区域的轮廓边界，调整后可以主动获取调整后的边界点集合。
5. 提供动态点位示例，手动在地图上选点并添加标注，附带自定义的信息比如速度和时间等。
6. 提供海量点位示例，批量添加标注点、点聚合、海量点。用于测试环境中支持的最大点位性能。
7. 提供动态轨迹示例，在地图上鼠标按下选择起点和终点后，查询路线，获取路径轨迹点，模拟轨迹平滑移动。可以筛选数据将过多的路径点筛选到设定的点数。
8. 提供轨迹回放示例，按照指定的轨迹点列表回放，也可以导入轨迹点数据进行回放。同时支持在街道图、卫星图、混合图中回放轨迹。
9. 提供省市区域地图示例，采用echart组件，同时支持闪烁点图、迁徙图、区域地图、世界地图、仪表盘等。可以设置标题、提示信息、背景颜色、文字颜色、线条颜色、区域颜色等各种颜色。
10. 省市区域地图示例，内置世界地图、全国地图、省份地图、地区地图，可以精确到县，所有地图全部离线使用。可设置城市的名称、值、经纬度集合。
11. 内置通用浏览器组件，同时支持webkit/webengine/miniblink等内核。提供网页控件示例，演示打开网页和本地网页文件。
12. 支持任意Qt版本、任意系统、任意编译器。
