MAUI集成地图首选官方Microsoft.Maui.Controls.Maps（支持iOS/Android原生地图），需配置平台权限与XAML/C#代码；国内项目推荐高德Web方案（JS API+WebView），需申请Web Key并确保DOM加载完成后再初始化。
MAUI 集成地图控件主要有两种路径：一是用官方内置的 Microsoft.Maui.Controls.Maps（基于各平台原生地图，如 iOS 的 MapKit、Android 的 Google Maps）；二是对接国内地图 SDK（如高德、百度），需手动绑定或 Web 集成。选哪种取决于你的目标平台、合规要求和功能需求。
用官方 Maps 控件快速上手
这是最轻量、跨平台支持最稳的方式，适合展示位置、打点、画线等基础场景。
- Android 必须在
AndroidManifest.xml添加定位权限： - iOS 需在
Info.plist加描述键：NSLocationWhenInUseUsageDescription 需要访问您的位置以显示地图 - XAML 中直接引用控件：
- C# 中设置初始视野和交互：
用MapSpan.FromCenterAndRadius()定义中心与缩放范围；
绑定MapClicked事件响应点击，用Pin添加图钉。
集成高德地图（推荐国内项目）
官方 Maps 在国内无法加载地图瓦片，必须换用高德或百度。推荐 Web 方式接入，兼容性好、无需原生绑定。
- 去高德开放平台注册账号，创建应用，获取 Web 端 Key（注意不是 Android/iOS SDK Key）
- 在 MAUI Blazor 或 WebView 页面中引入高德 JS API：
下载loader.js放入wwwroot，HTML 中通过 script 引入；
初始化时调用AMap.initAMapApiLoader({ key: 'your-key' }) - 确保容器有明确宽高（如
style="width:100%;height:500px;"），且等待 DOM 加载完成再 new AMap.Map() - 若需定位，调用
AMap.Geolocation并处理用户授权逻辑（iOS/Android 需额外配置隐私弹窗）
集成百度地图（适用于 DCloud 或原生混合方案）
如果你用的是基于 uni-app 或 plus.maps 的 MAUI 混合架构（比如某些 MUI 封装项目），百度更常见。
- 在百度地图开放平台申请 Android/iOS SDK AK，注意填写正确的包名和 SHA1（DCloud 公用证书可复用）
- 修改
manifest.json，在plus.distribute.plugins.maps.baidu节点填入对应 appkey - 页面中用
plus.maps.Map("allmap")初始化，ID 对应 div 的 id 属性 - 务必监听
DOMContentLoaded和plusReady，避免地图容器未就绪就初始化
注意事项与避坑点
无论哪种方式，这几个细节容易出错：
- Android 模拟器默认无 GPS，真机调试前确认定位服务已开启
- iOS 上首次请求定位会弹系统授权框，
Info.plist缺少描述会导致白屏或崩溃 - 高德/百度 JS API 在 MAUI WebView 中运行正常，但需启用 JavaScript 支持（
WebView.IsJavaScriptEnabled = true） - 不要在后台线程操作地图控件——所有地图相关调用必须在 UI 线程执行
基本上就这些。官方控件够用就别折腾；要在国内上线，高德 Web 方案最省心，稳定且更新及时。
