簡介這是一款基于Java開發(fā)的Android導航客戶端專門用于加載OziExplorer的ozf2、ozfx3格式地圖適合徒步、尋寶、越野、帆船等戶外場景。使用者需對OziExplorer或自制地圖有一定了解資源面向有戶外導航需求的開發(fā)者與愛好者可從源碼層面學習地圖解析、定位與軌跡顯示等實現(xiàn)思路。壓縮包為zip格式約19.24MB由于上游未提供文件總數(shù)與類型明細簡介不強行列舉。項目配套常見問題解答與文檔支持翻譯貢獻和GitHub拉取請求代碼倉庫完整并帶有BitBucket鏡像便于對照學習與二次開發(fā)。目前已有753人學習下載適合希望研究Android地圖導航應用結構、或想在現(xiàn)有客戶端上擴展功能的Java開發(fā)者。1. Androzic 是什么Android 上跑 OziExplorer 地圖的老路子手里攢了幾年 OziExplorer 地圖的人換到 Android 手機后幾乎都會卡在同一個問題上這份地圖還能怎么用Androzic 就是專門解決這個問題的 Android 導航應用它直接讀取 ozf2、ozfx3 這兩種 OziExplorer 柵格地圖格式配合同名的 .map 校準文件完成坐標綁定不聯(lián)網(wǎng)也能定位、導航、記錄航跡。戶外無信號場景下它的價值很直接地圖不依賴在線圖源校準信息全部在本地GPS 一開就能接著用。適合手里有存量 OziExplorer 地圖資源的人或者想把離線地圖終端落地到 Android 設備的野外巡檢、徒步、測繪輔助場景。下面按我自己做過的路徑把格式選型、地圖轉(zhuǎn)換、加載配置和踩坑排查講清楚。2. 先看地圖格式ozf2 和 ozfx3 差在哪怎么選2.1 ozf2 與 ozfx3 的格式差異ozf2 是老版本 OziExplorer 使用的柵格地圖格式它的特點是分塊存儲、支持 RLE 無損壓縮文件里的每個圖塊可以直接定位解碼。ozf2 的兼容性最好從老電腦到 Android 端的解析庫都能識別。代價是壓縮率一般一張幾十 MB 的 tif 導成 ozf2 可能只縮小到一半左右文件大、讀盤次數(shù)多。ozfx3 是后來推出的替代格式核心改動有兩點一是圖塊尺寸可以配置二是引入了有損壓縮選項。實際使用中ozfx3 在同等視覺精度下文件體積能比 ozf2 小一半以上加載時從閃存讀取的數(shù)據(jù)量減少冷啟動打開一張大圖的速度明顯更快。但這不代表 ozfx3 全面優(yōu)于 ozf2。有損壓縮在等高線地圖上容易把細線壓出鋸齒如果源圖本身就是掃描的紙質(zhì)地形圖壓縮痕跡會被放大。還有一個容易被忽略的差異是文件內(nèi)部的組織方式。ozf2 的文件頭信息和圖塊索引結構比較固定而 ozfx3 的圖塊偏移表更靈活這導致個別轉(zhuǎn)換工具生成的 ozfx3 雖然在電腦端能打開放在 Android 端解析時卻會出現(xiàn)“文件頭能讀、圖塊讀不出來”的情況。這個坑我后面在避障章節(jié)專門展開。為什么不直接把 tif 文件丟進手機里因為 tif 是整幅圖像導航時每畫一幀都要把整張圖重采樣內(nèi)寸和時間消耗都不小。ozf2/ozfx3 的分塊機制讓應用只解碼當前視口對應的那幾塊這是這套格式能跑在十幾年前硬件上的直接原因。理解了這一點后面設置分塊參數(shù)時才不會亂來。說白了格式本身不是越新越好。老地圖資源大多是 ozf2沒必要為了“升級”去批量轉(zhuǎn)換新導出的地圖用 ozfx3 省空間。設備層面低內(nèi)存老手機建議用 ozf2因為它的解碼路徑更老也更穩(wěn)新設備直接上 ozfx3。2.2 .map 校準文件是怎么把像素坐標綁到經(jīng)緯度的地圖文件本身只是一張帶分塊的圖片Androzic 能把它當導航圖用靠的是同名 .map 文本文件。這個文件記錄了像素坐標和地理坐標的對應關系以及投影、坐標系、地圖邊界等信息。看一個典型結構OziExplorer Map Data File Version 2.2 地圖名.map 1 # 地圖類型柵格 3 # 校準點數(shù) 1,像素x,像素y,經(jīng)度,緯度,0,0,0 # 校準點 1 2,像素x,像素y,經(jīng)度,緯度,0,0,0 # 校準點 2 3,像素x,像素y,經(jīng)度,緯度,0,0,0 # 校準點 3 投影參數(shù)段 坐標系與基準面段 地圖邊界段校準點的作用是一個仿射變換兩個像素坐標和兩個經(jīng)緯度就能算出一張圖的旋轉(zhuǎn)、比例、平移參數(shù)所以一般至少要 3 個點覆蓋左上、右下、中間目的是把圖片變形誤差攤平。投影參數(shù)段則說明這張圖用的是經(jīng)緯度直投還是 UTM 這類投影坐標。地圖在屏幕上繪制時Androzic 會根據(jù)當前設備坐標反算出屏幕中心對應地圖的哪個像素。判斷一份 .map 是否靠譜的最快方法用文本編輯器打開看校準點里的經(jīng)緯度有沒有明顯亂跳以及投影段寫的坐標系名稱跟你制作時選的是否一致。映射基準面不一致是后期地圖偏移的一大來源這一條在后面的避障章節(jié)會反復出現(xiàn)。另外記住一個硬性約定.map 文件必須和地圖圖像文件同名、同目錄。比如地圖文件叫 林場地形圖.ozfx3那校準文件必須是 林場地形圖.map兩個文件缺一不可?？截悤r只拿圖像文件不拿校準文件是新手最常犯的錯。2.3 格式選型看來源、設備與糾錯成本選 ozf2 還是 ozfx3我一般按三條線走。第一是來源。手里的原始地圖如果是別人給的 ozf2直接保留不轉(zhuǎn)如果是自己從 tif 做的默認導出 ozfx3。第二是設備。Android 設備內(nèi)存低于 2GB 的我會轉(zhuǎn)回 ozf2因為 ozfx3 解碼邏輯在低配機器上更容易觸發(fā)整塊內(nèi)存峰值。第三是糾錯成本。轉(zhuǎn)換后一定先在戶外或已知地標下核對一次發(fā)現(xiàn)偏移要能回到制作環(huán)節(jié)重做保留源圖比反復轉(zhuǎn)換更重要。這里有個實際經(jīng)驗同一張源圖分別導出 ozf2 和 ozfx3放在同一個設備上對比加載時間ozfx3 通?？?20% 到 40%但如果你用的轉(zhuǎn)換參數(shù)把圖塊調(diào)得過大這個優(yōu)勢會消失甚至更慢。表格里是我自己常用的參數(shù)參考用于自己制作地圖時場景格式圖塊尺寸壓縮方式等高線地形圖ozfx3512x512無損衛(wèi)星影像底圖ozfx31024x1024有損中等老設備兼容ozf2512x512RLE參數(shù)會隨源圖分辨率和設備不同而變化不是固定公式。重點是理解圖塊尺寸越小單次解碼內(nèi)存越低但索引條目越多打開和滾動時計算量越大圖塊越大則相反。這個平衡在下一章的轉(zhuǎn)換環(huán)節(jié)還會展開。多說一句為什么要守這套老方案在線地圖在山區(qū)、林場這些地方經(jīng)常沒有信號商業(yè)圖源在特定比例尺下的道路和小徑更新并不及時。OziExplorer 生態(tài)里積累了大量地方測繪或個人校準過的歷史圖資這些圖用 Androzic 在 Android 上繼續(xù)用等于把過去的測量成果無縫帶到手機上。這也是我至今沒放棄這套方案的原因。3. 地圖轉(zhuǎn)換把原始影像變成 Androzic 能認的格式3.1 從 tif/jpg 導出 ozf2/ozfx3 的常規(guī)步驟先把話說清楚Androzic 本身不做轉(zhuǎn)換它是地圖的消費者。制作 ozf2、ozfx3 和 .map 的常見做法是用 OziExplorer 打開地圖文件在軟件里執(zhí)行導出操作這個過程是圖形界面的沒有命令行可走。OziExplorer 會先用 .map 里的校準信息把圖片配準再按你選擇的格式和壓縮參數(shù)重新編碼輸出。一個完整的制作流程我通常這么走。第一步準備源圖和對應的 .map 文件二者放同一目錄、同名。第二步在 OziExplorer 中打開地圖此時如果源圖有投影信息軟件會自動讀取如果只有像素圖和手工校準點它會基于校準點做仿射配準。第三步打開導出地圖圖像的功能選擇輸出目錄、文件名、目標格式 ozf2 或 ozfx3。第四步設置分塊大小、壓縮質(zhì)量、是否跳過空白區(qū)域點擊導出。第五步把生成的 ozf2/ozfx3 連同原 .map 一起拷到 Android 設備。轉(zhuǎn)換前做一次文件核對很有必要命令如下# 轉(zhuǎn)換前的文件核對配合 OziExplorer 的導出操作使用 ls -lh 林場_地形圖.tif 林場_地形圖.map # 確認兩個文件在同目錄且同名再建輸出目錄 mkdir -p output_ozfx3/這一步的坑很常見有人只拷了 .ozfx3忘記拷貝同名的 .map結果 Androzic 里能看到文件列表但地圖打開就報校準信息缺失。記住一個原則轉(zhuǎn)換生成的圖像文件和原 .map 永遠是一對拷貝時別拆散。如果手里沒有 OziExplorer也有別的影像處理工具能完成類似工作但那些工具大多只能輸出帶地理信息的 tif不能直接生成 ozfx3。我的建議是別繞路直接按這個軟件的流程做因為它輸出的 .map 文件格式和 Androzic 的解析邏輯是匹配的繞路的代價最后還是花在調(diào)格式上。3.2 轉(zhuǎn)換參數(shù)怎么設分塊、壓縮與空白裁剪導出參數(shù)里最影響運行體驗的是分塊大小和壓縮方式。分塊大小決定了 Androzic 單次解碼的粒度。以我自己常用的設置為例分塊尺寸512x512默認保守適配多數(shù) Android 設備 壓縮方式無損等高線/ 中等有損衛(wèi)星影像 空白裁剪開啟自動跳過圖像邊緣的純色區(qū)域分塊尺寸的選擇邏輯對一臺內(nèi)存 3GB、屏幕 1080p 的設備1024x1024 的分塊在大部分場景沒問題但如果地圖本身是幾萬像素的超長寬圖滾動時并行的解碼任務會把內(nèi)存打滿出現(xiàn)閃退。我的習慣是圖幅超過 20000x20000 像素就退回 512x512。壓縮方式方面等高線、地物邊界這類靠線條表達的地圖別用有損影像圖可以接受有損因為傳感器噪聲本來就在。有個參數(shù)容易被忽略地圖投影與基準面。導出時 OziExplorer 會把你選擇的坐標系統(tǒng)寫進 .map這個值會直接影響后來手機定位的落點。如果你源圖是地方坐標系建議在導出前先重投影到 WGS84 經(jīng)緯度不要試圖讓 Androzic 去做坐標系換算Android 端對地方坐標系的支持非常有限硬上很容易出現(xiàn)整體偏移。導出完成后的檢查清單我也固定下來一是看生成文件的體積是否和源圖匹配明顯異常小說明轉(zhuǎn)換中途中斷了二是用 OziExplorer 重新打開生成的 ozf2/ozfx3能正常顯示才算通過三是對比 .map 里的尺寸字段和源圖尺寸防止圖幅被截斷。這三項檢查用不了兩分鐘能省掉戶外白跑一趟的麻煩。批量轉(zhuǎn)換時要控制節(jié)奏。幾十張圖一次性丟進去跑如果中間某張圖坐標異常任務會中斷前面的成果也跟著受影響。我一般一次只導 5 張導完抽查一張確認地圖邊界和校準點都正常再繼續(xù)下一批。3.3 沒有 .map 文件時的補救手工校準拿到一張老掃描圖沒有配套 .map想做成 Androzic 能用的離線地圖也不是完全沒救。常見做法是在 OziExplorer 里增加校準點找一個有明顯地標的位置比如道路交叉口、獨棟建筑角點分別在地圖上點選并輸入圖上標注的坐標至少三個點覆蓋圖幅的角落和中心然后保存為新 .map。這個過程不建議少于 5 個點因為掃描圖紙變形大點數(shù)太少邊緣區(qū)域會歪得很明顯。手工校準要特別小心坐標系統(tǒng)一地圖上的坐標如果是經(jīng)緯度就用經(jīng)緯度如果圖上標注的是公里網(wǎng)坐標要先確認投影帶。吃過一次虧之后我的習慣是保存前把所有點的原始坐標記錄到文本里一旦后期發(fā)現(xiàn)偏移直接用這些原始值重新生成 .map不用再點一遍。校準之后輸出目標格式流程和 3.1 節(jié)一致。提示手工校準的地圖在戶外驗證時優(yōu)先用交叉路口、橋梁這類線性地物做目視確認別用人名地名類標注點文字標注在掃描圖里往往本來就是偏的。做手工校準前先確認這張圖值不值得救。如果圖幅邊緣已經(jīng)皺褶、掃描比例失真嚴重校準后也只是“能用”而不是“好用”這種情況下我寧愿找一張同區(qū)域的新圖源重新配準不在爛圖上反復折騰。4. Android 端落地安裝、目錄規(guī)劃與首次加載4.1 地圖文件放哪里目錄結構、命名規(guī)則Androzic 讀取地圖不是靠系統(tǒng)掃描全部存儲它有自己的地圖目錄約定和文件選擇界面。常見做法是把地圖放在內(nèi)部存儲的 /Androzic/maps 目錄下也有版本支持自定義地圖目錄。首次使用前建議先建好目錄結構# 在 Android 設備上創(chuàng)建 Androzic 地圖目錄 mkdir -p /storage/emulated/0/Androzic/maps mkdir -p /storage/emulated/0/Androzic/routes mkdir -p /storage/emulated/0/Androzic/tracks這三個目錄分別放地圖、航線和航跡事先分好類等地圖數(shù)量多起來你就知道這個習慣的價值了。地圖文件命名有個容易被忽視的約束.ozfx3 或 .ozf2 必須與 .map 同名且放在同一目錄。比如某林場地形圖的完整文件應該是 林場地形圖.map 與 林場地形圖.ozfx3。如果文件名里帶中文空格或者特殊符號個別舊版 Android 文件管理器和解析庫會出現(xiàn)讀取異常我一般用拼音或英文短名避免玄學問題。文件傳輸也有講究。大幾 GB 的 ozfx3 走 USB 拷貝過程中容易中斷拷完先校驗文件大小再拔線這算血淚經(jīng)驗丟過一次完整地圖才知道難受。有條件就走局域網(wǎng)傳輸傳輸完成后對比兩邊文件大小一致再斷開連接。4.2 首次加載與校準檢查把地圖文件放進目錄后打開 Androzic進入地圖加載界面選擇對應文件。加載成功后先別急著去戶外我習慣先做三個檢查。第一屏幕上地圖是否能按預期比例尺顯示縮小放大是否流暢。第二開啟內(nèi)置網(wǎng)格顯示觀察地圖邊緣和網(wǎng)格線是否對齊如果邊緣歪斜說明 .map 的仿射參數(shù)和地圖像素不匹配。第三在已知坐標的位置模擬定位看十字光標是否落在圖上正確位置。如果地圖打開一片空白或者只顯示網(wǎng)格背景常見原因有兩個文件沒有正確配對或者格式解析失敗。優(yōu)先檢查 .map 和圖像文件是否同名同目錄如果文件配對正確再考慮把 .ozfx3 用轉(zhuǎn)換工具另存為 .ozf2 試試這一步能確認問題出在解析端還是文件端。注意Android 11 之后存儲權限收緊Androzic 如果讀不到 /Androzic/maps 里的文件去應用設置里確認文件訪問權限是否已授予。這個問題常見但排查起來快別一上來就重裝應用。首次加載建議在室內(nèi)先把地圖瀏覽一遍確認方向和比例尺。地圖旋轉(zhuǎn)后建議打開“地圖隨航向旋轉(zhuǎn)”選項不然屏幕朝向和地圖朝向不一致時在復雜地形里特別容易看反方向。4.3 GPS 與導航設置讓地圖跟著人走地圖加載正常后把 GPS 設置項過一遍。我一般會把位置精度閾值調(diào)到 10 米以內(nèi)低于這個精度的定位點不參與航跡記錄避免在城市峽谷或者樹蔭下走出大量野點。Androzic 的定位信息會顯示當前衛(wèi)星數(shù)和水平精度這個數(shù)字可以作為是否開始記錄航跡的參考。正式出發(fā)前做一次“靜止校準”人站在已知地標上等 GPS 精度數(shù)值穩(wěn)定下來看地圖上的十字光標偏離多遠。如果偏了幾十米而精度顯示只有 3 米那幾乎可以斷定是地圖校準或坐標系問題不是信號問題這時候回轉(zhuǎn)換環(huán)節(jié)修不要試圖在手機上硬調(diào)。航跡記錄界面里還有個“記錄間隔”選項按時間和按距離觸發(fā)兩種模式。徒步場景我習慣按距離觸發(fā)每 10 米記一個點軌跡平滑又不至于數(shù)據(jù)量太大車載場景改成按時間觸發(fā)每 5 秒一個點。這個參數(shù)沒有標準答案但會影響航跡文件的大小和后續(xù)在桌面端分析時的平滑度。地圖文件多了之后按區(qū)域建子目錄管理。比如同一個省內(nèi)分東區(qū)和西區(qū)兩個目錄文件列表會按目錄名顯示野外切圖時不用在一堆文件名里翻。目錄名用能看懂的區(qū)域簡稱別用日期因為日期無法表達地理位置。5. Androzic 使用避坑加載失敗、偏移與卡頓排查5.1 ozfx3 文件加載后白屏黑塊現(xiàn)象Androzic 能識別文件但打開后大面積為空白或出現(xiàn)黑色塊狀區(qū)域。原因ozfx3 的圖塊索引偏移計算方式和某些轉(zhuǎn)換工具的默認分塊設置不兼容。尤其是分塊尺寸不等于 2 的冪時解析端的偏移表計算會錯位圖塊拿不到正確位置就顯示成空白或黑塊。解決把圖塊尺寸改回 512x512 或 1024x1024 重新導出優(yōu)先 512x512。如果重導仍白屏改為導出 ozf2這是兼容性最穩(wěn)的格式。排查時先確認文件大小正常再確認分塊參數(shù)不要反復卸載重裝應用問題根本不在應用端。5.2 地圖顯示整體偏移現(xiàn)象十字光標落在圖上某條路的旁邊實際人站在離路幾十米外的空地或者圖上地物整體往同一個方向移動。原因.map 中的投影或基準面與 GPS 接收的 WGS84 坐標不一致。校準階段把地方坐標系當作經(jīng)緯度直投保存GPS 坐標按 WGS84 換算后自然整體平移。解決在轉(zhuǎn)換環(huán)節(jié)把源圖重投影到 WGS84 經(jīng)緯度并重新生成 .map。不要試圖在應用里硬調(diào)偏移量那只能救局部救不了圖幅邊緣區(qū)域。這個坑最容易出現(xiàn)在手工校準的老圖上校準點用的坐標系和 GPS 實際用的坐標系不是一回事后面所有的偏移都是從這里開始的。5.3 打開大圖卡頓甚至閃退現(xiàn)象兩萬像素量級的大圖地圖打開后拖動有明顯掉幀點擊縮放時應用直接退出。原因單張圖的分塊尺寸太大解碼時單塊數(shù)據(jù)量高加上地圖滾動會同時解碼相鄰多塊內(nèi)存峰值瞬間頂滿。低內(nèi)存設備上更明顯有時連續(xù)縮放幾下就崩了。解決在轉(zhuǎn)換工具里把分塊調(diào)成 512x512壓縮方式從無損改為中等有損圖像尺寸不變但單塊解碼壓力驟減。如果還閃退把這張大圖拆分成多個小圖按區(qū)域分別校準使用時只加載當前區(qū)域。拆分雖然多了幾步操作但能換來穩(wěn)定的滾動體驗值得。5.4 航跡漂在道路一側現(xiàn)象GPS 和地圖各自看著都對但記錄的航跡始終平行偏移沿路走卻落在路一側。原因混合使用了兩套校準體系的地圖。比如一個區(qū)域內(nèi)有一張手工校準圖和一張標準投影圖兩套 .map 的投影參數(shù)不一致切換地圖時航跡自然跳變。航跡本身是連續(xù)的地圖換了基準看起來就像漂移。解決把同一個工作區(qū)的地圖統(tǒng)一到同一投影基準。先確認每一張圖的 .map 投影段內(nèi)容一致不一致的圖重做校準不要混用。這個問題的隱蔽之處在于單張圖看都正常只有跨圖使用時才暴露所以我在新區(qū)域開工前會統(tǒng)一檢查一遍所有地圖的投影段文本。6. 進階航跡管理、路點規(guī)劃與地圖精度驗證習慣航跡和路點管理是 Androzic 比單純看圖更值錢的地方。每次外業(yè)結束我習慣把當天的航跡導出為 GPX 格式存到按日期命名的目錄和電腦端 OziExplorer 互相倒騰很方便。路點記錄也別忽略在關鍵位置打點標注過橋、岔路、補水點導出時帶上類別字段回到桌面端就能直接進項目管理流程。日常使用中我最看重的還是那張“精度驗證清單”。拿到新地圖、新設備或者換新手機出發(fā)前花五分鐘做三個驗證找一處已知坐標的地標對比十字光標和實際站立位置沿一條筆直道路走一百米看航跡是否和道路平行在地圖邊緣區(qū)域再驗證一次確認沒有整體偏移。誤差在 10 米以內(nèi)才把它當導航圖用超過這個數(shù)就回到轉(zhuǎn)換環(huán)節(jié)修校準不在手機上硬調(diào)。做過幾次偏移事故之后我的習慣固定下來了轉(zhuǎn)換用的源圖長期保留轉(zhuǎn)換參數(shù)記在本子上每次戶外前做一次靜態(tài)驗證。這套流程不復雜但能避開白天迷路、晚上找路的尷尬也讓我敢在陌生區(qū)域信任手機導航。希望幫到你。本文還有配套的精品資源點擊獲取