簡(jiǎn)介GMAP.net源代碼是一份面向C#開(kāi)發(fā)者的開(kāi)源地圖組件源碼包特別適合需要在Windows Forms、WPF、ASP.NET、Windows Phone或UWP等環(huán)境中集成在線地圖、離線地圖瀏覽、路線規(guī)劃等功能的項(xiàng)目人員參考。該框架的核心是GMapControl控件提供了縮放、平移、旋轉(zhuǎn)、標(biāo)記管理、圖層管理以及事件處理與屬性設(shè)置機(jī)制開(kāi)發(fā)者可以據(jù)此定制地圖行為和外觀。代碼中實(shí)現(xiàn)了Google Maps、Bing Maps、OpenStreetMap、MapQuest、Yandex Maps等多個(gè)地圖服務(wù)商的接入邏輯并對(duì)瓦片管理、緩存存儲(chǔ)與加載策略做了詳細(xì)處理幫助理解離線地圖數(shù)據(jù)的高效組織方式。同時(shí)地理編碼、反向地理編碼和路線計(jì)算等高級(jí)功能的API調(diào)用實(shí)現(xiàn)也在其中展示了與地圖服務(wù)商交互的完整流程。壓縮包為rar格式大小約273.49MB已有419人學(xué)習(xí)下載整體源碼結(jié)構(gòu)完整既適合初學(xué)者解析地圖組件原理也便于有經(jīng)驗(yàn)的開(kāi)發(fā)者按需求修改擴(kuò)展。1. GMAP.net 源代碼先搞清楚這份 C# 開(kāi)源地圖組件到底解決什么做車輛軌跡回放、監(jiān)控大屏和 GIS 工具時(shí)最耗時(shí)的往往不是業(yè)務(wù)邏輯而是地圖這塊“地基”。GMAP.net 源代碼是一套完整的 C# 開(kāi)源地圖組件覆蓋了瓦片請(qǐng)求、拼接、投影換算、兩級(jí)緩存這一整條渲染鏈路。你不需要從零實(shí)現(xiàn)地圖渲染直接引用控件、給經(jīng)緯度、畫標(biāo)記和路線就能跑。比較反直覺(jué)的是這套源碼最值錢的地方不在在線地圖而在離線能力把瓦片灌進(jìn)本地緩存后斷網(wǎng)環(huán)境下照樣可以縮放、平移、畫軌跡。它適合正在選型 WinForms 地圖方案的開(kāi)發(fā)者也適合想研究地圖組件內(nèi)部實(shí)現(xiàn)的人。下面按“機(jī)制 → 跑通 → 實(shí)操 → 避坑”往下拆。2. 核心機(jī)制瓦片拼接、投影換算與兩級(jí)緩存2.1 從 URL 到 Bitmap一張地圖是怎么畫出來(lái)的GMapControl 本質(zhì)上是一個(gè)自繪控件每次重繪時(shí)并不直接 DrawImage 一張完整大圖而是根據(jù)當(dāng)前可視區(qū)域、中心點(diǎn)、縮放級(jí)別算出需要哪些瓦片再把瓦片逐張拼到屏幕上。源碼里最核心的邏輯就在控件的 OnPaint 流程中。我把這段邏輯簡(jiǎn)化了一下方便你理解它內(nèi)部在算什么。public void DrawMap(Graphics g, Rectangle viewport, PointLatLng center, int zoom, FuncGPoint, int, Bitmap loadTile) { GPoint centerTile new GPoint( (long)((center.Lng 180.0) / 360.0 * Math.Pow(2, zoom)), (long)((1 - Math.Log(Math.Tan(center.Lat * Math.PI / 180) 1 / Math.Cos(center.Lat * Math.PI / 180)) / Math.PI) / 2 * Math.Pow(2, zoom))); const int tileSize 256; double offsetX viewport.Width / 2.0 - (centerTile.X * tileSize - 0) % tileSize; double offsetY viewport.Height / 2.0 - (centerTile.Y * tileSize - 0) % tileSize; int xMin (int)Math.Floor(offsetX / tileSize); int yMin (int)Math.Floor(offsetY / tileSize); int xMax (int)Math.Ceiling((viewport.Width - offsetX) / tileSize); int yMax (int)Math.Ceiling((viewport.Height - offsetY) / tileSize); for (int x xMin; x xMax; x) { for (int y yMin; y yMax; y) { GPoint tile new GPoint(centerTile.X x, centerTile.Y y); Bitmap bmp loadTile(tile, zoom); if (bmp null) continue; g.DrawImage(bmp, (float)(offsetX x * tileSize), (float)(offsetY y * tileSize), tileSize, tileSize); } } }這段代碼把“中心點(diǎn) → 瓦片索引 → 屏幕偏移 → 需要加載的瓦片矩陣”這條鏈路壓縮成了幾十行。參數(shù)里 center 是地圖中心經(jīng)緯度zoom 是縮放級(jí)別viewport 是控件可視區(qū)域。tileSize 為 256 是瓦片地圖的通用規(guī)范幾乎所有在線地圖都遵守。loadTile 是一個(gè)回調(diào)內(nèi)部先查內(nèi)存緩存、再查磁盤緩存、最后才發(fā)網(wǎng)絡(luò)請(qǐng)求。實(shí)際源碼里不會(huì)每幀都重新請(qǐng)求瓦片。拖動(dòng)地圖時(shí)控件只調(diào)整屏幕偏移量等松手后再補(bǔ)齊邊緣缺失的瓦片這也是它手感比大多數(shù)自繪地圖流暢的原因。你研究源碼時(shí)重點(diǎn)看控件的 OnMouseMove 和 OnPaint 之間的配合就能理解這套增量繪制策略。2.2 投影換算屏幕坐標(biāo)和經(jīng)緯度之間隔著三道計(jì)算地圖組件繞不開(kāi)投影。GMAP.net 用 PureProjection 抽象類封裝了投影邏輯派生類里有 Web Mercator 和 WGS84 兩種常見(jiàn)實(shí)現(xiàn)。屏幕上每個(gè)像素和經(jīng)緯度之間的換算不是一步到位而是經(jīng)過(guò)“經(jīng)緯度 → 世界平面坐標(biāo) → 瓦片坐標(biāo) → 屏幕坐標(biāo)”三層轉(zhuǎn)換。下面是從源碼里抽取出來(lái)的正向與反向換算核心公式public GPoint FromLatLngToPixel(PointLatLng p, int zoom) { double size MapSize(zoom); double x (p.Lng 180.0) / 360.0 * size; double sinLat Math.Sin(p.Lat * Math.PI / 180.0); double y 0.5 - Math.Log((1 sinLat) / (1 - sinLat)) / (4 * Math.PI); return new GPoint((long)(x * 100000), (long)(y * 100000)); } public PointLatLng FromPixelToLatLng(GPoint p, int zoom) { double size MapSize(zoom); double lng (p.X / 100000.0 / size * 360.0) - 180.0; double n Math.PI - 2.0 * Math.PI * p.Y / 100000.0 / size; double lat 180.0 / Math.PI * Math.Atan(Math.Sinh(n)); return new PointLatLng(lat, lng); }參數(shù)說(shuō)明MapSize(zoom) 返回當(dāng)前縮放級(jí)別下整個(gè)世界地圖的像素邊長(zhǎng)等于 256 * 2^zoom。zoom 每加 1世界像素尺寸翻倍。為什么這里要乘 100000因?yàn)?GPoint 內(nèi)部用整數(shù)保存坐標(biāo)直接存小數(shù)會(huì)丟失精度放大 10 萬(wàn)倍后能保留約 1e-5 度的精度能覆蓋絕大多數(shù) GIS 場(chǎng)景。如果你發(fā)現(xiàn)地圖上的標(biāo)記和道路有偏移優(yōu)先檢查投影是否選錯(cuò)。GMAP.net 里不同 Provider 自帶投影實(shí)現(xiàn)混用會(huì)導(dǎo)致幾百米的漂移。這個(gè)現(xiàn)象在調(diào)第三方 Provider 時(shí)經(jīng)常出現(xiàn)我一般會(huì)先打印 Provider 的 Projection 類型再繼續(xù)排查。2.3 兩級(jí)緩存與并發(fā)請(qǐng)求離線地圖為什么也能流暢GMAP.net 的地圖加載性能靠的是兩級(jí)緩存內(nèi)存緩存和磁盤緩存。內(nèi)存緩存存最近用過(guò)的 Bitmap避免同一張瓦片被重復(fù)解碼磁盤緩存則把瓦片持久化到本地重啟程序后仍然有效。這層設(shè)計(jì)是離線地圖的基礎(chǔ)。緩存層存儲(chǔ)位置典型大小作用內(nèi)存緩存進(jìn)程內(nèi) Dictionary / LRU 隊(duì)列幾十 MB避免重復(fù)解碼提升拖動(dòng)流暢度磁盤緩存本地目錄或 SQLite 文件幾百 MB 到幾十 GB跨會(huì)話復(fù)用離線可用網(wǎng)絡(luò)源遠(yuǎn)程瓦片服務(wù)無(wú)緩存未命中時(shí)的兜底來(lái)源磁盤緩存的寫入是異步的控件拿到網(wǎng)絡(luò)瓦片后先顯示再排進(jìn)寫盤隊(duì)列。所以你在源碼里能看到獨(dú)立的寫盤線程和讀盤線程隊(duì)列用信號(hào)量控制并發(fā)數(shù)避免拖動(dòng)時(shí)瞬間發(fā)起幾十個(gè) HTTP 請(qǐng)求把帶寬打滿。離線包的本質(zhì)就是預(yù)填磁盤緩存。把目標(biāo)區(qū)域常用縮放級(jí)別的瓦片全部請(qǐng)求一遍之后斷網(wǎng)時(shí)命中磁盤緩存表現(xiàn)和在線幾乎一樣。后面第 6 章我會(huì)給一個(gè)預(yù)取腳本模板直接抄就能用。3. 把源碼跑起來(lái)項(xiàng)目結(jié)構(gòu)、初始化與第一個(gè)可交互地圖3.1 解壓后先看這些目錄源碼包解壓后第一眼會(huì)看到多個(gè) Visual Studio 工程。別急著全部編譯先按依賴關(guān)系把項(xiàng)目認(rèn)清楚目錄/工程職責(zé)引用關(guān)系GMap.NET.Core投影、瓦片 Provider 基類、緩存、工具類不依賴 UI是最底層GMap.NET.WindowsFormsWinForms 控件 GMapControl、Overlay、Marker、Route引用 CoreGMap.NET.WindowsPresentationWPF 版本控件引用 Core與 WinForms 版互斥Demo / Sample示例窗體展示基本用法引用上述 UI 工程Plugins擴(kuò)展插件如 GPS 模塊按需引用我一般只保留 Core 和 WindowsForms 兩個(gè)工程把其余工程從解決方案里卸載。原因是老架構(gòu)的源碼包往往同時(shí)包含 WinForms 和 WPF 兩個(gè)版本同時(shí)編譯會(huì)引入不必要的框架版本沖突尤其當(dāng)你本機(jī)只裝了 .NET Framework 4.x 時(shí)WPF 工程經(jīng)常報(bào)目標(biāo)框架不匹配。還有一個(gè)容易忽略的文件是 app.config 或 .manifest 文件里面可能聲明了控件運(yùn)行所需的權(quán)限和依賴。如果編譯后運(yùn)行報(bào)找不到某個(gè) DLL先檢查是不是用了強(qiáng)命名程序集再確認(rèn)引用是否指向正確的輸出路徑。3.2 最小初始化對(duì)照 Demo 配出自己的地圖窗體建議先建一個(gè)空白 WinForms 項(xiàng)目把 GMap.NET.Core 和 GMap.NET.WindowsForms 兩個(gè)工程引用進(jìn)來(lái)然后寫最小初始化代碼。這是最快跑通的方式比直接改 Demo 更不容易被無(wú)關(guān)功能干擾。public partial class MainForm : Form { private GMapControl _map; public MainForm() { InitializeComponent(); _map new GMapControl(); _map.Dock DockStyle.Fill; _map.MapProvider GMapProviders.OpenStreetMap; _map.Position new PointLatLng(31.2304, 121.4737); _map.MinZoom 3; _map.MaxZoom 18; _map.Zoom 12; _map.ShowCenter false; Controls.Add(_map); } }這段代碼把地圖控件鋪滿窗體。MapProvider 決定瓦片來(lái)源OpenStreetMap 是免 Key 的公共瓦片服務(wù)適合先驗(yàn)證鏈路。Position 是中心點(diǎn)經(jīng)緯度這里給的是上海人民廣場(chǎng)附近。MinZoom 和 MaxZoom 限制縮放范圍避免用戶滑到空白區(qū)域。ShowCenter 建議設(shè)成 false否則地圖正中心會(huì)有一個(gè)紅色十字截圖交付時(shí)會(huì)顯得不專業(yè)。注意如果你的網(wǎng)絡(luò)環(huán)境訪問(wèn)不了特定瓦片服務(wù)地圖會(huì)顯示空白程序不報(bào)錯(cuò)。這種情況優(yōu)先嘗試更換 Provider或者切到離線模式再驗(yàn)證。3.3 在線與離線兩條路兩個(gè) Provider 的不同換法在線地圖直接換 MapProvider 就行。OpenStreetMap 免 KeyGoogle 系 Provider 需要自己在屬性面板里配 Key否則瓦片請(qǐng)求會(huì)返回 401 或 403。換 Provider 很簡(jiǎn)單但有一個(gè)邊界條件不同 Provider 的縮放級(jí)別范圍不同有的最大到 19有的只到 18切換時(shí)記得同步調(diào)整 MaxZoom。離線地圖則要寫自定義 Provider。很多使用 GMAP.net 的人不知道這個(gè)入口以為離線必須依賴別人寫好的 Provider。其實(shí) GMapProvider 基類留了一個(gè) GetTileImage 虛方法只要從本地文件讀瓦片并返回即可public class LocalFileProvider : GMapProvider { public static readonly LocalFileProvider Instance new LocalFileProvider(); private readonly string _root; public LocalFileProvider(string root) { _root root; MaxZoom 18; RefererUrl http://localhost/; } public override Guid Id { get; } Guid.NewGuid(); public override string Name { get; } LocalFileProvider; public override PureImage GetTileImage(GPoint pos, int zoom) { string path Path.Combine(_root, zoom.ToString(), pos.X.ToString(), pos.Y .png); if (!File.Exists(path)) return null; using (var fs File.OpenRead(path)) { using (var img Image.FromStream(fs)) { var result new GMapImage(); result.Img (Image)img.Clone(); return result; } } } }這個(gè) Provider 按 zoom/x/y.png 的目錄結(jié)構(gòu)讀取本地瓦片。pos.X 和 pos.Y 分別是瓦片列號(hào)和行號(hào)。文件不存在時(shí)返回 null控件會(huì)繪制透明底色不會(huì)崩。Id 和 Name 是基類要求實(shí)現(xiàn)的屬性Guid 用隨機(jī)值即可。注意靜態(tài)實(shí)例 Instance 的寫法Provider 會(huì)被頻繁調(diào)用每次 new 會(huì)產(chǎn)生大量臨時(shí)對(duì)象單例能省掉這部分開(kāi)銷。拿到離線包時(shí)先確認(rèn)瓦片目錄是不是這種標(biāo)準(zhǔn)結(jié)構(gòu)如果不是要么寫一個(gè)重命名腳本要么改這個(gè) Provider 的拼接邏輯。我見(jiàn)過(guò)不少自己用爬蟲下瓦片的包目錄結(jié)構(gòu)千奇百怪這種情況最好以 Provider 適配目錄而不是反過(guò)來(lái)改數(shù)據(jù)。4. 地圖上畫東西標(biāo)記、路線、多邊形與軌跡回放4.1 標(biāo)記把坐標(biāo)點(diǎn)變成可點(diǎn)擊的 UIGMAP.net 引入 Overlay 來(lái)管理地圖上的元素。一個(gè) Overlay 是一層透明畫布控件可以疊加多個(gè) Overlay比如“車輛層”“站點(diǎn)層”“圍欄層”每一層可以單獨(dú)顯示或隱藏。往 Overlay 里加 Markers 就是最基本的打點(diǎn)private GMapOverlay _markerOverlay; void InitMarkers() { _markerOverlay new GMapOverlay(markers); _map.Overlays.Add(_markerOverlay); GMarkerGoogle marker new GMarkerGoogle( new PointLatLng(31.2304, 121.4737), GMarkerGoogleType.red_dot); marker.ToolTipText 站點(diǎn)A; marker.ToolTipMode MarkerTooltipMode.OnMouseOver; _markerOverlay.Markers.Add(marker); }GMarkerGoogle 是內(nèi)置的圖釘類可以直接用預(yù)置圖標(biāo)適合快速驗(yàn)證。ToolTipMode 可以設(shè)成 Always 或 OnMouseOver現(xiàn)場(chǎng)演示時(shí)一般用 Always正式交付時(shí)用 OnMouseOver 避免遮擋地圖。當(dāng)標(biāo)記數(shù)量超過(guò)幾千個(gè)時(shí)直接把全部 Markers 塞進(jìn) Overlay 會(huì)卡頓。常見(jiàn)做法是只加入可視區(qū)域內(nèi)的點(diǎn)縮放或拖動(dòng)時(shí)按當(dāng)前 Bounds 過(guò)濾。GMAP.net 沒(méi)有內(nèi)置可視區(qū)域過(guò)濾需要你在更新 Overlay 前調(diào)用 _map.ViewArea 判斷坐標(biāo)是否落在矩形內(nèi)。這個(gè)坑比較隱蔽用戶說(shuō)“地圖卡死”時(shí)優(yōu)先懷疑它。4.2 折線與多邊形路徑的資源包怎么組織畫軌跡線和電子圍欄分別用 GMapRoute 和 GMapPolygon。兩者都接收 List 作為核心數(shù)據(jù)區(qū)別是 Route 只畫線Polygon 加了一個(gè)填充面。代碼結(jié)構(gòu)很接近ListPointLatLng points new ListPointLatLng { new PointLatLng(31.2304, 121.4737), new PointLatLng(31.2350, 121.4700), new PointLatLng(31.2400, 121.4800) }; GMapRoute route new GMapRoute(points, route-001) { Stroke new Pen(Color.Red, 4) }; _overlay.Routes.Add(route); GMapPolygon polygon new GMapPolygon(points, area-001) { Fill new SolidBrush(Color.FromArgb(40, Color.Blue)), Stroke new Pen(Color.Blue, 2) }; _overlay.Polygons.Add(polygon);Stroke 是畫筆Fill 是填充畫刷。FromArgb(40, Color.Blue) 里的 40 是透明度值越小越透明適合做電子圍欄的底色。注意 Polygon 的坐標(biāo)點(diǎn)順序必須是順時(shí)針或逆時(shí)針環(huán)繞亂序會(huì)畫出自相交的怪異多邊形。Route 和 Polygon 在 Overlay 內(nèi)部都是獨(dú)立列表更新其中一個(gè)不需要重建其他元素。但如果外部 points 集合后續(xù)又 Add 了新坐標(biāo)控件內(nèi)部不會(huì)自動(dòng)感知。我一般直接刪除舊 Route、重新 Add 一個(gè)簡(jiǎn)單可靠性能影響可以忽略。4.3 軌跡回放定時(shí)器驅(qū)動(dòng)的 MoveTo 思路軌跡回放是車輛監(jiān)控項(xiàng)目的高頻需求。最簡(jiǎn)單可靠的實(shí)現(xiàn)是 UI 定時(shí)器逐點(diǎn)推進(jìn)每隔固定時(shí)間把 marker 的位置更新到下一個(gè)坐標(biāo)點(diǎn)并讓地圖中心跟隨private System.Windows.Forms.Timer _timer; private ListPointLatLng _trackPoints; private int _index; void StartReplay(ListPointLatLng points) { _trackPoints points; _index 0; _timer new System.Windows.Forms.Timer(); _timer.Interval 500; _timer.Tick OnReplayTick; _timer.Start(); } void OnReplayTick(object sender, EventArgs e) { if (_index _trackPoints.Count) { _timer.Stop(); return; } PointLatLng pos _trackPoints[_index]; _vehicleMarker.Position pos; _map.Position pos; _index; }這里 Timer 的 Tick 事件運(yùn)行在 UI 線程所以直接更新 marker 和 map.Position 是安全的不需要再 Invoke。Interval 設(shè)為 500ms表示每半秒走一個(gè)點(diǎn)。如果原始軌跡的時(shí)間間隔不是固定的 500ms直接按索引播放會(huì)導(dǎo)致車速忽快忽慢正確的做法是用相鄰兩點(diǎn)的時(shí)間差動(dòng)態(tài)調(diào)整 Interval。真正做項(xiàng)目時(shí)軌跡點(diǎn)往往上萬(wàn)條全部放進(jìn) Overlay 會(huì)有兩個(gè)問(wèn)題一是繪制性能二是內(nèi)存占用。常用處理是先抽稀比如每 5 個(gè)點(diǎn)保留 1 個(gè)再分段只把當(dāng)前播放位置前后各 100 個(gè)點(diǎn)加入 Overlay其余點(diǎn)不渲染。這樣回放時(shí)既能看到車頭附近的路徑趨勢(shì)又不會(huì)卡。5. 避坑記錄五個(gè)翻車點(diǎn)與對(duì)應(yīng)修法5.1 UI 線程跨線程畫標(biāo)記直接白屏現(xiàn)象后臺(tái)線程通過(guò)串口或 TCP 拿到 GPS 數(shù)據(jù)后直接調(diào)用 markerOverlay.Markers.Add界面一陣抖動(dòng)后白屏或者直接拋出“線程間操作無(wú)效”。原因WinForms 控件的內(nèi)部狀態(tài)只能在創(chuàng)建它的線程里修改。地圖控件的 Overlay 集合本質(zhì)是 UI 資源后臺(tái)線程修改會(huì)破壞繪制狀態(tài)導(dǎo)致渲染異常。解決所有對(duì) Overlay 的增刪操作都通過(guò) BeginInvoke 切回 UI 線程或者用生產(chǎn)者消費(fèi)者模式后臺(tái)線程只放數(shù)據(jù)UI 定時(shí)器負(fù)責(zé)消費(fèi)并更新地圖。private void AddMarkerSafe(PointLatLng pos) { if (_map.InvokeRequired) { _map.BeginInvoke(new ActionPointLatLng(AddMarkerSafe), pos); return; } _markerOverlay.Markers.Add(new GMarkerGoogle(pos, GMarkerGoogleType.red_dot)); }BeginInvoke 是異步的不會(huì)阻塞后臺(tái)數(shù)據(jù)接收線程。高頻 GPS 數(shù)據(jù)流比如 10Hz也可以直接這樣丟過(guò)來(lái)UI 線程會(huì)按自己的節(jié)奏處理不會(huì)堆積到界面卡死。5.2 地圖 Key 失效在線瓦片突然一片灰現(xiàn)象昨天還能正常顯示的地圖今天打開(kāi)后所有瓦片加載不出來(lái)重試也沒(méi)用控制臺(tái)或網(wǎng)絡(luò)抓包看到 401、403 狀態(tài)碼。原因部分在線 Provider 的瓦片服務(wù)需要 Key而 Key 有配額限制和有效期還有的 Provider 會(huì)校驗(yàn) Referer 頭程序默認(rèn)的 RefererUrl 不對(duì)也會(huì)被拒絕。這類問(wèn)題看起來(lái)像網(wǎng)絡(luò)故障實(shí)際上是鑒權(quán)失敗。解決先確認(rèn) Provider 的 RefererUrl 設(shè)置再檢查 Key 是否過(guò)期。開(kāi)發(fā)驗(yàn)證階段可以臨時(shí)換用 OpenStreetMap 這種免 Key 服務(wù)兜底。生產(chǎn)環(huán)境不要把在線地圖作為硬依賴把常用區(qū)域提前預(yù)取到離線緩存Key 掛了業(yè)務(wù)也能繼續(xù)跑。5.3 緩存膨脹一個(gè)季度跑出幾十 GB現(xiàn)象長(zhǎng)時(shí)間連續(xù)運(yùn)行的程序磁盤空間越來(lái)越小最后發(fā)現(xiàn)地圖緩存目錄占了二三十 GB。原因GMAP.net 默認(rèn)會(huì)把所有請(qǐng)求過(guò)的瓦片寫入磁盤緩存高縮放級(jí)別的瓦片文件數(shù)量巨大而且沒(méi)有自動(dòng)清理機(jī)制。多個(gè) Provider 還會(huì)分別建立子目錄總量疊加后非?？捎^。解決初始化時(shí)把緩存目錄指向明確位置并加上定期清理任務(wù)。更激進(jìn)的做法是直接用 SQLite 緩存模式按時(shí)間和縮放級(jí)別刪除過(guò)期數(shù)據(jù)string cachePath Path.Combine(Application.StartupPath, MapCache); Directory.CreateDirectory(cachePath); _map.CacheLocation cachePath;設(shè)置 CacheLocation 要在任何地圖操作之前完成運(yùn)行中修改很可能不生效。長(zhǎng)時(shí)間掛機(jī)的大屏項(xiàng)目建議每周清理一次低縮放級(jí)別的瓦片保留當(dāng)前城市的高縮放級(jí)別即可。5.4 高 DPI 模糊字體銳利但地圖馬賽克現(xiàn)象在 4K 高分屏上運(yùn)行窗體文字和按鈕都清晰唯獨(dú)地圖區(qū)域糊成一片標(biāo)記和折線邊緣有鋸齒。原因WinForms 默認(rèn)不啟用 DPI 感知系統(tǒng)會(huì)把整個(gè)界面按照縮放比例拉伸位圖瓦片被放大后產(chǎn)生明顯馬賽克。解決在 app.manifest 中聲明 PerMonitorV2 DPI 感知讓程序自己處理不同縮放級(jí)別的顯示器而不是交給系統(tǒng)做位圖縮放。application xmlnsurn:schemas-microsoft-com:asm.v3 windowsSettings dpiAwarenessPerMonitorV2/dpiAwareness dpiAwaretrue/dpiAware /windowsSettings /application改完 manifest 后重新編譯即可。如果項(xiàng)目里還有其他自定義控件也要確認(rèn)它們支持 DPI 重新縮放否則會(huì)出現(xiàn)文字清晰、地圖清晰、某個(gè)自定義畫布錯(cuò)位的詭異組合。5.5 內(nèi)存泄漏反復(fù)開(kāi)關(guān)窗體內(nèi)存只漲不降現(xiàn)象程序里多次打開(kāi)和關(guān)閉地圖窗體任務(wù)管理器顯示內(nèi)存每次都會(huì)漲幾 MB長(zhǎng)時(shí)間運(yùn)行后接近崩潰。原因窗體關(guān)閉時(shí)只觸發(fā)了 Close沒(méi)有調(diào)用地圖控件的 DisposeGMapControl 內(nèi)部的 Bitmap 對(duì)象和 GDI 句柄沒(méi)有被釋放。如果窗體還訂閱了定時(shí)器事件或網(wǎng)絡(luò)回調(diào)那泄漏更嚴(yán)重。解決在 FormClosing 事件里解除事件訂閱并顯式釋放控件資源private void MainForm_FormClosing(object sender, FormClosingEventArgs e) { if (_timer ! null) { _timer.Stop(); _timer.Tick - OnReplayTick; _timer.Dispose(); } _map.Dispose(); }定時(shí)器必須先 Stop 再解除事件否則即使 Dispose 了窗體事件鏈仍然握著引用。這個(gè)坑用常規(guī)內(nèi)存分析工具不太好定位看起來(lái)像黑匣子只有跟蹤 GDI 句柄數(shù)才能確認(rèn)泄漏源。6. 收尾技巧用緩存分目錄做離線驗(yàn)收省下每次聯(lián)調(diào)時(shí)間每次改完地圖相關(guān)功能都要反復(fù)在有網(wǎng)絡(luò)的環(huán)境里打開(kāi)地圖確認(rèn)效果既慢又容易被瓦片服務(wù)波動(dòng)干擾。我的習(xí)慣是先跑一遍預(yù)取腳本把目標(biāo)區(qū)域的高縮放級(jí)別瓦片全部拉進(jìn)本地緩存然后斷網(wǎng)驗(yàn)收全部功能。這樣一來(lái)后續(xù)所有調(diào)試都在穩(wěn)定、可控的本地?cái)?shù)據(jù)上進(jìn)行不再受外部服務(wù)影響。預(yù)取腳本的核心是按當(dāng)前 Provider 的投影算出中心點(diǎn)附近指定范圍內(nèi)的所有瓦片索引再逐個(gè)請(qǐng)求。GMAP.net 的 Provider 自帶 Projection 屬性可以從經(jīng)緯度換算到像素坐標(biāo)private void PrefetchAround(GMapControl map, PointLatLng center, int minZoom, int maxZoom, int radius) { for (int zoom minZoom; zoom maxZoom; zoom) { GPoint centerPixel map.MapProvider.Projection.FromLatLngToPixel(center, zoom); GPoint centerTile new GPoint(centerPixel.X / 256, centerPixel.Y / 256); for (long x centerTile.X - radius; x centerTile.X radius; x) { for (long y centerTile.Y - radius; y centerTile.Y radius; y) { GPoint tilePos new GPoint(x, y); using (PureImage img map.MapProvider.GetTileImage(tilePos, zoom)) { // 請(qǐng)求完成后瓦片會(huì)自動(dòng)寫入磁盤緩存 } } } } }radius 是瓦片半徑比如 radius 設(shè)為 10每個(gè)縮放級(jí)別預(yù)取 21*21 個(gè)瓦片。minZoom 到 maxZoom 之間逐級(jí)掃描優(yōu)先選 12 到 16 級(jí)這個(gè)區(qū)間在城市級(jí)項(xiàng)目中視覺(jué)效果和存儲(chǔ)體積比較均衡。如果只驗(yàn)收某個(gè)區(qū)縣的軌跡回放radius 給 5 到 8 就夠了。預(yù)取完成后再把_map.CacheType GMap.NET.CacheType.Disk和_map.CacheLocation指到對(duì)應(yīng)目錄斷網(wǎng)后地圖控件會(huì)直接從磁盤緩存讀取。這個(gè)流程跑通后我再也沒(méi)被“瓦片服務(wù)抽風(fēng)”折騰過(guò)。從那以后我每次拿到 GMAP.net 源代碼包都強(qiáng)制先跑一遍離線驗(yàn)收流程在線預(yù)取目標(biāo)區(qū)域、斷網(wǎng)、再驗(yàn)證標(biāo)記和軌跡鏈路。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取