使用指南
本章节详细介绍离线地图下载工具的各项功能与操作流程。
主界面概览
主界面由三个核心区域组成：
- 配置面板：设置瓦片源、缩放级别、并发数、导出方式、保存格式、坐标投影、地名叠加等参数
- 进度面板：显示下载进度条与「总计/成功/失败」计数
- 日志面板：实时输出下载与处理日志
状态标签
界面标题栏右侧显示两个状态标签：
授权状态
| 标签 | 颜色 | 含义 |
|---|---|---|
| 未激活 | 红色 | 未完成激活，无法下载 |
| 单次授权 | 蓝色 | 已激活单次授权，可完成一次下载 |
| 永久授权 | 绿色 | 已激活永久授权，长期可用 |
GDAL 状态
| 标签 | 颜色 | 含义 |
|---|---|---|
| 检测中... | 灰色 | 正在检测 GDAL 可用性 |
| GDAL 已就绪 | 绿色 | GDAL 可用，支持重投影 |
| GDAL 未安装 | 红色 | GDAL 不可用，仅可导出原始瓦片 |
GDAL 未安装时
当 GDAL 不可用时，「导出原始瓦片」方式仍可使用，其他需要重投影或格式转换的方式不可用。
配置项说明
瓦片源
选择卫星影像的来源，支持 ArcGIS 和天地图两种瓦片源。
缩放级别
设置下载瓦片的层级范围，范围 0-20。瓦片数量随级别呈指数增长，每增加 1 级，单层瓦片数约为上一级的 4 倍。
级别参考
| 级别 | 覆盖范围 | 典型用途 |
|---|---|---|
| 0-3 | 全球/大洲 | 世界地图 |
| 4-6 | 国家/省份 | 区域概览 |
| 7-10 | 城市/区县 | 城市规划 |
| 11-14 | 街道/街区 | 街道导航 |
| 15-18 | 建筑/道路 | 详细地图 |
| 19-20 | 单栋建筑 | 高精度应用 |
并发下载数
同时下载的瓦片数量，范围 1-20。建议默认值 6，网络良好可调至 10-12。
地名叠加
勾选后，下载时自动将中文地名注记叠加到卫星影像上。注记使用天地图中文注记瓦片，无论选择哪种底图源均可叠加。
下载范围
通过地图框选确定下载区域。点击「在地图上框选」按钮打开地图窗口（详见 地图框选）。
输出目录
选择下载结果的保存位置。点击「浏览」打开系统目录选择对话框。
下载流程
启动下载
配置完成后点击「开始下载」，按钮变为加载状态，下方出现进度面板与日志面板。
进度监控
- 进度条：百分比 = 已下载 / 总瓦片数
- 总计：本次任务的瓦片总数
- 成功：已成功下载的瓦片数
- 失败：下载失败的瓦片数（红色）
日志输出
日志面板实时输出任务启动信息、各级别下载进度、失败瓦片的详细信息、GDAL 处理阶段日志以及完成或取消提示。
日志颜色
- 白色文字：正常信息
- 红色文字：错误信息（如下载失败、GDAL 报错）
完成处理
下载完成后：
- 进度条变绿，显示 100%
- 弹出「下载完成！」成功提示
- 日志末尾显示「全部完成!」
- 「开始下载」按钮恢复可用状态
- 单次授权用户：授权自动标记为已使用，需重新激活
取消下载
下载过程中可随时点击「取消下载」，任务立即终止，临时目录被清理。