Epic: Maps Control Improvements for .NET 11

Overview

This epic tracks improvements to the .NET MAUI Maps control for .NET 11, focusing on new functionality requested by the community and addressing feature gaps compared to native map SDKs.

Goals

• Deliver the most requested community features (pin clustering, custom icons)
• Expose commonly needed native capabilities (zoom level, camera events)
• Improve MapElement functionality (visibility, click events, layering)
• Provide better user location integration

---

Community Requested Features

🔥 High Priority (Most Voted)

Feature	Issue	Votes	Status
Pin Clustering	#11811	21	✅ PR Ready: #33831
Custom Pin Icons	#10400	13	✅ PR Ready: #33950
Zoom Level Property	#11332	6	✅ PR Ready: #33982

⭐ Medium Priority

Feature	Issue	Votes	Status
Show Info Window Programmatically	#10601	4	✅ PR Ready: #33985
Custom Map Styles (JSON)	#10706	3	✅ PR Ready: #33991
MoveToRegion Animation Control	#21046	2	✅ PR Ready: #33982
Best Fit Zoom for Pins	#10718	-	✅ PR Ready: #33982
MapElement Click Events	#28825	-	✅ PR Ready: #29101
User Location from Map	#14700	1	✅ PR Ready: #33799

🔽 Lower Priority

Feature	Issue	Votes	Status	Notes
Separate Zoom Buttons from Gestures	#17605	3	🔲 Not Started	Android-only; could use PlatformSpecific pattern

---

New Features (Gaps Identified)

Quick Wins (Low Effort)

Feature	Description	Issue	Status
MapLongClicked event	Long-press/hold event on map	N/A	✅ PR Ready: #33792
MapElement.IsVisible	Show/hide elements without removing	N/A	✅ PR Ready: #33993
MapElement.ZIndex	Control draw order/layering	N/A	✅ PR Ready: #33993
XAML TypeConverters	LocationTypeConverter, MapSpanTypeConverter, Map.Region property	N/A	✅ PR Ready: #33995
Polyline.IsGeodesic	Lines follow earth curvature	TBD	🔲 Not Started

Medium Effort

Feature	Description	Issue	Status
Camera Events	CameraPositionChanged, CameraIdle, MapLoaded	TBD	🔲 Not Started
Pin.Anchor	Position custom icon relative to location	TBD	🔲 Not Started
Polyline.StrokeDashPattern	Dashed/dotted line support	TBD	🔲 Not Started

---

Implementation Phases

Phase 1: Quick Wins ✅ COMPLETE

Low-risk, high-value additions that can ship quickly:

