🗺️ eSEEK 离线地图工场 使用说明书 · v2.1

适用于： GPS 手持机（YX04 / 兼容型号）
配合 GPS 定位项圈（GD03 / G3），实现离线地图下载、轨迹管理与动态追踪。

一、离线瓦片下载

在 eSEEK 离线地图工场中，您可以通过绘制矩形区域，下载 1～20 级的 Google 卫星瓦片，并打包为 .zip 文件。 下载完成后，将 ZIP 包部署至手持机，即可在无网络环境下查看高精度卫星地图。

1.1 绘制下载区域

1. 打开地图 — 页面中央为卫星地图，支持缩放与拖拽。
2. 使用绘图工具 — 点击地图左上角的 □ 矩形工具（绘制矩形图标），在地图上拖拽出一个矩形区域。
3. 确认区域 — 矩形绘制完成后，右侧控制面板的「离线瓦片下载」区域会自动更新：
   • 显示 范围面积（km²）
   • 显示 瓦片总数（所有级别合计）
   • 显示 预估大小（MB）
   • 显示 预计下载时间

1.2 选择级别与下载

1. 设置最高级别 — 在「📁 区域与级别」中，从下拉菜单选择最高级别（默认 20 级）。
   提示 级别越高，地图越精细，瓦片数量越多。
2. 输入名称前缀（可选） — 在「名称前缀」中输入标识文字，最终 ZIP 文件名格式为 前缀_随机字符_partN.zip。留空则仅使用随机字符。
3. 点击下载按钮 — 按钮上会显示瓦片总数，点击后系统会弹出确认框。
4. 选择保存目录 — 浏览器会弹出「选择文件夹」对话框，请选择一个本地目录用于保存所有 ZIP 分卷。
5. 等待下载完成 — 下载过程中会显示进度条、剩余时间与当前批次。每批最多 10,000 张瓦片，自动生成多个 partN.zip 文件。

1.3 清除矩形

点击「🗑️ 清除矩形」按钮可移除当前绘制的矩形区域，重置下载状态。 您也可以在地图上点击矩形，然后按键盘 Delete 键删除。

二、手持机部署指南 （关键步骤）

下载的 .zip 地图包需要复制到手持机（GPS 定位手持机，型号 YX04 等）的指定目录， 手持机才能在地图界面中加载离线地图。部署方式取决于手持机的系统版本。

2.1 ✅ 版本 ≥ 6.2.3（推荐）

此版本及以上的手持机支持直接读取 ZIP 压缩包，无需解压。 请将下载的 .zip 文件（文件名可自定义，手持机根据文件结构识别）复制到以下路径：

                    /cache/
                

                    /Android/data/com.kyf.bigdevice/files/bigdevice/cache/
                

2.2 ⚠️ 版本 ＜ 6.2.3（旧版）

旧版手持机不支持直接读取 ZIP，需要将压缩包解压成一个独立的文件夹， 而不是将零散的文件直接放入 cache/ 目录。

                    /cache/
                

                    /Android/data/com.kyf.bigdevice/files/bigdevice/cache/
                

2.3 版本对照速查

三、轨迹管理与动画队列

支持导入 GPX 格式的轨迹文件，在地图上显示多条路径，并可加入动画队列进行时序或速度模式播放， 模拟猎犬/追踪对象的移动过程。同时支持导出轨迹截图和录制视频。

3.1 导入 GPX 轨迹

1. 点击「📂 导入轨迹文件 (多选)」 — 在弹出的文件选择器中，可一次选择多个 .gpx 文件。
2. 自动解析并显示 — 系统会解析 GPX 中的 <trkpt> 节点，提取经纬度与时间戳（如有）。每条轨迹会以随机颜色显示在地图上，起点 🚩 与终点 🏁 带有标记。
3. 查看轨迹列表 — 导入的轨迹会出现在「📍 轨迹管理 和 动画队列」的列表中，显示：
   • 轨迹名称（文件名）
   • 点数与里程（km / m）
   • ⏱️ 时间戳标记（如果 GPX 包含时间信息）

