简介这是一款基于Java开发的Android导航客户端专门用于加载OziExplorer的ozf2、ozfx3格式地图适合徒步、寻宝、越野、帆船等户外场景。使用者需对OziExplorer或自制地图有一定了解资源面向有户外导航需求的开发者与爱好者可从源码层面学习地图解析、定位与轨迹显示等实现思路。压缩包为zip格式约19.24MB由于上游未提供文件总数与类型明细简介不强行列举。项目配套常见问题解答与文档支持翻译贡献和GitHub拉取请求代码仓库完整并带有BitBucket镜像便于对照学习与二次开发。目前已有753人学习下载适合希望研究Android地图导航应用结构、或想在现有客户端上扩展功能的Java开发者。1. Androzic 是什么Android 上跑 OziExplorer 地图的老路子手里攒了几年 OziExplorer 地图的人换到 Android 手机后几乎都会卡在同一个问题上这份地图还能怎么用Androzic 就是专门解决这个问题的 Android 导航应用它直接读取 ozf2、ozfx3 这两种 OziExplorer 栅格地图格式配合同名的 .map 校准文件完成坐标绑定不联网也能定位、导航、记录航迹。户外无信号场景下它的价值很直接地图不依赖在线图源校准信息全部在本地GPS 一开就能接着用。适合手里有存量 OziExplorer 地图资源的人或者想把离线地图终端落地到 Android 设备的野外巡检、徒步、测绘辅助场景。下面按我自己做过的路径把格式选型、地图转换、加载配置和踩坑排查讲清楚。2. 先看地图格式ozf2 和 ozfx3 差在哪怎么选2.1 ozf2 与 ozfx3 的格式差异ozf2 是老版本 OziExplorer 使用的栅格地图格式它的特点是分块存储、支持 RLE 无损压缩文件里的每个图块可以直接定位解码。ozf2 的兼容性最好从老电脑到 Android 端的解析库都能识别。代价是压缩率一般一张几十 MB 的 tif 导成 ozf2 可能只缩小到一半左右文件大、读盘次数多。ozfx3 是后来推出的替代格式核心改动有两点一是图块尺寸可以配置二是引入了有损压缩选项。实际使用中ozfx3 在同等视觉精度下文件体积能比 ozf2 小一半以上加载时从闪存读取的数据量减少冷启动打开一张大图的速度明显更快。但这不代表 ozfx3 全面优于 ozf2。有损压缩在等高线地图上容易把细线压出锯齿如果源图本身就是扫描的纸质地形图压缩痕迹会被放大。还有一个容易被忽略的差异是文件内部的组织方式。ozf2 的文件头信息和图块索引结构比较固定而 ozfx3 的图块偏移表更灵活这导致个别转换工具生成的 ozfx3 虽然在电脑端能打开放在 Android 端解析时却会出现“文件头能读、图块读不出来”的情况。这个坑我后面在避障章节专门展开。为什么不直接把 tif 文件丢进手机里因为 tif 是整幅图像导航时每画一帧都要把整张图重采样内寸和时间消耗都不小。ozf2/ozfx3 的分块机制让应用只解码当前视口对应的那几块这是这套格式能跑在十几年前硬件上的直接原因。理解了这一点后面设置分块参数时才不会乱来。说白了格式本身不是越新越好。老地图资源大多是 ozf2没必要为了“升级”去批量转换新导出的地图用 ozfx3 省空间。设备层面低内存老手机建议用 ozf2因为它的解码路径更老也更稳新设备直接上 ozfx3。2.2 .map 校准文件是怎么把像素坐标绑到经纬度的地图文件本身只是一张带分块的图片Androzic 能把它当导航图用靠的是同名 .map 文本文件。这个文件记录了像素坐标和地理坐标的对应关系以及投影、坐标系、地图边界等信息。看一个典型结构OziExplorer Map Data File Version 2.2 地图名.map 1 # 地图类型栅格 3 # 校准点数 1,像素x,像素y,经度,纬度,0,0,0 # 校准点 1 2,像素x,像素y,经度,纬度,0,0,0 # 校准点 2 3,像素x,像素y,经度,纬度,0,0,0 # 校准点 3 投影参数段 坐标系与基准面段 地图边界段校准点的作用是一个仿射变换两个像素坐标和两个经纬度就能算出一张图的旋转、比例、平移参数所以一般至少要 3 个点覆盖左上、右下、中间目的是把图片变形误差摊平。投影参数段则说明这张图用的是经纬度直投还是 UTM 这类投影坐标。地图在屏幕上绘制时Androzic 会根据当前设备坐标反算出屏幕中心对应地图的哪个像素。判断一份 .map 是否靠谱的最快方法用文本编辑器打开看校准点里的经纬度有没有明显乱跳以及投影段写的坐标系名称跟你制作时选的是否一致。映射基准面不一致是后期地图偏移的一大来源这一条在后面的避障章节会反复出现。另外记住一个硬性约定.map 文件必须和地图图像文件同名、同目录。比如地图文件叫 林场地形图.ozfx3那校准文件必须是 林场地形图.map两个文件缺一不可。拷贝时只拿图像文件不拿校准文件是新手最常犯的错。2.3 格式选型看来源、设备与纠错成本选 ozf2 还是 ozfx3我一般按三条线走。第一是来源。手里的原始地图如果是别人给的 ozf2直接保留不转如果是自己从 tif 做的默认导出 ozfx3。第二是设备。Android 设备内存低于 2GB 的我会转回 ozf2因为 ozfx3 解码逻辑在低配机器上更容易触发整块内存峰值。第三是纠错成本。转换后一定先在户外或已知地标下核对一次发现偏移要能回到制作环节重做保留源图比反复转换更重要。这里有个实际经验同一张源图分别导出 ozf2 和 ozfx3放在同一个设备上对比加载时间ozfx3 通常快 20% 到 40%但如果你用的转换参数把图块调得过大这个优势会消失甚至更慢。表格里是我自己常用的参数参考用于自己制作地图时场景格式图块尺寸压缩方式等高线地形图ozfx3512x512无损卫星影像底图ozfx31024x1024有损中等老设备兼容ozf2512x512RLE参数会随源图分辨率和设备不同而变化不是固定公式。重点是理解图块尺寸越小单次解码内存越低但索引条目越多打开和滚动时计算量越大图块越大则相反。这个平衡在下一章的转换环节还会展开。多说一句为什么要守这套老方案在线地图在山区、林场这些地方经常没有信号商业图源在特定比例尺下的道路和小径更新并不及时。OziExplorer 生态里积累了大量地方测绘或个人校准过的历史图资这些图用 Androzic 在 Android 上继续用等于把过去的测量成果无缝带到手机上。这也是我至今没放弃这套方案的原因。3. 地图转换把原始影像变成 Androzic 能认的格式3.1 从 tif/jpg 导出 ozf2/ozfx3 的常规步骤先把话说清楚Androzic 本身不做转换它是地图的消费者。制作 ozf2、ozfx3 和 .map 的常见做法是用 OziExplorer 打开地图文件在软件里执行导出操作这个过程是图形界面的没有命令行可走。OziExplorer 会先用 .map 里的校准信息把图片配准再按你选择的格式和压缩参数重新编码输出。一个完整的制作流程我通常这么走。第一步准备源图和对应的 .map 文件二者放同一目录、同名。第二步在 OziExplorer 中打开地图此时如果源图有投影信息软件会自动读取如果只有像素图和手工校准点它会基于校准点做仿射配准。第三步打开导出地图图像的功能选择输出目录、文件名、目标格式 ozf2 或 ozfx3。第四步设置分块大小、压缩质量、是否跳过空白区域点击导出。第五步把生成的 ozf2/ozfx3 连同原 .map 一起拷到 Android 设备。转换前做一次文件核对很有必要命令如下# 转换前的文件核对配合 OziExplorer 的导出操作使用 ls -lh 林场_地形图.tif 林场_地形图.map # 确认两个文件在同目录且同名再建输出目录 mkdir -p output_ozfx3/这一步的坑很常见有人只拷了 .ozfx3忘记拷贝同名的 .map结果 Androzic 里能看到文件列表但地图打开就报校准信息缺失。记住一个原则转换生成的图像文件和原 .map 永远是一对拷贝时别拆散。如果手里没有 OziExplorer也有别的影像处理工具能完成类似工作但那些工具大多只能输出带地理信息的 tif不能直接生成 ozfx3。我的建议是别绕路直接按这个软件的流程做因为它输出的 .map 文件格式和 Androzic 的解析逻辑是匹配的绕路的代价最后还是花在调格式上。3.2 转换参数怎么设分块、压缩与空白裁剪导出参数里最影响运行体验的是分块大小和压缩方式。分块大小决定了 Androzic 单次解码的粒度。以我自己常用的设置为例分块尺寸512x512默认保守适配多数 Android 设备 压缩方式无损等高线/ 中等有损卫星影像 空白裁剪开启自动跳过图像边缘的纯色区域分块尺寸的选择逻辑对一台内存 3GB、屏幕 1080p 的设备1024x1024 的分块在大部分场景没问题但如果地图本身是几万像素的超长宽图滚动时并行的解码任务会把内存打满出现闪退。我的习惯是图幅超过 20000x20000 像素就退回 512x512。压缩方式方面等高线、地物边界这类靠线条表达的地图别用有损影像图可以接受有损因为传感器噪声本来就在。有个参数容易被忽略地图投影与基准面。导出时 OziExplorer 会把你选择的坐标系统写进 .map这个值会直接影响后来手机定位的落点。如果你源图是地方坐标系建议在导出前先重投影到 WGS84 经纬度不要试图让 Androzic 去做坐标系换算Android 端对地方坐标系的支持非常有限硬上很容易出现整体偏移。导出完成后的检查清单我也固定下来一是看生成文件的体积是否和源图匹配明显异常小说明转换中途中断了二是用 OziExplorer 重新打开生成的 ozf2/ozfx3能正常显示才算通过三是对比 .map 里的尺寸字段和源图尺寸防止图幅被截断。这三项检查用不了两分钟能省掉户外白跑一趟的麻烦。批量转换时要控制节奏。几十张图一次性丢进去跑如果中间某张图坐标异常任务会中断前面的成果也跟着受影响。我一般一次只导 5 张导完抽查一张确认地图边界和校准点都正常再继续下一批。3.3 没有 .map 文件时的补救手工校准拿到一张老扫描图没有配套 .map想做成 Androzic 能用的离线地图也不是完全没救。常见做法是在 OziExplorer 里增加校准点找一个有明显地标的位置比如道路交叉口、独栋建筑角点分别在地图上点选并输入图上标注的坐标至少三个点覆盖图幅的角落和中心然后保存为新 .map。这个过程不建议少于 5 个点因为扫描图纸变形大点数太少边缘区域会歪得很明显。手工校准要特别小心坐标系统一地图上的坐标如果是经纬度就用经纬度如果图上标注的是公里网坐标要先确认投影带。吃过一次亏之后我的习惯是保存前把所有点的原始坐标记录到文本里一旦后期发现偏移直接用这些原始值重新生成 .map不用再点一遍。校准之后输出目标格式流程和 3.1 节一致。提示手工校准的地图在户外验证时优先用交叉路口、桥梁这类线性地物做目视确认别用人名地名类标注点文字标注在扫描图里往往本来就是偏的。做手工校准前先确认这张图值不值得救。如果图幅边缘已经皱褶、扫描比例失真严重校准后也只是“能用”而不是“好用”这种情况下我宁愿找一张同区域的新图源重新配准不在烂图上反复折腾。4. Android 端落地安装、目录规划与首次加载4.1 地图文件放哪里目录结构、命名规则Androzic 读取地图不是靠系统扫描全部存储它有自己的地图目录约定和文件选择界面。常见做法是把地图放在内部存储的 /Androzic/maps 目录下也有版本支持自定义地图目录。首次使用前建议先建好目录结构# 在 Android 设备上创建 Androzic 地图目录 mkdir -p /storage/emulated/0/Androzic/maps mkdir -p /storage/emulated/0/Androzic/routes mkdir -p /storage/emulated/0/Androzic/tracks这三个目录分别放地图、航线和航迹事先分好类等地图数量多起来你就知道这个习惯的价值了。地图文件命名有个容易被忽视的约束.ozfx3 或 .ozf2 必须与 .map 同名且放在同一目录。比如某林场地形图的完整文件应该是 林场地形图.map 与 林场地形图.ozfx3。如果文件名里带中文空格或者特殊符号个别旧版 Android 文件管理器和解析库会出现读取异常我一般用拼音或英文短名避免玄学问题。文件传输也有讲究。大几 GB 的 ozfx3 走 USB 拷贝过程中容易中断拷完先校验文件大小再拔线这算血泪经验丢过一次完整地图才知道难受。有条件就走局域网传输传输完成后对比两边文件大小一致再断开连接。4.2 首次加载与校准检查把地图文件放进目录后打开 Androzic进入地图加载界面选择对应文件。加载成功后先别急着去户外我习惯先做三个检查。第一屏幕上地图是否能按预期比例尺显示缩小放大是否流畅。第二开启内置网格显示观察地图边缘和网格线是否对齐如果边缘歪斜说明 .map 的仿射参数和地图像素不匹配。第三在已知坐标的位置模拟定位看十字光标是否落在图上正确位置。如果地图打开一片空白或者只显示网格背景常见原因有两个文件没有正确配对或者格式解析失败。优先检查 .map 和图像文件是否同名同目录如果文件配对正确再考虑把 .ozfx3 用转换工具另存为 .ozf2 试试这一步能确认问题出在解析端还是文件端。注意Android 11 之后存储权限收紧Androzic 如果读不到 /Androzic/maps 里的文件去应用设置里确认文件访问权限是否已授予。这个问题常见但排查起来快别一上来就重装应用。首次加载建议在室内先把地图浏览一遍确认方向和比例尺。地图旋转后建议打开“地图随航向旋转”选项不然屏幕朝向和地图朝向不一致时在复杂地形里特别容易看反方向。4.3 GPS 与导航设置让地图跟着人走地图加载正常后把 GPS 设置项过一遍。我一般会把位置精度阈值调到 10 米以内低于这个精度的定位点不参与航迹记录避免在城市峡谷或者树荫下走出大量野点。Androzic 的定位信息会显示当前卫星数和水平精度这个数字可以作为是否开始记录航迹的参考。正式出发前做一次“静止校准”人站在已知地标上等 GPS 精度数值稳定下来看地图上的十字光标偏离多远。如果偏了几十米而精度显示只有 3 米那几乎可以断定是地图校准或坐标系问题不是信号问题这时候回转换环节修不要试图在手机上硬调。航迹记录界面里还有个“记录间隔”选项按时间和按距离触发两种模式。徒步场景我习惯按距离触发每 10 米记一个点轨迹平滑又不至于数据量太大车载场景改成按时间触发每 5 秒一个点。这个参数没有标准答案但会影响航迹文件的大小和后续在桌面端分析时的平滑度。地图文件多了之后按区域建子目录管理。比如同一个省内分东区和西区两个目录文件列表会按目录名显示野外切图时不用在一堆文件名里翻。目录名用能看懂的区域简称别用日期因为日期无法表达地理位置。5. Androzic 使用避坑加载失败、偏移与卡顿排查5.1 ozfx3 文件加载后白屏黑块现象Androzic 能识别文件但打开后大面积为空白或出现黑色块状区域。原因ozfx3 的图块索引偏移计算方式和某些转换工具的默认分块设置不兼容。尤其是分块尺寸不等于 2 的幂时解析端的偏移表计算会错位图块拿不到正确位置就显示成空白或黑块。解决把图块尺寸改回 512x512 或 1024x1024 重新导出优先 512x512。如果重导仍白屏改为导出 ozf2这是兼容性最稳的格式。排查时先确认文件大小正常再确认分块参数不要反复卸载重装应用问题根本不在应用端。5.2 地图显示整体偏移现象十字光标落在图上某条路的旁边实际人站在离路几十米外的空地或者图上地物整体往同一个方向移动。原因.map 中的投影或基准面与 GPS 接收的 WGS84 坐标不一致。校准阶段把地方坐标系当作经纬度直投保存GPS 坐标按 WGS84 换算后自然整体平移。解决在转换环节把源图重投影到 WGS84 经纬度并重新生成 .map。不要试图在应用里硬调偏移量那只能救局部救不了图幅边缘区域。这个坑最容易出现在手工校准的老图上校准点用的坐标系和 GPS 实际用的坐标系不是一回事后面所有的偏移都是从这里开始的。5.3 打开大图卡顿甚至闪退现象两万像素量级的大图地图打开后拖动有明显掉帧点击缩放时应用直接退出。原因单张图的分块尺寸太大解码时单块数据量高加上地图滚动会同时解码相邻多块内存峰值瞬间顶满。低内存设备上更明显有时连续缩放几下就崩了。解决在转换工具里把分块调成 512x512压缩方式从无损改为中等有损图像尺寸不变但单块解码压力骤减。如果还闪退把这张大图拆分成多个小图按区域分别校准使用时只加载当前区域。拆分虽然多了几步操作但能换来稳定的滚动体验值得。5.4 航迹漂在道路一侧现象GPS 和地图各自看着都对但记录的航迹始终平行偏移沿路走却落在路一侧。原因混合使用了两套校准体系的地图。比如一个区域内有一张手工校准图和一张标准投影图两套 .map 的投影参数不一致切换地图时航迹自然跳变。航迹本身是连续的地图换了基准看起来就像漂移。解决把同一个工作区的地图统一到同一投影基准。先确认每一张图的 .map 投影段内容一致不一致的图重做校准不要混用。这个问题的隐蔽之处在于单张图看都正常只有跨图使用时才暴露所以我在新区域开工前会统一检查一遍所有地图的投影段文本。6. 进阶航迹管理、路点规划与地图精度验证习惯航迹和路点管理是 Androzic 比单纯看图更值钱的地方。每次外业结束我习惯把当天的航迹导出为 GPX 格式存到按日期命名的目录和电脑端 OziExplorer 互相倒腾很方便。路点记录也别忽略在关键位置打点标注过桥、岔路、补水点导出时带上类别字段回到桌面端就能直接进项目管理流程。日常使用中我最看重的还是那张“精度验证清单”。拿到新地图、新设备或者换新手机出发前花五分钟做三个验证找一处已知坐标的地标对比十字光标和实际站立位置沿一条笔直道路走一百米看航迹是否和道路平行在地图边缘区域再验证一次确认没有整体偏移。误差在 10 米以内才把它当导航图用超过这个数就回到转换环节修校准不在手机上硬调。做过几次偏移事故之后我的习惯固定下来了转换用的源图长期保留转换参数记在本子上每次户外前做一次静态验证。这套流程不复杂但能避开白天迷路、晚上找路的尴尬也让我敢在陌生区域信任手机导航。希望帮到你。本文还有配套的精品资源点击获取
