如何在.NET MAUI移动应用中使用Mapbox地图及路线API服务

针对你遇到的Mapbox.Maui包不兼容问题，以下是几种可行的解决方案：

一、手动集成Mapbox原生SDK（Android/iOS） #

由于官方暂未推出稳定的MAUI专用包，可通过MAUI的原生视图绑定能力，直接集成Mapbox的Android/iOS原生SDK：

Android端配置 #

1. 在Platforms/Android/AndroidManifest.xml添加必要权限：

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.INTERNET" />

2. 在Platforms/Android/build.gradle中引入Mapbox仓库和依赖：

repositories {
    maven { url 'https://api.mapbox.com/downloads/v2/releases/maven' }
}

dependencies {
    implementation 'com.mapbox.mapboxsdk:mapbox-android-sdk:10.16.0'
}

3. 自定义MAUI视图处理器，绑定原生MapView：

public class MapboxMapHandler : ViewHandler<IMapboxMap, MapView>
{
    protected override MapView CreatePlatformView()
    {
        var mapView = new MapView(Context);
        Mapbox.GetInstance(Context, "你的Mapbox Access Token");
        mapView.OnCreate(null);
        mapView.GetMapAsync(mapboxMap =>
        {
            mapboxMap.SetStyle(Style.MAPBOX_STREETS);
            // 可添加摄像头位置、标记等配置
        });
        return mapView;
    }

    protected override void ConnectHandler(MapView platformView)
    {
        base.ConnectHandler(platformView);
        platformView.OnStart();
    }

    protected override void DisconnectHandler(MapView platformView)
    {
        platformView.OnStop();
        platformView.OnDestroy();
        base.DisconnectHandler(platformView);
    }
}

iOS端配置 #

1. 在Platforms/iOS/Info.plist添加权限和网络配置：

<key>NSLocationWhenInUseUsageDescription</key>
<string>需要访问位置以显示地图内容</string>
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

2. 在Platforms/iOS/Podfile添加Mapbox依赖：

pod 'Mapbox-iOS-SDK', '~> 10.16.0'

3. 自定义MAUI视图处理器，绑定原生MGLMapView：

public class MapboxMapHandler : ViewHandler<IMapboxMap, MGLMapView>
{
    protected override MGLMapView CreatePlatformView()
    {
        var mapView = new MGLMapView(CGRect.Empty);
        mapView.AutoresizingMask = UIViewAutoresizing.FlexibleWidth | UIViewAutoresizing.FlexibleHeight;
        MGLAccountManager.AccessToken = "你的Mapbox Access Token";
        mapView.StyleURL = MGLStyle.StreetsStyleURL;
        return mapView;
    }
}

最后在MAUI项目中注册自定义处理器：

// 在MauiProgram.cs中
builder.ConfigureMauiHandlers(handlers =>
{
#if ANDROID
    handlers.AddHandler<IMapboxMap, MapboxMapHandler>();
#elif IOS
    handlers.AddHandler<IMapboxMap, MapboxMapHandler>();
#endif
});

二、调用Mapbox路线REST API实现导航功能 #

无需依赖SDK，直接通过HTTP请求调用Mapbox Directions API获取路线数据，再渲染到地图上：

1. 构造请求并获取路线数据：

var origin = "37.7749,-122.4194";
var destination = "34.0522,-118.2437";
var apiUrl = $"https://api.mapbox.com/directions/v5/mapbox/driving/{origin};{destination}?access_token=你的Mapbox Access Token&geometries=geojson";

using var client = new HttpClient();
var response = await client.GetAsync(apiUrl);
var routeData = await response.Content.ReadFromJsonAsync<MapboxRouteResponse>();

// 自定义MapboxRouteResponse类映射返回的JSON结构
public class MapboxRouteResponse
{
    public List<Route> Routes { get; set; }
}

public class Route
{
    public Geometry Geometry { get; set; }
}

public class Geometry
{
    public string Type { get; set; }
    public List<List<double>> Coordinates { get; set; }
}

2. 将路线数据渲染到地图：

• Android端：使用PolylineOptions创建路线并添加到地图

var polylineOptions = new PolylineOptions()
    .AddAll(routeData.Routes[0].Geometry.Coordinates.Select(c => new LatLng(c[1], c[0])))
    .Color(Color.ParseColor("#3bb2d0"))
    .Width(5);
mapboxMap.AddPolyline(polylineOptions);

• iOS端：使用MGLPolyline创建路线并添加到地图

var coordinates = routeData.Routes[0].Geometry.Coordinates
    .Select(c => new CLLocationCoordinate2D(c[1], c[0]))
    .ToArray();
var polyline = MGLPolyline(coordinates: coordinates, count: nuint(coordinates.Length));
mapView.AddAnnotation(polyline);

三、关键注意事项 #

• 确保你的Mapbox Access Token已启用Maps和Directions API权限
• 处理平台的位置权限请求，避免地图加载异常
• 选择与当前MAUI版本兼容的Mapbox原生SDK版本（建议使用10.x系列最新版）
• 注意地图视图的生命周期管理，避免内存泄漏

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