// the find
mapbox/mapbox-directions-swift
Traffic-aware directions and map matching in Swift on iOS, macOS, tvOS, watchOS, and Linux
Swift client library for Mapbox's Directions, Map Matching, Isochrone, and Matrix APIs. Wraps the REST endpoints in a type-safe model layer that mirrors MKDirections conventions. Targets iOS/macOS/tvOS/watchOS/Linux; requires a Mapbox account and API token.
The model layer is thorough — RouteStep, VisualInstructionBanner, SpokenInstruction, Intersection, and Lane are all first-class types rather than raw JSON blobs, which means you get something useful without parsing yourself. Linux support via SPM is genuine (not just a checkbox), which matters if you're building a server-side routing pipeline. Test suite uses recorded JSON fixtures rather than live API calls, so tests are deterministic and fast. The route refresh endpoint is supported separately from full recalculation, which is how you keep traffic data fresh without burning API quota.
This is a thin API client, not a routing engine — all computation happens on Mapbox servers, so you're paying per request and have zero offline capability without a separate tile pack mechanism. CocoaPods support is being dropped in December 2026, which is annoying if you're in a large Obj-C/mixed repo that can't easily migrate. The repo has 202 stars for a library that's been around years, suggesting most users are going through the higher-level Navigation SDK instead; the directions library alone doesn't get much standalone attention. Carthage is listed as a supported package manager in 2026, which is a yellow flag for long-term maintenance posture.