C# .NET 8 WinForms应用中GMap.NET加载离线MBTiles地图的实现问题

你好！我明白你现在遇到的困扰——在线时地图正常显示，但离线状态下无法加载你下载的MBTiles文件。其实问题出在当前的代码配置上，默认的Google地图提供者并不支持直接读取MBTiles格式，而且你的访问模式还保留了服务器请求优先级，下面我一步步帮你解决：

核心问题分析 #

你当前使用的GMapProviders.GoogleMap是在线地图提供者，它只会读取GMap.NET默认缓存格式的瓦片（并非MBTiles），所以即使你设置了CacheLocation为MBTiles文件路径，这个提供者也不会去读取它。同时AccessMode.ServerAndCache模式下，离线时程序还是会尝试请求服务器，最终导致地图加载失败。

解决方案步骤 #

1. 安装MBTiles支持的NuGet包

首先确保你已经安装了GMap.NET.MBTiles包（如果没有，右键项目→管理NuGet包，搜索并安装即可），这个包提供了专门读取MBTiles文件的地图提供者。

2. 修改代码配置

下面是调整后的完整代码，我标注了关键修改点：

using GMap.NET;
using GMap.NET.MapProviders;
using GMap.NET.WindowsForms;
using GMap.NET.MBTiles; // 新增：引用MBTiles相关命名空间
using System;
using System.Windows.Forms;

namespace harita_3_offline
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e)
        {
            /* Map Config */
            // 关键修改1：设置访问模式为CacheOnly，避免离线时尝试请求服务器
            GMaps.Instance.Mode = AccessMode.CacheOnly;

            // 关键修改2：初始化MBTiles地图提供者，指定你的mbtiles文件路径
            var mbTilesProvider = new MBTilesMapProvider(@"D:\\cache\\turkey.mbtiles");
            gMapControl1.MapProvider = mbTilesProvider;

            gMapControl1.DragButton = MouseButtons.Left;
            gMapControl1.Position = new PointLatLng(37.87425528270441, 32.493648881146235);
            // 注意：请确认你的MBTiles文件包含以下缩放级别的瓦片，否则部分级别会无法加载
            gMapControl1.MinZoom = 1;
            gMapControl1.MaxZoom = 20;
            gMapControl1.Zoom = 15;
            gMapControl1.ShowCenter = false;
            /* ./Map Config */
        }
    }
}

3. 额外注意事项

• 坐标系匹配：确保你下载的MBTiles文件使用的是Web墨卡托投影（EPSG:3857），这是GMap.NET默认使用的坐标系，如果你的MBTiles是其他坐标系，可能需要额外配置投影转换。
• 缩放级别覆盖：检查你的MBTiles文件实际包含的缩放级别，如果文件里没有1-20级的全部瓦片，建议调整MinZoom和MaxZoom为文件实际支持的范围，避免出现空白区域。
• 在线/离线切换（可选）：如果需要在在线时使用Google地图、离线时自动切换到MBTiles，可以添加网络状态判断逻辑：

  // 示例：判断网络连接（需要添加System.Net.NetworkInformation引用）
  bool isOnline = System.Net.NetworkInformation.NetworkInterface.GetIsNetworkAvailable();
  if (isOnline)
  {
      GMaps.Instance.Mode = AccessMode.ServerAndCache;
      gMapControl1.MapProvider = GMapProviders.GoogleMap;
  }
  else
  {
      GMaps.Instance.Mode = AccessMode.CacheOnly;
      gMapControl1.MapProvider = new MBTilesMapProvider(@"D:\\cache\\turkey.mbtiles");
  }
  

这样修改后，离线状态下程序就会直接读取你下载的MBTiles文件里的地图瓦片，不再依赖网络啦。

备注：内容来源于stack exchange，提问作者Baran Kanat