## 一、前言

网上其实有很多各种各样的离线地图下载器，大部分都是要收费的，免费的要么是限制了下载的瓦片数量或者级别，要么是下载的瓦片图打上了水印，看起来很难看，由于经常需要用到离线地图，摆脱这个限制，特意花了点时间重新研究了瓦片地图的原理，做了个离线地图下载器，其实瓦片地图下载没有那么复杂，其实就是从开放的几个服务器地址组建要请求的瓦片地图的地址，发送请求以后会自动将图片返回给你，你只需要拿到图片数据保存成图片即可。

瓦片地图下载流程步骤如下：

1. 获取可视区域或者行政区域的范围

2. 拿到区域的左下角右上角经纬度坐标

3. 根据层级数计算对应层级的瓦片数

4. 自动生成下载瓦片地图的地址并发出请求

5. 解析收到的数据保存成图片

6. 更新对应界面的下载数量和进度

7. 可选择对应保存的目录、全选层级、中途停止下载等

8. 可选择是下载街道图还是卫星图等

## 二、功能特点

1. 多线程同步下载多级别瓦片地图，不卡界面。

2. 内置多个离线地图下载请求地址，自动随机选择一个发送请求。

3. 下载地图类型同时支持街道图和卫星图。

4. 自动计算可视区域或者行政区域的下载瓦片数量。

5. 下载的级别可以自定义范围和选择。

6. 每个瓦片下载完成都发送信号通知，参数包括下载用时。

7. 可设置下载最大超时时间，超过了则丢弃跳到下一个下载任务。

8. 实时显示下载进度，以及当前级别已经下载的瓦片数和总瓦片数。

9. 下载过程中可以停止下载，下载完成自动统计总用时。

10. 内置经纬度和屏幕坐标互相转换函数。

11. 目前支持百度地图，其他地图比如谷歌地图、腾讯地图、高德地图可以定制。

12. 函数接口友好和统一，使用简单方便，就一个类。

13. 支持任意Qt版本、任意系统、任意编译器。

## 三、体验地址

国内站点：[https://gitee.com/feiyangqingyun](https://gitee.com/feiyangqingyun)

国际站点：[https://github.com/feiyangqingyun](https://github.com/feiyangqingyun)

## 四、效果图

## 五、相关代码

void MapDownload::download(const QString &url, const QString &dirName, const QString &fileName, int zoom) {     if (url.isEmpty()) {         return;     }      //启动计时     QTime time;     time.start();      //先判断文件夹是否存在,不存在则新建     QDir dir(dirName);     if (!dir.exists()) {         dir.mkpath(dirName);     }      //局部的事件循环,不卡主界面     QEventLoop eventLoop;     QNetworkReply *reply = manager->get(QNetworkRequest(QUrl(url)));     connect(reply, SIGNAL(finished()), &eventLoop, SLOT(quit()));      //设置下载超时     QTimer timer;     connect(&timer, SIGNAL(timeout()), &eventLoop, SLOT(quit()));     timer.setSingleShot(true);     timer.start(timeout);     eventLoop.exec();      bool error = false;     if (reply->bytesAvailable() > 0 && reply->error() == QNetworkReply::NoError) {         //读取所有数据保存成文件         QByteArray data = reply->readAll();         QFile file(dirName + fileName);         if (file.open(QFile::WriteOnly | QFile::Truncate)) {             file.write(data);             file.close();         }     } else {         //可以自行增加下载失败的统计         error = true;         qDebug() << TIMEMS << "下载出错" << reply->errorString();     }      int useTime = time.elapsed();     emit finsh(url, fileName, zoom, useTime, error); }