快速开始
本章节将带你用五分钟完成首次地图瓦片下载。
前置条件
第一步：启动应用
启动「离线地图下载工具」，主界面会显示配置面板。
检查状态
请确认界面顶部两个状态标签：
- 授权状态：显示「永久授权」或「单次授权」（绿色 / 蓝色）
- GDAL 状态：显示「GDAL 已就绪」（绿色）
若 GDAL 未就绪，重投影功能将不可用，但「原始瓦片」导出仍可使用。
第二步：框选下载范围
- 在「下载范围」行点击 「在地图上框选」 按钮
- 弹出独立的「地图框选」窗口，显示卫星影像底图
- 点击工具栏的 「开始框选」 按钮
- 在地图上按住鼠标左键拖拽，绘制一个矩形覆盖你想下载的区域
- 框选完成后，点击 「确认选择」 按钮
- 地图窗口自动关闭，主界面会显示已选范围坐标
坐标跳转
如需跳转到特定位置，在工具栏「坐标跳转」处输入经纬度，点击「跳转」即可定位。
第三步：配置下载参数
在主界面配置以下参数：
| 参数 | 推荐值 | 说明 |
|---|---|---|
| 瓦片源 | ArcGIS / 天地图 | 选择卫星影像来源 |
| 缩放级别 | 最小 1 / 最大 5 | 级别越高精度越高，瓦片数量呈指数增长 |
| 并发下载数 | 6 | 并发数越大下载越快，但可能触发服务器限流 |
| 导出方式 | 导出单个文件 | 首次使用推荐，输出一个完整的影像 |
| 保存格式 | JPEG(.jpg) | 体积小，适合卫星影像 |
| 坐标投影 | WGS84 经纬度投影 | 最通用的坐标系 |
| 地名叠加 | 按需开启 | 下载时叠加中文地名注记 |
瓦片数量
缩放级别每增加 1，瓦片数量约变为 4 倍。首次测试建议使用较低级别（如 1-5），熟悉流程后再尝试更高级别。
例如框选一个城市范围：
- 第 5 级：约几十块瓦片
- 第 10 级：约数千块瓦片
- 第 15 级：约数万块瓦片
第四步：选择输出目录
- 在「输出目录」行点击 「浏览」 按钮
- 在系统对话框中选择一个用于保存下载结果的文件夹
- 路径会显示在输入框中
目录选择
建议选择磁盘空间充足的目录。临时瓦片会先下载到系统临时目录，处理完成后再复制到输出目录。
第五步：开始下载
- 确认所有参数配置无误
- 点击 「开始下载」 按钮（绿色按钮）
- 界面下方会出现：
- 进度条：显示下载百分比与「总计/成功/失败」计数
- 日志面板：实时输出下载与处理日志
第六步：查看结果
下载完成后：
- 日志会显示
全部完成! - 弹出「下载完成！」成功提示
- 输出目录中生成对应文件
以「导出单个文件 + JPEG」为例，输出目录中会有一个 mosaic.jpg 文件，即为完整的地图影像。
取消下载
如需中止下载，点击 「取消下载」 按钮（红色按钮）：
- 已下载的临时瓦片会被清理
- 下载任务立即终止
- 界面恢复到可配置状态
常见问题
提示「请先激活软件」
下载按钮显示「请先激活软件」且无法点击。请完成 授权激活。
提示「GDAL 未安装」
无法执行重投影。请确认：
- 打包版应用内置 GDAL，正常情况下不会出现此提示
- 若在开发模式运行，需安装 GDAL 并配置
PATH
下载失败率高
- 降低「并发下载数」（如设为 3）
- 避开网络高峰期
- 检查网络是否能正常访问瓦片服务器
瓦片数量过多导致卡顿
- 降低最大缩放级别
- 缩小框选范围
- 分批次下载不同区域