Epic: Maps Control Improvements for .NET 11

# 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:
- [x] MapElement Click Events (#28825) → PR #29101
- [x] `MapLongClicked` event → PR #33792
- [x] User Location from Map (#14700) → PR #33799
- [x] `MapElement.IsVisible` → PR #33993
- [x] `MapElement.ZIndex` → PR #33993
- [ ] `Polyline.IsGeodesic`

### Phase 2: Pin Enhancements ✅ COMPLETE
Most requested features:
- [x] Pin Clustering (#11811) → PR #33831
- [x] Custom Pin Icons (#10400) → PR #33950
- [ ] `Pin.Anchor` property

### Phase 3: Camera & Zoom ✅ COMPLETE
- [x] `MoveToRegion(animated)` overload (#21046) → PR #33982
- [x] `MapSpan.FromLocations()` best-fit zoom (#10718) → PR #33982
- [x] Zoom level control via MoveToRegion + VisibleRegion (#11332) → PR #33982
- [x] Fix initial map animation (Maui island fly-in) (#21046) → PR #33982
- [ ] Camera events (`CameraPositionChanged`, `CameraIdle`, `MapLoaded`)

### Phase 4: Info Windows ✅ COMPLETE
- [x] Programmatic info window (#10601) → PR #33985

### Phase 5: Styling ✅ COMPLETE
- [x] Custom Map Styles (#10706) → PR #33991 (Android-only, `[UnsupportedOSPlatform]` for iOS/MacCatalyst/Windows)

### Phase 6: XAML Experience ✅ COMPLETE
- [x] `LocationTypeConverter` ("lat,lon" → Location) → PR #33995
- [x] `MapSpanTypeConverter` ("lat,lon,latDeg,lonDeg" → MapSpan) → PR #33995
- [x] `Map.Region` bindable property → PR #33995

### Phase 7: MapElement Improvements
- [ ] `StrokeDashPattern` for Polyline

### Phase 8: Advanced
- [ ] Separate Zoom Buttons from Gestures (#17605)

---

## Non-Goals (Out of Scope)

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

---

## Related Issues & PRs

**Completed PRs:**
- #29101 - MapElement Click Events (Circle, Polygon, Polyline) ✅
- #33792 - MapLongClicked Event ✅
- #33799 - User Location from Map (`LastUserLocation`, `UserLocationChanged`) ✅
- #33831 - Pin Clustering ✅
- #33950 - Custom Pin Icons ✅
- #33982 - Camera & Zoom (MoveToRegion animation, MapSpan.FromLocations, fix initial animation) ✅
- #33985 - Show Info Window Programmatically (`Pin.ShowInfoWindow()`, `Pin.HideInfoWindow()`) ✅
- #33991 - Custom Map Styles (Android, `[UnsupportedOSPlatform]` for other platforms) ✅
- #33993 - MapElement IsVisible & ZIndex ✅
- #33995 - XAML TypeConverters (LocationTypeConverter, MapSpanTypeConverter, Map.Region) ✅

**Community Requests:**
- #11811 - Pin Clustering ✅
- #10400 - Custom Pin Icons ✅
- #11332 - Zoom Level Property ✅
- #21046 - MoveToRegion Animation ✅
- #10718 - Best Fit for Pins ✅
- #28825 - MapElement Click Events ✅
- #14700 - User Location Access ✅
- #10601 - Show Info Window Programmatically ✅
- #10706 - Custom Map Styles ✅
- #17605 - Zoom Buttons vs Gestures

---

## Success Metrics

- [x] All Phase 1-6 features shipped in .NET 11 Preview
- [x] Top 3 voted issues resolved (#11811, #10400, #11332)
- [x] All community-requested features with existing issues addressed (10/10)
- [ ] No new public API breaking changes post-GA

This is an umbrella epic and names no source files, tests, or single entry point. Review the not-started items and their related issues first, then choose one feature with a defined platform scope; done means that feature is implemented and validated separately from the already completed work and linked pull requests.

Written by the indexing model from the issue text.