Install in Dash
Router Protocol Reference
Router
public protocol Router : CLLocationManagerDelegateA class conforming to the Router protocol tracks the user’s progress as they travel along a predetermined route. It calls methods on its delegate, which conforms to the RouterDelegate protocol, whenever significant events or decision points occur along the route. Despite its name, this protocol does not define the interface of a routing engine.
There are two concrete implementations of the Router protocol. RouteController, the default implementation, is capable of client-side routing and depends on the Mapbox Navigation Native framework. LegacyRouteController is an alternative implementation that does not have this dependency but must be used in conjunction with the Mapbox Directions API over a network connection.
-
The route controller’s associated location manager.
Declaration
Swift
var dataSource: RouterDataSource { get } -
The route controller’s delegate.
Declaration
Swift
var delegate: RouterDelegate? { get set } -
Intializes a new
RouteController.Declaration
Swift
init(alongRouteAtIndex routeIndex: Int, in routeResponse: RouteResponse, options: RouteOptions, directions: Directions, dataSource source: RouterDataSource)Parameters
routeIndexThe index of the route within the original
RouteResponseobject.routeResponseRouteResponseobject, containing selection of routes to follow.directionsThe Directions object that created
route.sourceThe data source for the RouteController.
-
Details about the user’s progress along the current route, leg, and step.
Declaration
Swift
var routeProgress: RouteProgress { get } -
The route along which the user is expected to travel.
You can update the route using
Router.updateRoute(with:routeOptions:completion:).Declaration
Swift
var route: Route { get } -
The
RouteResponsecontaining the route along which the user is expected to travel, plus its index in thisRouteResponse, if applicable.If you want to update the route use
Router.updateRoute(with:routeOptions:completion:)method.Declaration
Swift
var indexedRouteResponse: IndexedRouteResponse { get } -
Given a users current location, returns a Boolean whether they are currently on the route.
If the user is not on the route, they should be rerouted.
Declaration
Swift
func userIsOnRoute(_ location: CLLocation) -> Bool -
The idealized user location. Snapped to the route line, if applicable, otherwise raw or nil.
Declaration
Swift
var location: CLLocation? { get } -
The most recently received user location.
Note
This is a raw location received fromlocationManager. To obtain an idealized location, use thelocationproperty.Declaration
Swift
var rawLocation: CLLocation? { get } -
If true, the
RouteControllerattempts to calculate a more optimal route for the user on an interval defined byRouteControllerProactiveReroutingInterval. IfrefreshesRouteis enabled too, reroute attempt will be fired after route refreshing.Declaration
Swift
var reroutesProactively: Bool { get set } -
If true, the
RouteControllerattempts to update ETA and route congestion on an interval defined byRouteControllerProactiveReroutingInterval.Refreshing will be used only if route’s mode of transportation profile is set to
.automobileAvoidingTraffic. IfreroutesProactivelyis enabled too, rerouting will be checked after route is refreshed.Declaration
Swift
var refreshesRoute: Bool { get set } -
Advances the leg index.
This is a convienence method provided to advance the leg index of any given router without having to worry about the internal data structure of the router.
Declaration
Swift
func advanceLegIndex(completionHandler: AdvanceLegCompletionHandler?) -
Asynchronously replaces currently active route with the provided
IndexedRouteResponse.You can use this method to perform manual reroutes.
delegatewill be notified about route change viaRouterDelegate.router(router:willRerouteFrom:)andRouterDelegate.router(_:didRerouteAlong:at:proactive:)methods.Declaration
Swift
func updateRoute(with indexedRouteResponse: IndexedRouteResponse, routeOptions: RouteOptions?, completion: ((Bool) -> Void)?)Parameters
indexedRouteResponseA
MapboxDirections.RouteResponseobject with a new route along with its index in routes array.routeOptionsRoute options used to create the route. You can pass nil to reuse the
RouteOptionsfrom the currently active route. If the newindexedRouteis for a different set of waypoints,routeOptionsare required.completionA completion that will be called when when a new route is applied with a boolean indicating whether the change was successful. Until completion is called
routeProgresswill represent the old route.
View Source on GitHub