MapKit

Build map-based and location-aware features targeting iOS 17+ with SwiftUI MapKit and modern CoreLocation async APIs. Use Map with MapContentBuilder for views, CLLocationUpdate.liveUpdates() for streaming location, and CLMonitor for geofencing.

Read references/mapkit-patterns.md when you need full map setup, search, routes, Look Around, snapshots, or iOS 26 place APIs. Read references/mapkit-corelocation-patterns.md when the task involves location update lifecycle, geofencing, background location, testing, or privacy keys.

Contents

• Workflow
• SwiftUI Map View (iOS 17+)
• CoreLocation Modern API
• Geocoding
• Search
• Directions
• PlaceDescriptor (iOS 26+)
• Common Mistakes
• Review Checklist
• References

Workflow

1. Add a map with markers or annotations

1. Import MapKit.
2. Create a Map view with optional MapCameraPosition binding.
3. Add Marker, Annotation, MapPolyline, MapPolygon, or MapCircle inside the MapContentBuilder closure.
4. Configure map style with .mapStyle().
5. Add map controls with .mapControls { }.
6. Handle selection with a selection: binding.

2. Track user location

1. Add NSLocationWhenInUseUsageDescription to Info.plist.
2. On iOS 18+, create a CLServiceSession to manage authorization.
3. Iterate CLLocationUpdate.liveUpdates() in a Task.
4. Filter updates by distance or accuracy before updating the UI.
5. Stop the task when location tracking is no longer needed.

3. Search for places