• MapElement Click Events (MAP-Control Polyline,Polygon,Circle OnClicked Event #28825) → PR Add Circle, Polygon, and Polyline click events for Map control #29101
• MapLongClicked event → PR Add MapLongClicked event to Map control #33792
• User Location from Map (Get Userlocation from map control #14700) → PR Add UserLocationChanged event and LastUserLocation property to Map #33799
• MapElement.IsVisible → PR Add MapElement.IsVisible and MapElement.ZIndex properties #33993
• MapElement.ZIndex → PR Add MapElement.IsVisible and MapElement.ZIndex properties #33993
• Polyline.IsGeodesic

Phase 2: Pin Enhancements ✅ COMPLETE

Most requested features:

• Pin Clustering (Provide clustering for map pins #11811) → PR Add Pin Clustering support for Maps #33831
• Custom Pin Icons (Add custom pin image/icon functionality for Maps #10400) → PR Add Custom Pin Icons support for Maps #33950
• Pin.Anchor property

Phase 3: Camera & Zoom ✅ COMPLETE

• MoveToRegion(animated) overload (Add MoveToRegion(MapSpan span, bool animated) to IMap interface for non-animated map positioning. #21046) → PR Add MoveToRegion animation control, MapSpan.FromLocations, and fix initial map animation #33982
• MapSpan.FromLocations() best-fit zoom (Provide a way to do a best fit based on a list of map pins #10718) → PR Add MoveToRegion animation control, MapSpan.FromLocations, and fix initial map animation #33982
• Zoom level control via MoveToRegion + VisibleRegion (Provide access to current map zoom level #11332) → PR Add MoveToRegion animation control, MapSpan.FromLocations, and fix initial map animation #33982
• Fix initial map animation (Maui island fly-in) (Add MoveToRegion(MapSpan span, bool animated) to IMap interface for non-animated map positioning. #21046) → PR Add MoveToRegion animation control, MapSpan.FromLocations, and fix initial map animation #33982
• Camera events (CameraPositionChanged, CameraIdle, MapLoaded)

Phase 4: Info Windows ✅ COMPLETE

• Programmatic info window (Provide a way to show pin hint window programmatically  #10601) → PR Add Pin.ShowInfoWindow() and Pin.HideInfoWindow() methods #33985

Phase 5: Styling ✅ COMPLETE

• Custom Map Styles (Customize map style #10706) → PR Add MapStyle property for custom JSON map styling (Android) #33991 (Android-only, [UnsupportedOSPlatform] for iOS/MacCatalyst/Windows)

Phase 6: XAML Experience ✅ COMPLETE

• LocationTypeConverter ("lat,lon" → Location) → PR Add XAML TypeConverters for Map coordinates (Location, MapSpan, Map.Region) #33995
• MapSpanTypeConverter ("lat,lon,latDeg,lonDeg" → MapSpan) → PR Add XAML TypeConverters for Map coordinates (Location, MapSpan, Map.Region) #33995
• Map.Region bindable property → PR Add XAML TypeConverters for Map coordinates (Location, MapSpan, Map.Region) #33995

Phase 7: MapElement Improvements

• StrokeDashPattern for Polyline

Phase 8: Advanced

• Separate Zoom Buttons from Gestures (MAUI Map: Please provide a way to disable zoom buttons but use pinch/expand gestures #17605)

---

Non-Goals (Out of Scope)

• ❌ Windows/WinUI Map support (tracked separately in Map for WinUI #12694)
• ❌ Offline map caching (depends on native SDK limitations)
• ❌ Indoor maps / floor plans
• ❌ Turn-by-turn directions

---

Related Issues & PRs

Completed PRs:

• Add Circle, Polygon, and Polyline click events for Map control #29101 - MapElement Click Events (Circle, Polygon, Polyline) ✅
• Add MapLongClicked event to Map control #33792 - MapLongClicked Event ✅
• Add UserLocationChanged event and LastUserLocation property to Map #33799 - User Location from Map (LastUserLocation, UserLocationChanged) ✅
• Add Pin Clustering support for Maps #33831 - Pin Clustering ✅
• Add Custom Pin Icons support for Maps #33950 - Custom Pin Icons ✅
• Add MoveToRegion animation control, MapSpan.FromLocations, and fix initial map animation #33982 - Camera & Zoom (MoveToRegion animation, MapSpan.FromLocations, fix initial animation) ✅
• Add Pin.ShowInfoWindow() and Pin.HideInfoWindow() methods #33985 - Show Info Window Programmatically (Pin.ShowInfoWindow(), Pin.HideInfoWindow()) ✅
• Add MapStyle property for custom JSON map styling (Android) #33991 - Custom Map Styles (Android, [UnsupportedOSPlatform] for other platforms) ✅
• Add MapElement.IsVisible and MapElement.ZIndex properties #33993 - MapElement IsVisible & ZIndex ✅
• Add XAML TypeConverters for Map coordinates (Location, MapSpan, Map.Region) #33995 - XAML TypeConverters (LocationTypeConverter, MapSpanTypeConverter, Map.Region) ✅

Community Requests:

• Provide clustering for map pins #11811 - Pin Clustering ✅
• Add custom pin image/icon functionality for Maps #10400 - Custom Pin Icons ✅
• Provide access to current map zoom level #11332 - Zoom Level Property ✅
• Add MoveToRegion(MapSpan span, bool animated) to IMap interface for non-animated map positioning. #21046 - MoveToRegion Animation ✅
• Provide a way to do a best fit based on a list of map pins #10718 - Best Fit for Pins ✅
• MAP-Control Polyline,Polygon,Circle OnClicked Event #28825 - MapElement Click Events ✅
• Get Userlocation from map control #14700 - User Location Access ✅
• Provide a way to show pin hint window programmatically  #10601 - Show Info Window Programmatically ✅
• Customize map style #10706 - Custom Map Styles ✅
• MAUI Map: Please provide a way to disable zoom buttons but use pinch/expand gestures #17605 - Zoom Buttons vs Gestures

---

Success Metrics

• All Phase 1-6 features shipped in .NET 11 Preview
• Top 3 voted issues resolved (Provide clustering for map pins #11811, Add custom pin image/icon functionality for Maps #10400, Provide access to current map zoom level #11332)
• All community-requested features with existing issues addressed (10/10)
• No new public API breaking changes post-GA