简介OruxMapsDesktop是一款面向户外运动爱好者的地图工具资源适用于徒步、骑行、登山等无网络覆盖的野外场景能够解决离线地图查看、GPS轨迹记录和航点规划等实际问题。压缩包共11个文件整体约2.86MB包含主程序jar包、Windows与Linux启动脚本bat/sh、配置文件xml以及多份说明文档txt结构清晰既可直接在桌面或Android环境运行也可作为学习地图数据格式与坐标转换的参考范例。已有1508人下载学习。资源支持离线地图、OpenStreetMap等多种地图源内置航点路点管理、GPX文件导入导出、高度计与电子罗盘功能并允许自定义地图层和夜间模式。配套的txt文档提供了坐标系统与Ozi2Orux等转换说明帮助用户快速掌握工具配置或结合自身需求扩展户外导航工作流适合中高级户外玩家和GIS爱好者深入使用。1. oruxmapsDesktop 到底在解决什么问题离线地图不是装个 App 就算完oruxmapsDesktop 这个标题乍一看以为是手机 App 的桌面皮肤其实它代表一类桌面工作流在电脑端把离线地图瓦片、GPX 轨迹、航点数据准备好再同步进手机里的户外导航应用。很多人出门前装好 App 就觉得万事大吉真到了山里才发现地图一片白因为离线地图包从来没进过手机。这个桌面端要解决的就是把下载地图、清洗轨迹、合并路书这些重复劳动搬到电脑上用脚本批量处理最后整包同步到设备。它适合经常在无网络环境下做穿越、需要长期维护轨迹库、又不想每次出门都被手机屏幕耗干电量的人。下面我按自己常用的方案把地图包制作、GPX 处理、设备同步、踩坑记录、增量更新一条龙讲透新手可以照做熟手可以重点看参数边界。2. 地图包制作下载瓦片、对齐坐标与打包成 OruxMaps 能识别的目录2.1 为什么非要用桌面端去下载地图手机端虽然也能缓存地图但屏幕一亮、锁屏、切换网络下载任务就断。更麻烦的是一次出行往往要覆盖几百平方公里的区域如果只沿着轨迹缓冲下载手机上的触控操作又很难精确框选。桌面端可以挂着重试跑一晚上有日志可查还能随时调整范围重新下载。所以我的习惯是所有地图资源在电脑上下好最后再统一同步。这不仅能节省手机电量还能在多个设备之间复用同一套地图包。常见做法是写一个瓦片下载脚本按照 OruxMaps 能识别的目录结构落地。OruxMaps 对瓦片地图的组织方式不复杂一个地图包就是一个目录里面按层级/横坐标/纵坐标.png存放瓦片同时需要一个地图描述文件告诉 App 这个包的投影方式和层级范围。你把图片放对了描述文件写明白了App 就能直接识别不需要额外导入数据库。2.2 最小可复现的瓦片下载脚本我们以一个标准的 Web Mercator 瓦片服务为例URL 模板通常长这样https://your-map-server/{z}/{x}/{y}.png。脚本要做四件事根据经纬度范围算出瓦片坐标范围检查本地是否已经存在瓦片用多线程并发下载最后按 z/x/y 目录保存。import math import os import requests from concurrent.futures import ThreadPoolExecutor # 经纬度转 Web Mercator 瓦片坐标 def deg_to_tile(lat, lon, zoom): n 2 ** zoom lat_rad math.radians(lat) x int((lon 180.0) / 360.0 * n) y int((1.0 - math.log(math.tan(lat_rad) 1 / math.cos(lat_rad)) / math.pi) / 2.0 * n) return x, y # 下载单张瓦片已有且非空就跳过 def download_tile(args): x, y, z, base_url, out_dir args path os.path.join(out_dir, str(z), str(x), f{y}.png) if os.path.exists(path) and os.path.getsize(path) 0: return (x, y, z, skip) os.makedirs(os.path.dirname(path), exist_okTrue) url base_url.replace({z}, str(z)).replace({x}, str(x)).replace({y}, str(y)) try: resp requests.get(url, timeout10) except requests.exceptions.RequestException as e: return (x, y, z, ferror:{e}) if resp.status_code 200: with open(path, wb) as f: f.write(resp.content) return (x, y, z, ok) return (x, y, z, fhttp_{resp.status_code}) # 批量下载一个经纬度矩形范围内的所有瓦片 def download_area(lat_min, lat_max, lon_min, lon_max, zoom, base_url, out_dir, workers4): x_min, y_min deg_to_tile(lat_max, lon_min, zoom) # 纬度越大 y 越小 x_max, y_max deg_to_tile(lat_min, lon_max, zoom) tasks [] for x in range(x_min, x_max 1): for y in range(min(y_min, y_max), max(y_min, y_max) 1): tasks.append((x, y, zoom, base_url, out_dir)) with ThreadPoolExecutor(max_workersworkers) as pool: results list(pool.map(download_tile, tasks)) for x, y, z, status in results: if status not in (ok, skip): print(fz{z} x{x} y{y} - {status})逻辑说明deg_to_tile是 Web Mercator 的标准换算公式注意纬度越高 y 值越小所以计算范围时要对 y 做一次排序。download_tile先查本地文件存在且大于 0 字节就跳过这已经是断点续传的雏形。最后用ThreadPoolExecutor并发下载并把失败任务打印出来方便排查。参数说明lat_min/lat_max是你要覆盖的纬度范围lon_min/lon_max是经度范围取值精确到小数点后 4 位就够定位一块山区zoom越大瓦片数量翻四倍一定要按实际用途选workers4是保守值网络稳定可以调到 8再高容易被瓦片服务限流。超时时间timeout10建议保留某些公共瓦片服务响应慢设短了误报失败设长了脚本会卡住。2.3 选 zoom 级别和坐标系的经验参数zoom 级别和用途直接相关我的经验值如下zoom 级别适合场景说明10区域概览适合看整体路线走向不适合看岔路口12村庄级路线能分辨乡镇道路徒步时作为底图够用14徒步小径常见户外线都能看清推荐大部分场景使用16营地周边细节单张瓦片覆盖范围很小只适合关键节点局部下载选 zoom 有一个简单原则能看清路就行不要贪图高缩放下那点清晰度。每提升一个 zoom 级别瓦片总数变成原来的 4 倍下载时间和手机存储占用都会迅速上涨。我一般先按 14 级下载整条线路再针对营地、补给点等重点区域补 16 级。坐标系是另一个容易忽略的点。瓦片服务通常基于 Web Mercator而 GPS 轨迹是 WGS84 经纬度这两者是兼容的。但有些地图源采用加密偏移坐标下载出来的底图会和 GPS 轨迹对不上整体偏几十米甚至几百米。遇到这种情况要么换标准的瓦片源要么在桌面端对轨迹做坐标纠偏。这里不建议对瓦片做纠偏因为会引入重采样变形效果很差。验证方式很简单用手机在同一位置打开地图再看定位点是否压在道路上偏差超过 20 米就要警惕。3. GPX 轨迹与航点处理清洗、压缩、合并不带脑子也能用的路书3.1 从户外记录仪导出的 GPX 为什么不能直接用户外记录仪导出的 GPX 文件常常带着一堆脏数据GPS 在峡谷里反复漂移产生偏离路线几百米的孤立点设备掉电导致轨迹中间突然跳一大段同样的路走了两遍轨迹被重复记录。这些问题直接放进 OruxMaps轻则距离统计虚高重则导航时把你带进错误方向。桌面端要做的事就是清洗去掉超出经纬度范围的无效点过滤掉漂移点删除距离过近的冗余点再统一编码和命名。这里有一个很常见的误解GPX 是 XML所以直接改文本就能清洗。实际上轨迹点分散在trkpt标签里靠自己解析容易漏掉命名空间、坐标属性格式等问题。我一般用现成的 Python 库gpxpy来解析和写回它把轨迹、航点、路线都封装成了对象处理起来省很多事。3.2 用 gpxpy 做轨迹清洗的脚本清洗脚本需要保留有效信息同时把明显错误过滤掉。我的核心逻辑是移除经纬度越界的点计算相邻点之间的平面距离小于阈值就丢弃再根据时间差算瞬时速度超过运动类型上限的点也丢弃。import gpxpy import gpxpy.gpx DISTANCE_THRESHOLD_M 5.0 MAX_SPEED_KMH 25.0 # 徒步场景骑行请调到 60 def clean_segment(segment): cleaned [] for point in segment.points: if point.latitude is None or point.longitude is None: continue if not (-90 point.latitude 90 and -180 point.longitude 180): continue if cleaned: last cleaned[-1] dist last.distance_2d(point) if dist DISTANCE_THRESHOLD_M: continue if point.time and last.time: dt (point.time - last.time).total_seconds() if dt 0 and dist / dt * 3.6 MAX_SPEED_KMH: continue cleaned.append(point) segment.points cleaned def clean_gpx(src, dst): with open(src, r, encodingutf-8) as f: gpx gpxpy.parse(f) for track in gpx.tracks: for segment in track.segments: clean_segment(segment) with open(dst, w, encodingutf-8) as f: f.write(gpx.to_xml())逻辑说明distance_2d是gpxpy提供的方法直接返回两个点之间的平面距离单位是米。先过滤越界点再过滤密集点最后用时间差算瞬时速度四个步骤顺序不能反。如果先算速度漂移点因为有明显位移反而会通过。参数说明DISTANCE_THRESHOLD_M 5.0适合徒步和骑车如果是开车日志可以调到 20 到 50 米否则会把正常弯道上距离近的点删除轨迹会变得很生硬。MAX_SPEED_KMH 25.0是徒步跑步的折中值骑行建议调到 60开车建议调到 120。注意这个速度过滤只能处理明显跳变无法修正系统性的坐标偏移。3.3 把多条轨迹合成一张路书一次穿越常常分成好几段记录导出来是多个 GPX。在电脑上合并比在手机 App 里操作省力得多。合并脚本用gpxpy把多个文件的对象直接拼到同一个GPX实例里。import gpxpy merged gpxpy.gpx.GPX() for fname in [track1.gpx, track2.gpx, track3.gpx]: with open(fname, r, encodingutf-8) as f: one gpxpy.parse(f) for track in one.tracks: track.name fmerged_{fname} merged.tracks.append(track) for wpt in one.waypoints: merged.waypoints.append(wpt) with open(merged.gpx, w, encodingutf-8) as f: f.write(merged.to_xml())逻辑说明直接 appendtrack对象会保留原始元数据所以我在合并前把track.name改成了来源文件名避免 OruxMaps 里出现一堆同名 Track。航点waypoints是独立列表合并时要注意重复航点如果两个文件中都有同一个营地标记合并后会出现两个同名的航点。可以在合并前按经纬度做去重或者保留其中一个。参数说明这里用了固定的文件名列表实际使用可以改成glob.glob(*.gpx)。如果轨迹里有高度数据建议保留OruxMaps 在显示海拔剖面图时会用到。如果只是导航路书可以去掉高度以减小体积。4. 从电脑到手机目录结构、打包与 adb 同步的完整路径4.1 OruxMaps 在手机上的数据目录OruxMaps 的数据目录在 Android 设备上通常有固定结构不同版本可能略有差异但大方向一致。桌面端脚本要做的就是把本地整理好的文件放进对应目录。目录存放内容OruxMaps/Mapfiles/地图包目录里面按 z/x/y 存放瓦片OruxMaps/tracklogs/GPX 轨迹文件同步后可以在列表里看到OruxMaps/waypoints/航点文件常与轨迹分开存放OruxMaps/routes/路线文件可选如果手机设置里把基础目录改到了外部 SD 卡路径会变成存储卡/OruxMaps/...。我建议所有同步脚本都先读取手机上的实际路径不要硬编码。更简单的做法是第一次同步前用文件管理器手动建好目录再让脚本往里面追加文件。4.2 用 adb push 加 tar 包完成大文件传输桌面端和手机之间传文件最直接的是 USB 连接后用adb push。但几千张瓦片都是几 KB 大小直接 push 会在 MTP 层花大量时间而且容易因文件数太多中断。常见做法是先在电脑上把新地图包打包成一个 tar 包推到手机后再解压到目标目录。#!/bin/bash set -euo pipefail LOCAL_MAP_PARENT./ # 进入 Mapfiles 的父目录 LOCAL_MAP_DIR./Mapfiles REMOTE_TMP/data/local/tmp REMOTE_BASE/sdcard/OruxMaps/Mapfiles STAGE/tmp/orux_sync rm -rf $STAGE mkdir -p $STAGE cd $LOCAL_MAP_PARENT # 只打包 7 天内改动过的文件全量时去掉 mtime 条件 find ./Mapfiles -type f -mtime -7 -print0 | tar --null -czf $STAGE/mapfiles.tar.gz -T - adb shell mkdir -p $REMOTE_TMP adb shell mkdir -p $REMOTE_BASE adb push $STAGE/mapfiles.tar.gz $REMOTE_TMP/mapfiles.tar.gz # 在手机上解压注意 -C 指定目标目录 adb shell tar -xzf $REMOTE_TMP/mapfiles.tar.gz -C $REMOTE_BASE adb shell rm -f $REMOTE_TMP/mapfiles.tar.gz逻辑说明cd到父目录后再用find ./Mapfiles打包能保证 tar 包内路径是相对Mapfiles的解压后直接进入目标目录。如果直接在原目录用绝对路径打包解压后手机会生成一串多余的嵌套目录。adb shell tar用的是 Android 系统的 toybox tar支持常见的-xzf参数。参数说明-mtime -7表示只打包 7 天内修改过的文件配合增量更新很实用但如果你这台电脑第一次同步要全量传一次就把条件去掉改成tar -czf $STAGE/mapfiles.tar.gz -C $LOCAL_MAP_PARENT ./Mapfiles。REMOTE_TMP用/data/local/tmp是因为这个目录 adb shell 一定有写权限比/sdcard/Download更稳定。解压后要及时删掉临时包否则会占手机空间。4.3 同步前必须检查的 3 个参数同步不是一条命令跑完就结束我每次都会先检查三件事手机剩余空间、目标目录是否冲突、本地文件修改时间是否正常。手机剩余空间用adb shell df /sdcard重点看可用空间是否大于地图包解压后的两倍因为 tar 包和解压后的文件会同时存在一小段时间。目标目录冲突用adb shell ls -l查看同名文件避免旧文件和新文件混杂导致 OruxMaps 扫描异常。修改时间主要影响 App 的扫描顺序如果你本地用cp而不是tar要加-p保留 mtime否则手机端排序会乱。如果你用的是 Windows 而不是 Linux 或 WSL可以把上面的 bash 脚本放到 Git Bash 里运行。注意 Windows 下adb命令要在 PATH 中否则脚本会提示找不到命令。手机上也要开启 USB 调试锁屏状态下允许调试授权。如果提示设备未授权拔掉 USB 重新插手机端允许调试弹窗点同意。5. oruxmapsDesktop 避坑指南五个最容易翻车的地方5.1 瓦片下载到一半网络超时重来一遍现象脚本跑了两个小时中途网络抽风报了一堆超时错误程序退出。重新执行后它又从第一张瓦片开始下载前面的进度全浪费了。原因下载脚本没有做断点续传。每次进入download_tile时没有检查本地文件是否已经存在且完整导致已经下载过的瓦片被重新请求一遍。解决在下载前先判断目标文件是否存在且大于 0 字节存在就跳过这也是第二章脚本里if os.path.exists(path) and os.path.getsize(path) 0的作用。还有一个隐藏坑之前某次下载中断可能留下 0 字节占位文件脚本会认为它已存在而跳过导致最终地图上出现白块。我每次重新下载前会先执行一次find . -size 0 -delete把空文件清理掉再跑。5.2 地图整体偏移几十米和 GPS 对不上现象把轨迹导进 OruxMaps地图上显示你走的路线和实际道路平行错开几十米在峡谷地段甚至直接飘到山脊上。原因瓦片源采用带偏移的坐标系而 GPS 轨迹记录的是 WGS84。某些地图源为了保证合规性输出的瓦片并不是标准 Web Mercator桌面端下载时如果不做处理离线地图也会继承这个偏移。解决下载前先确认瓦片源的坐标系最好在电脑上用同一个瓦片源和已知 GPS 坐标点做对比。测量出固定偏移量后可以写一个偏移校正脚本把轨迹或航点按同一偏移量平移。不要尝试去扭曲瓦片图片那样会破坏图上文字和道路形状。如果不想折腾最稳妥的办法是换一个标准 Web Mercator 的瓦片源。5.3 航点变成乱码现象在电脑上用文本编辑器打开 GPX 文件中文航点名正常同步到手机后全变成问号或者菱形乱码。原因GPX 文件编码不是 UTF-8。Windows 上常见的记事本默认保存为 GBK 或 GB18030而 OruxMaps 解析 GPX 时按 UTF-8 读取最终显示乱码。解决统一转码后再同步。用命令行处理最直接iconv -f GBK -t UTF-8 old.gpx new.gpx。但要注意GPX 文件头部 XML 声明里如果写了encodingUTF-8而内容实际是 GBKiconv 后必须同步更新声明。用 Python 更省心读取时指定源编码写入时统一 UTF-8并且不要带 BOM否则部分 Android 解析器会出错。with open(old.gpx, r, encodinggbk, errorsreplace) as f: data f.read() with open(new.gpx, w, encodingutf-8) as f: f.write(data)参数说明errorsreplace是为了防止个别无法解析的字符导致整个脚本崩溃。真正处理前建议先用chardet或file命令检测原始编码避免猜错。5.4 同步完成手机里却找不到新地图包现象电脑上 push 成功手机文件管理器也能看到瓦片文件但打开 OruxMaps地图列表里就是没有这个包。原因最常见的是目录结构不对瓦片没有按z/x/y.png组织其次是没有地图描述文件OruxMaps 无法确认这是一个地图包。还有一个情况是文件同步到了路径 A但 OruxMaps 配置的基础目录是路径 B。解决先在 OruxMaps 的设置里查看当前地图目录确认手机端期望的位置。然后严格按Mapfiles/地图包名/层级/横坐标/纵坐标.png组织。地图包名这一层很容易被忽略瓦片不能直接堆在 Mapfiles 根目录下。如果没有 map 描述文件可以从 OruxMaps 里随便导出一个已有地图包复制它的描述文件改一下名字和层级范围。5.5 手机里有两套地图切换时卡死现象装了精度较高的 16 级地图包又装了 10 级区域概览包在 OruxMaps 里切换界面卡几秒甚至直接崩溃。原因地图包内部瓦片尺寸不统一或者描述文件里写的 zoom 上下限和实际瓦片目录对不上。OruxMaps 切换地图时要重新扫描整个目录如果遇到缺失层级或超大尺寸瓦片扫描逻辑容易卡住。解决同一个地图包内瓦片图片像素尺寸必须统一常见是 256×256不要混入 512×512。描述文件里声明的层级范围要精确宁可多留一层空目录也不要让实际层级超出声明范围。如果切换还是卡把地图包拆成几个独立包分别放在不同子目录按使用频率分开加载。6. 增量更新技巧按轨迹多边形只下载用得到的瓦片地图数据最大的成本不在单次下载而在长期维护。以前我图省事直接把一个城市范围的 14 级瓦片全量拉下来后面地图源一更新我只能全量重下流量和存储都吃不消。后来我改成按轨迹多边形做增量更新只下载轨迹线周围一定范围内的瓦片其他区域只要不变就不动。具体思路是先把计划出行的 GPX 轨迹读进来用shapely把轨迹线转成一个缓冲区多边形然后在瓦片下载脚本里判断每张瓦片对应的矩形是否和这个多边形相交不相交就直接跳过。from shapely.geometry import LineString, box # 轨迹经纬度点列表格式为 (lon, lat) track_points [(117.12, 39.50), (117.13, 39.51), (117.14, 39.52)] line LineString(track_points) # 经验值14 级地图下约 200 米zoom 越高可以越小 buffer line.buffer(0.002) def tile_bounds(x, y, zoom): n 2 ** zoom lon_min x / n * 360.0 - 180.0 lat_rad math.atan(math.sinh(math.pi * (1 - 2 * y / n))) lat_max math.degrees(lat_rad) lat_rad math.atan(math.sinh(math.pi * (1 - 2 * (y 1) / n))) lat_min math.degrees(lat_rad) lon_max (x 1) / n * 360.0 - 180.0 return lon_min, lat_min, lon_max, lat_max def need_download(x, y, zoom, buffered_line): bounds tile_bounds(x, y, zoom) tile box(bounds[0], bounds[1], bounds[2], bounds[3]) return tile.intersects(buffered_line)逻辑说明tile_bounds把瓦片编号转成经纬度范围构造一个矩形再和目标轨迹缓冲区做相交判断。buffer(0.002)是经纬度下的近似距离在纬度 40 度附近大约对应 200 米足够覆盖徒步时的小范围偏离。参数说明buffer的大小和 zoom 关系很大。14 级用 0.00216 级建议用 0.0005因为高缩放下单张瓦片覆盖范围小缓冲太大反而把整个城市都圈进来。计算时注意轨迹点一定要用(lon, lat)顺序传进shapely和常见lat, lon顺序相反。把这个判断函数加进第二章的下载脚本在生成任务列表时过滤一遍就能省下大量不必要的瓦片。这个技巧让我把每周的增量更新时间从一小时压缩到十几分钟手机存储占用也稳定在一个合理范围内。每次出行前一晚跑一次只下载轨迹周围新变更的区域比全量重下踏实得多。如果你也被地图包越来越大、同步越来越慢折磨过建议先别急着加硬盘把增量更新做出来收益非常直接。希望帮到你。本文还有配套的精品资源点击获取