Windows MAUI Maps中MapIcon类去向及自定义图标实现求助

核心问题原因 #

MAUI Windows平台基于WinUI 3，WinUI的MapIcon API与Xamarin.UWP时期的版本存在差异：原Xamarin中MapIcon的Image属性已被移除，替换为ImageBitmap属性，这是你找不到该属性的直接原因。

正确实现步骤 #

1. 确认所需命名空间与引用 #

确保项目满足以下条件：

• 已安装Microsoft.Maui.Maps NuGet包
• 代码中引入必要命名空间：

  using Microsoft.UI.Xaml.Controls.Maps;
  using Windows.Storage.Streams;
  using Windows.Devices.Geolocation;
  

2. 替换Image为ImageBitmap #

修改代码，将原Image属性赋值改为ImageBitmap，示例如下：

// 创建地图图标实例
var mapIcon = new MapIcon
{
    // 替换原Image属性为ImageBitmap
    ImageBitmap = RandomAccessStreamReference.CreateFromUri(new Uri(iconUri)),
    Location = new Geopoint(location),
    Title = "自定义标记" // 可选：设置图标显示标题
};

// 将图标添加到原生地图控件
nativeMap.MapElements.Add(mapIcon);

3. MAUI推荐方案：使用Handler替代自定义渲染器 #

MAUI官方推荐使用Handler而非传统自定义渲染器，以下是简化的Handler实现示例：

// 在MauiProgram.cs中注册自定义Handler
builder.ConfigureMauiHandlers(handlers =>
{
#if WINDOWS
    handlers.AddHandler<Microsoft.Maui.Controls.Map, CustomMapHandler>();
#endif
});

// 自定义MapHandler类
public class CustomMapHandler : Microsoft.Maui.Maps.Handlers.MapHandler
{
    protected override void ConnectHandler(MapControl platformView)
    {
        base.ConnectHandler(platformView);
        // 在这里添加自定义图标逻辑
        var targetLocation = new BasicGeoposition { Latitude = 47.6062, Longitude = -122.3321 };
        var iconUri = "ms-appx:///Assets/CustomPin.png"; // 应用内资源路径
        var customIcon = new MapIcon
        {
            ImageBitmap = RandomAccessStreamReference.CreateFromUri(new Uri(iconUri)),
            Location = new Geopoint(targetLocation)
        };
        platformView.MapElements.Add(customIcon);
    }
}

常见问题排查 #

• 若仍提示找不到ImageBitmap：确认项目的Windows目标版本已设置为Windows 10 2004 (10.0.19041.0) 或更高，该属性在较旧WinUI版本中未提供。
• 图标不显示：检查图标路径是否正确——应用内资源需使用ms-appx:///前缀，网络资源需确保URI格式合法且应用已获取网络权限。

内容的提问来源于stack exchange，提问作者AWC