axiom-mapkit-ref

MapKit API Reference

Complete MapKit API reference for iOS development. Covers both SwiftUI Map (iOS 17+) and MKMapView (UIKit).

Related Skills

• axiom-mapkit — Decision trees, anti-patterns, pressure scenarios
• axiom-mapkit-diag — Symptom-based troubleshooting

---

Part 1: Modern API Overview

Feature	SwiftUI Map (iOS 17+)	MKMapView
Declaration	Map(position:) { content }	MKMapView()
Camera control	MapCameraPosition binding	setRegion(_:animated:)
Annotations	Marker, Annotation in content	addAnnotation(_:) + delegate
Overlays	MapCircle, MapPolyline, MapPolygon	addOverlay(_:) + renderer delegate
User location	UserAnnotation()	showsUserLocation = true
Selection	.mapSelection($selection)	delegate didSelect
Controls	.mapControls { }	showsCompass, showsScale
Interaction modes	.mapInteractionModes([])	delegate methods
Clustering	Built-in via .mapItemClusteringIdentifier	MKClusterAnnotation

---

Part 2: SwiftUI Map API

Basic Map

@State private var cameraPosition: MapCameraPosition = .automatic

Map(position: $cameraPosition) {
    Marker("Home", coordinate: homeCoord)
    Annotation("Custom", coordinate: coord) {
        Image(systemName: "star.fill")
            .foregroundStyle(.yellow)
            .padding(4)
            .background(.blue, in: Circle())
    }
    UserAnnotation()
    MapCircle(center: coord, radius: 500)
        .foregroundStyle(.blue.opacity(0.3))
    MapPolyline(coordinates: routeCoords)
        .stroke(.blue, lineWidth: 3)
}
.mapStyle(.standard(elevation: .realistic))
.mapControls {
    MapUserLocationButton()
    MapCompass()
    MapScaleView()
}

MapCameraPosition

Controls where the camera is positioned:

// System manages camera to show all content
.automatic

// Specific region
.region(MKCoordinateRegion(
    center: CLLocationCoordinate2D(latitude: 37.7749, longitude: -122.4194),
    span: MKCoordinateSpan(latitudeDelta: 0.05, longitudeDelta: 0.05)
))

// Specific camera with pitch and heading
.camera(MapCamera(
    centerCoordinate: coordinate,
    distance: 1000,    // meters from center
    heading: 90,       // degrees from north
    pitch: 60          // degrees from vertical (0 = top-down)
))

// Follow user location
.userLocation(followsHeading: true, fallback: .automatic)

// Show specific item
.item(mapItem)

// Show specific rect
.rect(MKMapRect(...))