简介GMapDownloader是一套基于C#语言、GMap.Net地图库与WPF界面框架构建的离线地图下载工具主要面向需要离线浏览地图的开发者、户外工作者与普通地图使用者。项目在GMap.Net基础上做了深度二次开发新增缓存瓦片、高德地图图源、离线瓦片访问等能力可自动或手动将在线地图保存到本地形成离线地图数据集方便用户预先下载指定区域后随时查看。资源包为zip格式共565个文件约48.8MB以C#源码、动态链接库、XML配置、PNG图片为主还包含调试符号、缓存文件、解决方案与工程配置等结构清晰适合二次开发与学习。包内提供完整工程源码、WPF界面资源XAML、依赖库及相关构建文件读者可对照研究瓦片缓存、图源切换、离线加载等模块的实现思路也可基于此项目快速搭建自己的地图应用。目前已有537人学习下载对有一定C#基础、希望掌握地图组件应用与离线方案设计的开发者有较高参考价值。 干GIS这行或者经常跑外业、做项目汇报的朋友应该都体会过一件事需要一张连续的高清地图底图时截图工具一屏一屏拼拼到怀疑人生出野外想提前备一套离线影像和路网翻遍软件找不到趁手的。GmapDownloader这个工具就是圈子里传了很多年的一个绿色小工具通常以zip压缩包形式分发解压即用专门用来批量下载在线地图瓦片并拼成完整地图。它解决的核心问题就是把在线地图上你框选的那块区域按指定级别整整齐齐下载到本地再拼接成一张带坐标信息的大图方便离线浏览、二次制图或者直接塞进GIS软件里用。这篇文章我就从工具原理讲起再完整走一遍实操流程最后把我踩过的坑和排查经验一并列出来。如果你正在找一个能批量下载瓦片、又不想被大型商业软件绑定的方案这篇应该能帮你省不少时间。1. 这个工具解决什么问题以及为什么非它不可1.1 先搞懂地图瓦片片片拼接的地图世界在线地图服务不管是Google地图、OpenStreetMap还是国内的各种图商在屏幕上显示的地图并不是一整张大图而是由无数张256x256像素的小方块拼起来的。学术界管这个叫“瓦片金字塔”最顶层z0只有一张瓦片覆盖全球往下每放大一级瓦片数量在长宽方向各翻一倍总面积变成4倍。想象一下把一张世界地图裁成4份、16份、64份……裁得越细每张瓦片展示的区域越小但放大后的清晰度越高。页面上每次加载地图实际是浏览器根据当前视野范围和缩放级别动态计算出需要哪些瓦片然后逐个发请求拉取。手动截图之所以费劲一是因为要来回拖动让瓦片全部加载完窗口覆盖不全二是因为截完的图没有地理坐标信息后续想放到ArcGIS、QGIS里做叠加分析还得手动配准精度还差。GmapDownloader这类工具做的事情就是把“根据范围算瓦片编号、批量下载、拼接导出”这一整套流程自动化。1.2 GmapDownloader的核心能力与适用人群我最早接触这个工具时它的界面还很简陋但核心功能已经相当能打。你框选一个矩形范围选好想要下载的缩放级别它就能从地图服务上把对应的瓦片全部拉下来。下载完成后你可以选择把瓦片直接存成文件夹数据量大但灵活也可以拼接输出成一张完整的图片或者带地理坐标的GeoTIFF。适合谁用呢我总结下来大概是这几类外业工作人员出野外之前把工作区卫星影像和路网下载到本地离线也能看。GIS数据生产人员需要把在线地图作为底图叠加自己的专题数据生成用于打印或汇报的高清图。地图开发初学者想理解瓦片原理、研究地图切片机制的技术爱好者。工程勘察、规划行业从业者需要一张大范围、高清晰度的现状影像图做参考底图。它和BIGEMAP这类商业软件相比优点是轻量、绿色免安装、没有复杂的授权机制缺点是界面老、部分功能需要手动配置。但核心的“框选-下载-拼接”链路它做得非常扎实。2. 核心原理拆解瓦片编号、坐标换算与级别选择2.1 z/x/y瓦片编号规则一分钟看懂URL想用好任何一款瓦片下载器第一件事就是看懂瓦片URL。在线地图的瓦片URL长这样https://mt1.google.com/vt/lyrssx512y345z10在这个URL里z是缩放级别x和y是瓦片编号。具体规则是全球地图被投影成一个正方形平面x从西向东递增y在Google的切片方案里从北向南递增。z0时全球只有一张瓦片编号0,0z1时划分为4张x和y的取值范围都是0和1zn时x和y的取值范围是0到2^n - 1。这里有个特别容易踩的坑不同地图服务对y轴的定义不一样。Google的瓦片方案XYZy轴从北向南而早期TMS标准里y轴从南向北编号方向是反的。如果你在拼接或者写代码处理瓦片时把两种方案混用拼出来的图会上下颠倒位置完全对不上。好在GmapDownloader内部一般会把这个问题封装掉但你自己手工操作瓦片时一定要区分清楚。2.2 经纬度与瓦片编号怎么换算理解了瓦片编号下一个问题就是给定一个经纬度坐标如何知道它落在哪张瓦片上。核心用到的投影是Web MercatorEPSG:3857这也是目前所有在线地图默认的坐标系。换算公式在网上有很多版本我建议用下面这个简洁写法import math def lonlat_to_tile(lon, lat, z): n 2 ** z xtile (lon 180.0) / 360.0 * n lat_rad math.radians(lat) ytile (1.0 - math.asinh(math.tan(lat_rad)) / math.pi) / 2.0 * n return int(xtile), int(ytile)第二行可能有人看着眼生asinh(tan(lat_rad))其实就是ln(tan(lat) sec(lat))的另一种写法两者等价。要注意的是y方向用了1.0 -这意味着纬度越高y值越小正好对应Google方案里y从北向南递增。与之相对的逆运算从瓦片编号得到经纬度范围也值得写一下因为你下载完瓦片之后需要知道自己到底下载了哪块区域def tile_to_lonlat(x, y, z): n 2 ** z lon_min x / n * 360.0 - 180.0 lon_max (x 1) / n * 360.0 - 180.0 lat_min_rad math.atan(math.sinh(math.pi * (1 - 2 * (y 1) / n))) lat_max_rad math.atan(math.sinh(math.pi * (1 - 2 * y / n))) return (lon_min, math.degrees(lat_min_rad), lon_max, math.degrees(lat_max_rad))这两段代码我建议收藏起来。很多时候下载完发现影像位置不对用这个反算一下瓦片覆盖范围立刻就能判断是不是坐标出了问题。2.3 缩放级别选多少不只是清晰度问题确定缩放级别zoom level是整个下载过程中最容易纠结的环节。级别越高单张瓦片呈现的地面范围越小细节越丰富但瓦片总量会呈指数级增长。我给自己定了一个基本的判断标准级别大致地面分辨率实际效果z10约150米/像素能看清城市群、山脉走向z13约19米/像素能看清城镇路网骨架z15约4.8米/像素能看清小区、主干道、地块边界z17约1.2米/像素能看清房屋、田间小路外业常用z19约0.3米/像素单栋建筑轮廓清晰接近影像源极限这里讨论的是Web Mercator投影下赤道附近的分辨率纬度越高地面上实际对应的尺寸会被拉大。选级的关键不是一味追求最高而是匹配用途城市级外业调查z17到z18已经很够用做区域概况图z14到z15就能满足如果你要下载省级甚至国家级范围那就要慎重因为瓦片数量会非常惊人。说个具体数字帮大家建立直观感受。假设你下载一块约20公里见方的城市区域z15时大约需要172x172张瓦片合计约3万张z17时长宽各放大4倍瓦片数变成约55万张z19时瓦片数突破880万张。每张瓦片按平均40KB估算z19的数据量会超过300GB绝大多数场景根本用不到也下载不现实。所以我的建议是先按用途确定最低可用级别再按需上调一级不要一开始就拉满。3. 实操全流程从一个zip包到离线地图成果3.1 解压、运行与下载范围框选GmapDownloader通常以一个zip压缩包的形式分发解压后直接运行主程序即可不需要安装。双击运行后主窗口左右结构左边是参数区和图层控制右边是地图预览。这类老工具内部一般内置了一个简易浏览器能显示在线地图供你框选范围操作手感跟网页地图类似。框选范围时我建议注意两件事。一是先用小比例尺定位再用滚轮放大到目标区域最后框选这样可以避免误选到不相关的区域。二是框选尽量在你想要的最高级别上进行因为下载范围是经纬度矩形如果你在低级别框选边界会有明显偏差下载出来的图可能比你预期的范围偏大或偏小。选定范围后程序会显示该范围在不同级别下对应的瓦片数量。这里提前预判一下如果数字是几十万甚至上百万别急着下载先缩小范围或者降低级别否则后面的下载时间会非常长。3.2 下载参数设置并发、延迟与重试点击开始下载之前有几个参数一定要先调好这直接决定下载成败和效率。并发线程数。这个工具默认的并发数可能不适合所有网络环境。理论上并发越高下载越快但地图服务端通常会有请求频率限制并发过高容易触发403或者429状态码。我实测下来家用宽带环境下并发数设置在5到10比较稳妥如果你在稳定内网或者专线环境可以适当调到16左右再多就容易出问题。请求延迟。每次请求之间加一个毫秒级的延迟能有效降低被服务端识别为恶意请求的概率。我通常设置为50到200毫秒下载速度差别不大但稳定性明显提升。重试次数。网络波动导致个别瓦片请求失败非常正常。建议开启自动重试并把重试次数设为3到5次重试间隔可以短一些。这个功能在瓦片数量大的时候特别重要不然下载完还要手动补漏太痛苦。设置完这些参数点击开始下载程序就会按队列批量拉取瓦片并实时显示进度。下载过程中尽量别去做别的占满带宽的事否则容易出现大量超时失败。3.3 拼接导出与成果校验瓦片下载完成后下一步就是拼接导出。GmapDownloader会提供一个拼接功能把所有瓦片按位置关系拼成一张大图。导出格式常见的有两种一是普通PNG/JPG图片优点是非常通用缺点是图片本身不带地理坐标二是GeoTIFF或者PNGTFW文件这能在图片里写入地理参考信息放进ArcGIS、QGIS里能自动定位到正确位置。这里要提醒一个关键点如果你做的是测绘或者后续需要量测、叠加分析的工作务必导出带坐标信息的格式或者让工具同时生成TFW世界文件。TFW文件本质上是一个六参数仿射变换描述记录了图上任意一个像素对应的真实世界坐标没有它一张大图就只是一张图无法和GIS数据对齐。拼接完成后我的习惯是把成果放进QGIS里叠一层矢量路网数据目视检查一下道路、水系、建筑物边界是否吻合。如果偏移超过一个像素级别就要回到坐标系统排查具体见下一章。4. 常见问题速查与避坑经验4.1 下载中断、瓦片缺失怎么办瓦片下载过程中突然中断或者下载完后发现某些区域是灰色的空白块这是最常遇到的问题。原因一般有三种网络波动导致个别请求超时瓦片没拉下来。目标级别在该区域没有影像数据比如某些区域在高缩放级别下卫星影像不完整。地图源服务端临时限制触发了反爬机制。排查思路也很直接先看缺失瓦片是不是成片分布。如果是个别零散缺失优先补下载把对应瓦片的编号重新请求一遍即可。如果是整片缺失且切换不同级别也一样基本可以断定是该地图源在这个区域没有高精度数据只能换个地图源或者降低级别。我在实际工作中经常碰到这种情况Google影像在高级别下某些偏远区域精度不足换成其它地图源反而有更好的数据。4.2 拼接错位或坐标信息丢失怎么排查拼接出来的大图如果出现道路断头、建筑错层十有八九是瓦片y坐标方向或者坐标系混用导致的。我遇到过好几次类似问题最后的排查方法如下检查瓦片目录结构下载得到的瓦片如果是按z/x/y.png存放的先随机抽出几张用前面的逆运算函数算一下每张瓦片覆盖的经纬度范围看看是否连续、是否重叠、是否跳变。检查y轴方向把同一行瓦片纵向拼接如果图像是上下颠倒的就是工具用了TMS方案但拼接时按XYZ方案处理或者反过来。检查导出格式如果导出成PNG后发现没有任何坐标文件检查工具设置里是否勾选了生成TFW或者GeoTIFF没有就重新导出。另外还有一种隐蔽情况你用的地图源虽然是Web Mercator投影但某些第三方源的瓦片原点定义不一样导致同一z/x/y编号下实际覆盖位置不同。这种情况没啥好办法定位到具体源调整偏移参数或者换一个标准源。4.3 请求受限与多源对比经验下载过程中如果突然大面积出现403Forbidden或429Too Many Requests基本就是请求频率太高被服务端限制。破解思路不是什么高深的技巧就是“慢下来”把并发调到4到6延迟加到200到300毫秒等一下再继续。如果用的是共享IP或者公司出口也可能是同一出口的其他人触发了限制换一个网络环境试试。我在实际操作中还养成了一个习惯**同一个范围、同一个级别至少对比两个不同地图源的影像再决定用哪一份。**不同源之间可能拍摄时间不同、影像拼接处理不同甚至坐标偏移也有细微差别。以城市区域为例Googe卫星影像的近期性通常比较好但某些山区或者乡镇其它源反而更清晰。多源对比的过程其实就是把瓦片分别下载一遍影像质量一眼就能看出来。4.4 我的几条实操习惯最后分享几个我长期用下来觉得值得坚持的习惯下载前先算瓦片量再预估时间。瓦片量除以并发数再乘上单张瓦片耗时基本能算出总耗时。这个方法帮我避免了好几次“下载到一半发现时间不够”的尴尬。大范围下载分块处理。你框选的范围很大时不要一次性下载所有级别。先下载低级别全图再针对重点区域单独下载高级别这样既保证整体覆盖又控制数据量。定期查看下载日志。GmapDownloader这类工具一般会输出日志里面有失败瓦片的记录。下载完花一分钟扫一眼日志比事后发现缺图再补要省事得多。给下载好的瓦片按工程建目录。我习惯按项目名_日期_源_级别命名目录时间久了你就知道这个习惯有多重要。不然过两个月再翻文件夹几十个子目录根本分不清谁是谁。这个工具我用了很多年虽然界面朴素但核心逻辑直到今天依然靠谱。就像前面说的瓦片原理和坐标换算是它的根基也是你排查所有问题的总钥匙。把这套东西吃透无论是用GmapDownloader还是换其他下载器你都不会慌。本文还有配套的精品资源点击获取