3.2 轨迹管理操作

在轨迹列表中，每条轨迹右侧提供以下操作：

• ☑ 显示/隐藏 — 勾选/取消复选框，控制该轨迹在地图上的可见性。
• ➕ 加入 / ✔️ 已加入 — 将轨迹加入「动画队列」或从中移除。加入队列后，按钮变为橙色并显示「✔️ 已加入」。
• 🗑️ — 删除该轨迹，同时自动从动画队列中移除。

批量操作： 点击「🗑️ 清除所有轨迹」可一次性移除所有轨迹与队列。

3.3 动画队列与播放

将轨迹加入队列后，可在「🎬 动画队列」区域查看排队顺序。点击「▶ 播放队列」即可开始动画。

• 速度控制 🐾 — 通过滑块或 − / ＋ 按钮调整播放速度（0.5x ~ 1000x）。
• 进度控制 — 拖动滑块或点击 ◀ / ▶ 按钮，可跳转至任意播放进度。
• 显示完整参考轨迹 — 勾选后，在播放过程中会以灰色虚线显示完整的原始路径作为参考。
• 播放 / 暂停 / 停止 — 点击「▶ 播放队列」开始，播放中按钮变为「⏸️ 暂停」；点击「⏹️ 停止」则完全停止并重置进度。

3.4 导出轨迹图

点击「🖼️ 导出轨迹图(图片)」按钮，系统会截取当前地图视图（包含已加载的卫星瓦片、所有可见轨迹、矩形区域等）， 生成 .png 图片并自动下载。适合用于报告或打印。

四、GPX 轨迹与手持机互通

手持机（YX04）记录的轨迹可导出为 GPX 文件，并导入到 eSEEK 离线地图工场进行分析与动画回放。 反之，工场中整理好的轨迹也可用于手持机的历史轨迹查看。

4.1 从手持机导出 GPX

1. 在手执机上进入 菜单栏 → 历史轨迹。
2. 选择需要导出的轨迹（支持 15 天 内历史记录）。
3. 点击右上角的 导出 按钮，选择 GPX 格式。
4. 导出的 GPX 文件会保存在手持机的 /download/ 文件夹中。
5. 通过 USB 数据线将手持机连接至电脑，从 /download/ 复制 GPX 文件到电脑，然后在 eSEEK 离线地图工场中导入。

4.2 将 GPX 导入工场

在工场页面中，点击「📂 导入轨迹文件 (多选)」，选择从手持机导出的 GPX 文件即可。 系统会保留原始时间戳（如有），用于时序动画播放。

五、反推下载区域

当您手持机中已有一些离线地图 ZIP 包，但不确定这些包覆盖了哪些地理范围时， 可使用「反推下载区域」功能：上传 ZIP 文件，系统自动解析其中 ≥18 级的瓦片，计算每个文件的实际覆盖边界， 并在地图上绘制彩色矩形，一目了然。

5.1 操作步骤

1. 点击「📂 选择多个 ZIP 压缩包」 — 在文件选择器中，选取一个或多个已下载的离线地图 ZIP 文件。
2. 自动扫描与解析 — 系统会逐个读取 ZIP，查找路径格式为 z/x_y.png 的瓦片文件，并筛选出 级别 ≥ 18 的瓦片。
3. 计算边界并绘制 — 对每个文件，系统根据其包含的最高级别瓦片，计算矩形边界（经纬度范围），并用不同颜色在地图上绘制矩形。
4. 查看详情 — 点击任意矩形，会弹出气泡显示：
   • 文件名
   • 最高级别
   • 瓦片数量
   • 边界范围（经纬度）

5.2 清除反推矩形

点击「🗑️ 清除反推矩形」按钮，可一键移除地图上所有由反推功能绘制的彩色矩形。

六、常见问题与故障排除

七、技术参数与支持