maui-maps
Installation
SKILL.md
.NET MAUI Maps
Common gotchas
| Issue | Fix |
|---|---|
| Map is blank on Android | Google Maps API key missing or wrong in AndroidManifest.xml |
| Map crashes on startup | .UseMauiMaps() not called in MauiProgram.cs |
Map type ambiguous |
Conflicts with Microsoft.Maui.ApplicationModel.Map — add namespace alias |
| Map doesn't show on Windows | Windows has no native support — must use CommunityToolkit.Maui.Maps |
| User location dot missing | IsShowingUser="True" set but location permission not granted |
| Android 11+ can't launch external map app | Missing <queries> for geo scheme in manifest |
⚠️ Name conflict — always alias
Microsoft.Maui.Controls.Maps.Map conflicts with Microsoft.Maui.ApplicationModel.Map. This causes confusing compile errors.
// ✅ Correct — explicit alias
Related skills