如何在离线WPF C#应用中使用DevExpress MapControl显示GeoTiff及带地理编码的TIFF/BMP/PNG离线地图

阿华AIGC实验室

2026-4-16

嘿，我来帮你把这个离线地图的实现捋清楚！你已经跟着教程写了部分代码，咱们先把核心要点和完整实现补全——毕竟离线场景下加载带地理编码的图片，有几个关键细节不能错：

首先得明确：普通的TIFF/BMP/PNG是没法直接在地图控件里正确显示地理位置的，必须是带有地理参考信息的文件（比如包含经纬度范围、投影坐标系），如果你的图片还没做地理编码，得先用GDAL、ArcGIS这类工具给它加上坐标边界信息。

接下来看你的代码，你目前用的是VectorLayer，但加载地理图片地图得用ImageLayer搭配GeoImageDataProvider才对——VectorLayer是用来处理矢量数据的，咱们调整下配置：

完整XAML配置示例

<dxm:MapControl x:Name="map" FlowDirection="LeftToRight" MaxZoomLevel="19" 
                CenterPoint="{Binding Source={x:Static properties:Settings.Default}, Path=MapCenterPoint}" 
                ZoomLevel="17">
    <dxm:MapControl.Layers>
        <!-- 核心：用ImageLayer加载地理参考图片 -->
        <dxm:ImageLayer>
            <dxm:GeoImageDataProvider>
                <!-- 指定你的离线地图文件路径：本地路径/内嵌资源都可以 -->
                <dxm:GeoImageDataProvider.Source>
                    <!-- 内嵌资源格式示例，本地路径直接写文件路径即可 -->
                    <BitmapImage UriSource="pack://application:,,,/YourProject;component/Resources/OfflineMap.tif" />
                </dxm:GeoImageDataProvider.Source>
                <!-- 必须设置图片对应的地理边界！这是地图能正确定位的关键 -->
                <dxm:GeoImageDataProvider.Bounds>
                    <dxm:MapBounds>
                        <dxm:MapBounds.NorthEast>
                            <!-- 替换成你地图的右上角经纬度 -->
                            <dxm:GeoPoint Latitude="39.9042" Longitude="116.4074" />
                        </dxm:MapBounds.NorthEast>
                        <dxm:MapBounds.SouthWest>
                            <!-- 替换成你地图的左下角经纬度 -->
                            <dxm:GeoPoint Latitude="39.8042" Longitude="116.3074" />
                        </dxm:MapBounds.SouthWest>
                    </dxm:MapBounds>
                </dxm:GeoImageDataProvider.Bounds>
            </dxm:GeoImageDataProvider>
        </dxm:ImageLayer>
        <!-- 如果你还有矢量数据需要展示，可以保留原来的VectorLayer -->
        <dxm:VectorLayer EnableSelection="False">
            <dxm:MapItemStorage>
                <!-- 你的矢量数据内容 -->
            </dxm:MapItemStorage>
        </dxm:VectorLayer>
    </dxm:MapControl.Layers>
</dxm:MapControl>

关键注意事项

文件路径处理：如果是本地文件，直接写绝对路径（比如C:\Maps\MyGeoMap.png）；如果是项目内嵌资源，要用pack URI格式，确保编译时资源被正确嵌入。
地理边界必须准确：Bounds里的东北、西南角坐标必须和你的地图实际覆盖的地理范围完全匹配，不然地图会出现偏移、拉伸或者不显示的问题。
离线状态保障：别给MapControl添加任何在线瓦片服务（比如BingMapDataProvider），避免应用在离线时尝试联网，导致报错或加载失败。

如果需要后台动态加载地图

要是你想在C#代码里动态设置地图源和边界，也可以这么写：

// 初始化地理图片数据提供者
var geoImageProvider = new GeoImageDataProvider();
// 设置离线地图文件路径
geoImageProvider.Source = new BitmapImage(new Uri(@"C:\OfflineMaps\MyGeoTiff.tif"));
// 设置地图覆盖的地理范围
geoImageProvider.Bounds = new MapBounds(
    new GeoPoint(39.9042, 116.4074), // 东北角坐标
    new GeoPoint(39.8042, 116.3074)  // 西南角坐标
);
// 创建图片图层并添加到MapControl
var imageLayer = new ImageLayer();
imageLayer.DataProvider = geoImageProvider;
map.Layers.Add(imageLayer);