axiom-core-location-ref

Core Location Reference

Comprehensive API reference for modern Core Location (iOS 17+).

When to Use

• Need API signatures for CLLocationUpdate, CLMonitor, CLServiceSession
• Implementing geofencing or region monitoring
• Configuring background location updates
• Understanding authorization patterns
• Debugging location service issues

Related Skills

• axiom-core-location — Anti-patterns, decision trees, pressure scenarios
• axiom-core-location-diag — Symptom-based troubleshooting
• axiom-energy-ref — Location as battery subsystem (accuracy vs power)

---

Part 1: Modern API Overview (iOS 17+)

Four key classes replace legacy CLLocationManager patterns:

Class	Purpose	iOS
CLLocationUpdate	AsyncSequence for location updates	17+
CLMonitor	Condition-based geofencing/beacons	17+
CLServiceSession	Declarative authorization goals	18+
CLBackgroundActivitySession	Background location support	17+

Migration path: Legacy CLLocationManager still works, but new APIs provide:

• Swift concurrency (async/await)
• Automatic pause/resume
• Simplified authorization
• Better battery efficiency

---

Part 2: CLLocationUpdate API

Basic Usage

import CoreLocation

Task {
    do {
        for try await update in CLLocationUpdate.liveUpdates() {
            if let location = update.location {
                // Process location
            }
            if update.isStationary {
                break // Stop when user stops moving
            }
        }
    } catch {
        // Handle location errors
    }
}

LiveConfiguration Options

CLLocationUpdate.liveUpdates(.default)
CLLocationUpdate.liveUpdates(.automotiveNavigation)
CLLocationUpdate.liveUpdates(.otherNavigation)
CLLocationUpdate.liveUpdates(.fitness)
CLLocationUpdate.liveUpdates(.airborne)

Choose based on use case. If unsure, use .default or omit parameter.

Key Properties

Property	Type	Description
location	CLLocation?	Current location (nil if unavailable)
isStationary	Bool	True when device stopped moving
authorizationDenied	Bool	User denied location access
authorizationDeniedGlobally	Bool	Location services disabled system-wide
authorizationRequestInProgress	Bool	Awaiting user authorization decision
accuracyLimited	Bool	Reduced accuracy (updates every 15-20 min)
locationUnavailable	Bool	Cannot determine location
insufficientlyInUse	Bool	Can't request auth (not in foreground)