MapKit Patterns

MapKit patterns and anti-patterns for iOS apps. Prevents common mistakes: using MKMapView when SwiftUI Map suffices, annotations in view bodies, setRegion loops, and performance issues with large annotation counts.

When to Use

• Adding a map to your iOS app
• Displaying annotations, markers, or custom pins
• Implementing search (address, POI, autocomplete)
• Adding directions/routing to a map
• Debugging map display issues (annotations not showing, region jumping)
• Optimizing map performance with many annotations
• Deciding between SwiftUI Map and MKMapView

Related Skills

• axiom-mapkit-ref — Complete API reference
• axiom-mapkit-diag — Symptom-based troubleshooting
• axiom-core-location — Location authorization and monitoring