Configuration

public struct Configuration

The configuration to set up Navigation SDK for online mode.

Lifecycle


                    
                    
                    init(locationProvider:routeReplanner:apiKey:navigationTileStore:dataStoreMaintenanceEngine:mapMatchingEngine:locationContextProviderEngine:horizonEngine:routeTrackingEngine:routeProjectionEngine:guidanceEngine:arrivalDetectionEngine:routeProgressEngine:routeReplanningEngine:routeReplanningRetryPolicy:routeDeviationReplanningRetryPolicy:betterProposalAcceptanceMode:deviationReplanningMode:vehicleProvider:)

The configuration to set up Navigation SDK for online mode.

Tip

At least one of the following properties must be specified:

apiKey
navigationTileStore

Tip: At least one of the following properties must be specified:

routePlanner
routeReplanner
routeReplanningEngine

Declaration

Swift

public init(
    locationProvider: LocationProvider,
    routeReplanner: TomTomSDKRouteReplanner.RouteReplanner,
    apiKey: String? = nil,
    navigationTileStore: NavigationTileStore? = nil,
    dataStoreMaintenanceEngine: DataStoreMaintenanceEngine? = nil,
    mapMatchingEngine: MapMatchingEngine? = nil,
    locationContextProviderEngine: LocationContextProviderEngine? = nil,
    horizonEngine: HorizonEngine? = nil,
    routeTrackingEngine: RouteTrackingEngine? = nil,
    routeProjectionEngine: RouteProjectionEngine? = nil,
    guidanceEngine: GuidanceEngine = TomTomGuidanceEngine(),
    arrivalDetectionEngine: ArrivalDetectionEngine = TomTomArrivalDetectionEngine(),
    routeProgressEngine: RouteProgressEngine = StandaloneRouteProgressEngine(),
    routeReplanningEngine: RouteReplanningEngine = TomTomRouteReplanningEngine(),
    routeReplanningRetryPolicy: ReplanningRetryPolicy = TomTomReplanningRetryPolicy(),
    routeDeviationReplanningRetryPolicy: ReplanningRetryPolicy = TomTomReplanningRetryPolicy(forDeviation: true),
    betterProposalAcceptanceMode: BetterProposalAcceptanceMode = .default,
    deviationReplanningMode: DeviationReplanningMode = .default,
    vehicleProvider: VehicleProvider = DefaultVehicleProvider()
)

Parameters

`locationProvider`	The default `LocationProvider` during navigation.
`routeReplanner`	Used while instantiating a default `RouteReplanningEngine`.
`apiKey`	API key needed for navigation.
`navigationTileStore`	Online data store to initialize navigation engines.
`dataStoreMaintenanceEngine`	Engine that updates the data store. If not provided, an instance created by `DefaultDataStoreMaintenanceEngineFactory` is used.
`mapMatchingEngine`	The default `MapMatchingEngine` during navigation. If not provided, an instance created by `TileStoreMapMatchingEngineFactory` is used.
`locationContextProviderEngine`	The default `LocationContextProviderEngine` during navigation. If not provided, an instance created by `TileStoreLocationContextProviderEngineFactory` is used.
`horizonEngine`	The default `HorizonEngine` during navigation.
`routeTrackingEngine`	The default `RouteTrackingEngine` during navigation. If not provided, an instance of `DefaultRouteTrackingEngine` is used.
`routeProjectionEngine`	The default `RouteProjectionEngine` during navigation. If not provided, an instance created by `TileStoreRouteProjectionEngineFactory` is used.
`guidanceEngine`	The default `GuidanceEngine` during navigation. If not provided, an instance of `TomTomGuidanceEngine` is used.
`arrivalDetectionEngine`	The default `ArrivalDetectionEngine` during navigation. If not provided, an instance of `TomTomArrivalDetectionEngine` is used.
`routeProgressEngine`	The default [RouteProgressEngine] during navigation. If not provided, an instance of `StandaloneRouteProgressEngine` is used.
`routeReplanningEngine`	The default `RouteReplanningEngine` during navigation. If not provided, an instance of `TomTomRouteReplanningEngine` is used.
`routeReplanningRetryPolicy`	The default `ReplanningRetryPolicy` during navigation. If not provided, an instance of `TomTomReplanningRetryPolicy` is used.
`routeDeviationReplanningRetryPolicy`	The default `ReplanningRetryPolicy` during navigation. If not provided, an instance of `TomTomReplanningRetryPolicy` is used.
`betterProposalAcceptanceMode`	The default `BetterProposalAcceptanceMode` during navigation. If not provided, the mode is set to `BetterProposalAcceptanceMode.Automatic`.
`deviationReplanningMode`	Defines whether `RouteReplanningEngine` should try replanning the active `RoutePlan` after deviation. If not provided, the deviation replanning mode is set to `DeviationReplanningMode.Automatic`.
`vehicleProvider`	The default `VehicleProvider` during navigation. If not provided, an instance of `DefaultVehicleProvider` is used.