v0.27.0

Changes since v0.26.0:

• The NavigationDirections.unpackTilePack(at:outputDirectoryURL:progressHandler:completionHandler:) method is now available to Objective-C code as -[MBNavigationDirections unpackTilePackAtURL:outputDirectoryURL:progressHandler:completionHandler:]. (#1891)
• Added support for styles powered by version 8 of the Mapbox Streets source. (#1909)
• Fixed potential inaccuracies in location snapping, off-route detection, and the current road name label. (mapbox/turf-swift#74)

Documentation is available online or within Xcode.

v0.26.0

Changes since v0.25.0:

Client-side routing

• Added a NavigationDirections class that manages offline tile packs and client-side route calculation. (#1808)
• Extended Bundle with Bundle.suggestedTileURL and other properties to facilitate offline downloads. (#1808)

CarPlay

• When selecting a search result in CarPlay, the resulting routes lead to the search result’s routable location when available. Routes to a routable location are more likely to be passable. (#1859)
• Fixed an issue where the CarPlay navigation map’s vanishing point and user puck initially remained centered on screen, instead of accounting for the maneuver panel, until the navigation bar was shown. (#1856)
• Fixed an issue where route shields and exit numbers appeared blurry in the maneuver panel on CarPlay devices and failed to appear in the CarPlay simulator. (#1868)
• Added VisualInstruction.containsLaneIndications, VisualInstruction.maneuverImageSet(side:), VisualInstruction.shouldFlipImage(side:), and VisualInstruction.carPlayManeuverLabelAttributedText(bounds:shieldHeight:window:). (#1860)
• RouteLegProgress.upComingStep has been renamed to upcomingStep. (#1860)

Other changes

• The NavigationSettings.shared property is now accessible in Objective-C code as MBNavigationSettings.sharedSettings. (#1882)
• Fixed spurious rerouting on multi-leg routes. (#1884)
• Fixed a hang that occurred when failing to fetch a route shield image for display in a visual instruction banner. (#1888)
• Adding property RouteController.nearbyCoordinates, which offers similar behavior to RouteLegProgress.nearbyCoordinates, which the addition of step lookahead/lookbehind in multi-leg routes. (#1883)
• The MGLShapeSourceOptions.lineDistanceMetrics property has been temporarily disabled from the route line shape source due to a crash. This means it isn’t possible to set the MGLLineStyleLayer.lineGradient property on the route line style layers. (#1886)

Documentation is available online or within Xcode.

v0.26.0-beta.1

Changes since v0.25.0:

CarPlay

• When selecting a search result in CarPlay, the resulting routes lead to the search result’s routable location when available. Routes to a routable location are more likely to be passable. (#1859)
• Fixed an issue where the CarPlay navigation map’s vanishing point and user puck initially remained centered on screen, instead of accounting for the maneuver panel, until the navigation bar was shown. (#1856)
• Fixed an issue where route shields and exit numbers appeared blurry in the maneuver panel on CarPlay devices and failed to appear in the CarPlay simulator. (#1868)
• Added VisualInstruction.containsLaneIndications, VisualInstruction.maneuverImageSet(side:), VisualInstruction.shouldFlipImage(side:), and VisualInstruction.carPlayManeuverLabelAttributedText(bounds:shieldHeight:window:). (#1860)

Other changes

• This release includes a possible fix for spurious rerouting when passing an intermediate waypoint. (#1869)

To install this prerelease via CocoaPods, point your Podfile to:

pod 'MapboxCoreNavigation', :podspec => 'https://raw.githubusercontent.com/mapbox/mapbox-navigation-ios/v0.26.0-beta.1/MapboxCoreNavigation.podspec'
pod 'MapboxNavigation', :podspec => 'https://raw.githubusercontent.com/mapbox/mapbox-navigation-ios/v0.26.0-beta.1/MapboxNavigation.podspec'

Documentation is available online or within Xcode.

v0.25.0

Changes since v0.24.0:

CarPlay

• Renamed CarPlayManager.calculateRouteAndStart(from:to:completionHandler:) to CarPlayManager.previewRoutes(between:completionHandler:) and added a CarplayManager.previewRoutes(to:completionHandler), as well as a CarPlayManager.previewRoutes(for:completionHandler:) method that accepts an arbitrary NavigationRouteOptions object. (#1841)
• Fixed an issue causing UserCourseView to lag behind NavigationMapView whenever the map’s camera or content insets change significantly or when the map rotates. (#1838)
• Renamed CarPlayManager(_:) to CarPlayManager(styles:directions:eventsManager:) and CarPlayNavigationViewController(with:mapTemplate:interfaceController:manager:styles:) to CarPlayNavigationViewController(navigationService:mapTemplate:interfaceController:manager:styles:). These initializers now accept an array of Style objects to apply throughout the CarPlay interface, similar to NavigationViewController. You can also change the styles at any time by setting the CarPlayManager.styles property. (#1836)
• CarPlayManager(styles:directions:eventsManager:) also allows you to pass in a custom Directions object to use when calculating routes. (#1834)
• Removed the StyleManager(_:) initializer. After initializing a StyleManager object, set the StyleManager.delegate property to ensure that the style manager’s settings take effect. (#1836)
• Added CarPlayManager.mapView and CarPlayNavigationViewController.mapView properties. (#1852)
• Some additional members of CarPlayManager are now accessible in Objective-C code. (#1836)
• Fixed an issue where distances are incorrectly displayed as “0 m” in regions that use the metric system. (#1854)
• Fixed an issue where the user puck pointed away from the route line during turn-by-turn navigation in CarPlay. The map’s vanishing point now accounts for safe area insets, including the side maneuver view. (#1845)
• Fixed an issue where the map view used for browsing and previewing failed to call MGLMapViewDelegate.mapView(_:viewFor:) and MGLMapViewDelegate.mapViewWillStartLocatingUser(_:). (#1852)
• You can now create a UserPuckCourseView using the UserPuckCourseView(frame:) initializer. (#1852)

Other changes

• Fixed a crash during turn-by-turn navigation. (#1820)
• Fixed a crash that could happen while simulating a route. (#1820)
• Fixed an issue causing MapboxVoiceController to speak instructions using VoiceOver instead of the Mapbox Voice API. (#1830)
• Added NavigationViewController.navigationService(_:willArriveAt:after:distance:) to assist with preparations for arrival. (#1847)

Documentation is available online or within Xcode.

v0.24.0

Changes since v0.23.0:

• It is now safe to set the NavigationMapView.delegate property of the NavigationMapView in NavigationViewController.mapView. Implement MGLMapViewDelegate in your own class to customize annotations and other details. (#1601)
• Fixed an issue where the map view while navigating in CarPlay showed labels in the style’s original language instead of the local language. (#1601)
• NavigationMapViewDelegate.navigationMapView(_:routeStyleLayerWithIdentifier:source:), NavigationMapViewDelegate.navigationMapView(_:routeCasingStyleLayerWithIdentifier:source:), NavigationViewControllerDelegate.navigationViewController(_:routeStyleLayerWithIdentifier:source:), and NavigationViewControllerDelegate.navigationViewController(_:routeCasingStyleLayerWithIdentifier:source:) can now set the MGLLineStyleLayer.lineGradient property. (#1799)
• Reduced the NavigationMapView.minimumFramesPerSecond property’s default value from 30 frames per second to 20 frames per second for improved performance on battery power. (#1818)

Documentation is available online or within Xcode.

v0.23.0

Changes since v0.22.3:

• CarPlayManager is no longer a singleton; your application delegate is responsible for creating and owning an instance of this class. This fixes a crash in applications that specify the access token programmatically instead of in the Info.plist file. (#1792)
• NavigationService.start() now sets the first coordinate on a route, if a fixed location isn't available the first few seconds of a navigation session. (#1790)

Documentation is available online or within Xcode.

v0.19.3

Changes since v0.19.2:

• Fixes an issue which caused 0.19.2 to incorrectly install incompatible dependencies upon pod update.

Documentation is available online or within Xcode.

v0.22.3

Changes since v0.22.2:

• Fixed over-retain issue that resulted in the MapboxNavigationService persisting beyond its expected lifecycle. This could cause unexpected behavior with components that observe progress noitifications.
• Fixed warnings caused by internal usage of deprecated types.

Documentation is available online or within Xcode.

v0.22.2

Changes since v0.22.1:

User interface

• Fixed an issue where the U-turn icon in the turn banner pointed in the wrong direction. (#1647)
• Fixed an issue where the user puck was positioned too close to the bottom of the map view, underlapping the current road name label. (#1766)
• Added InstructionsBannerView.showStepIndicator to enable showing/hiding the drag indicator (#1772)

Telemetry

• Renamed EventsManager to NavigationEventsManager. (#1767)
• Added support in NavigationEventsManager that allows for routeless events. (#1767)

Documentation is available online or within Xcode.

v0.22.1

Changes since v0.22.0:

User Location

• Added ability to adjust poorGPSPatience of a NavigationService. #1763
• Increased default Poor-GPS patience of MapboxNavigationService to 2.5 seconds. #1763
• Fixed an issue where the map view while navigating in CarPlay displayed the day style even at night. (#1762)

Documentation is available online or within Xcode.