TomTomSDKNavigation

TomTomArrivalDetectionEngine checks if the driver has reached the destination or waypoint.

Engine that instantiates the update of the data store used for navigation.

The DefaultTomTomNavigation object defines the functionality of the navigation.

Provides access to Dynamic Routing

NavigationStartError contains information about any problems that occur during navigation. The detailed meaning of each error is provided via the message variable.

The TomTomNavigation protocol defines the functionality of the navigation.

The mode of navigation after start.

Represents the NavigationEvent published by TomTomNavigation\eventPublisher.

Defines the error cases that can occur while generating guidance steps.

TomTomGuidanceEngine generates Guidance using the list of TomTomSDKRoute.Instructions supplied within NavigationSnapshot.activeRoute.

TomTomGuidanceEngine depends on the TomTomSDKRoute.Announcements included in the supplied TomTomSDKRoute.Instructions. The engine continuously checks the active route progress to provide up-to-date Guidance information. When the vehicle reaches an announcement point, the generated Guidance includes the GuidanceAnnouncement to be announced. Note that the set of supported languages may differ between different GuidanceEngines.

TomTomGuidanceEngine should only be used with the online routing client that uses TomTomSDKRoutePlanner.GuidanceOnlineApiVersion.v1 as the TomTomSDKRoutePlanner.GuidanceOptions.guidanceVersion. This is because the instructions from offline and the online routing client configured with TomTomSDKRoutePlanner.GuidanceOnlineApiVersion.v1 are designed to be used by the DynamicGuidanceEngine and do not contain static announcement information.

Creates a DynamicGuidanceEngine.

DynamicGuidanceEngine generates dynamic Guidance for the TomTomSDKRoute.Instructions supplied within NavigationSnapshot.activeRoute.

To generate dynamic Guidance, DynamicGuidanceEngine takes various parameters into account. These parameters include, but are not limited to:

• Distance to the next maneuver.
• Current speed of the vehicle.
• Free-flow speed of the road between the current position and the next maneuver.
• Traffic situation ahead.

So, unlike TomTomGuidanceEngine, DynamicGuidanceEngine does not depend on TomTomSDKRoute.Announcement information that may or may not be included in the TomTomSDKRoute.Instruction. It continuously checks the active route progress to provide up-to-date Guidance information. Once the vehicle reaches an announcement point, the generated Guidance includes the (GuidanceAnnouncement) to be announced.

Another difference between DynamicGuidanceEngine and TomTomGuidanceEngine is that DynamicGuidanceEngine uses TomTom’s advanced verbal instruction messages to synthesize GuidanceAnnouncements dynamically on the fly. Note that the set of supported languages may differ between different GuidanceEngines.

DynamicGuidanceEngine can be used to provide turn-by-turn navigation with any routing client (offline, online with TomTomSDKRoutePlanner.GuidanceOptions.guidanceVersion v1 or v2).

The type of an individual trigger that appears on the route.

The trigger may be differentiated by its distance to the maneuver point. Although, this type doesn’t provide any distance information, it describes a triggering point by its location on the route. For example:

• follow trigger is in range 30...20 km from the maneuver point.
• faraway trigger is in range 12...10 km from the maneuver point.
• early trigger is in range 5...4 km from the maneuver point.
• main trigger is in range 1.2...1 km from the maneuver point.
• confirmation trigger is in range 50...20 meters from the maneuver point.

  Important

  This is a Public Preview API. It may be changed or removed at any time.

Configurations for triggering guidance.

This outlines the configurations that can be used to trigger guidance for navigation instructions. Guidance instructions include both visual and audio components, which provide accurate and practical assistance to the user.

As the user approaches the maneuver point, there are four distinct ‘Instruction Stages’ at which audio information is communicated:

• Far away
• Early instruction
• Main instruction
• Confirmation

The default configurations for each of these TriggeringPoints is accessed using the GuidanceTriggeringConfig struct, which provides functions for retrieving configurations for each of the default attribute combinations. By using these configurations, developers can ensure that the distance to maneuver displayed in the navigation instruction panel corresponds to the spoken distance in the audio instruction, providing a more seamless and effective user experience.

Holds collection of TriggeringConfigVariants.

Use TriggeringConfig to initialize GuidanceTriggeringConfig with the configuration for guidance announcments. The configuration is an array of TriggeringConfigVariants; it defines all the parameters for all types of roads, regions, instructions types, and at what distances to be triggered. Additionally, the TriggeringConfig instance may validate an input list internally, allowing the developer to identify the problems during initialization.

Defines a variant for which a trigger should be generated. The most vital part of the instance is the triggeringPoints property where TriggerType is the key, and TriggeringPoint is the value associated with that key.

For example, the following variant will be applicable for a trigger where the road is controlled access, for all countries, for comprehensive mode, only for roundabout instructions, and it has one triggering point (follow).

TriggeringConfigVariant(
   roadTypes: [.controlledAccess],
   regions: [.restOfTheWorld],
   announcementModes: [.comprehensive],
   instructionTypes: [.roundabout],
   triggeringPoints: [
       .follow: TriggeringPoint(
           recommendedDistance: TriggeringDistances(
               defaultDistance: Measurement.tt.kilometers(1000.0)
           ),
           messageDuration: 2
       )
   ]
)

Holds one or more triggering distances.

By default, the distance specified in defaultDistance is the triggering distance. In case custom triggering distances are to be used in the US and/or UK, corresponding values can be specified in customDistanceUS and customDistanceUK respectively.

The types of instruction that are defined for different configuration variants.

The navigation system invokes guiding instructions for every maneuver to show the driver along the route. Driving instructions that get triggered have a type which is announced visually and audibly.

Defines a point on the route, where a trigger should be exposed.

Triggering point is associated with TriggerType based on distance to the maneuver. For example, the following trigger must be triggered on the route at least 13 kilometers or at most 10 kilometers to the maneuver point.

 TriggeringPoint(
       recommendedDistance: TriggeringDistances(
           defaultDistance: Measurement.tt.kilometers(10.0)
       ),
       earliestDistance: TriggeringDistances(
           defaultDistance: Measurement.tt.kilometers(13.0)
       ),
       recommendedTime: 370,
       messageDuration: 0,
       isAudible: false
  )

A region for which the triggering config variant is applicable.

If you want to differentiate the triggers based on the country, you should specify the region while declaring config variants.

Defines types of unit system handling.

Provides access to current registered engines and allows updating them.

The NavigationEngines protocol defines all engines that can be used by the TomTomSDKNavigation module.

Errors which may be thrown during navigation creation.

Navigation options define parameters required to start or update a navigation session.

To specify navigation options, first plan a TomTomSDKRoute/Route using TomTomSDKRoutePlanner/RoutePlanner and TomTomSDKRoutePlanner/RoutePlanningOptions, then create a RoutePlan.

For more information on navigation session see: start(), start(navigationOptions:), update(navigationOptions:) and stop().

Informs the caller about announcements and instructions update events.

The method TomTomSDKNavigationEngines.GuidanceEngine.generateGuidance(navigationSnapshot:) generates the guidance with instructions and distance. Based on the guidance result, the methods of the observers are called.

The protocol provides the interface for handling several events like changes in instructions, generation of announcements, and changes in distance to the next instruction.

To observe the guidance changes, first implement this interface to create an observer, for example:

class CustomGuidanceUpdateObserver: GuidanceUpdateObserver {

    func didChangeInstructions(instructions: [GuidanceInstruction]) {
        // Add code here that handles the changes of instructions.
    }

    func didGenerateAnnouncement(announcement: GuidanceAnnouncement, shouldPlay: Bool) {
        // Add code here that handles a new generate announcement.
    }

    func didChangeDistanceToNextInstruction(
        distance: Measurement<UnitLength>,
        instructions: [GuidanceInstruction],
        currentPhase: InstructionPhase
    ) {
        // Add code here that handles a change of distance to new instruction.
    }
}

Then add the observer using addGuidanceUpdateObserver(_:). To stop observation of the guidance changes, remove the observer using removeGuidanceUpdateObserver(_:).

Informs the caller about changes in lane guidance. This interface provides an observer for when lane guidance starts and ends.

The LaneGuidanceUpdateObserver interface provides the methods that are called when lane guidance shall appear and disappear, respectively. These methods facilitate efficient and dynamic update of lane guidance information during a journey.

To observe the lane guidance changes, first implement this interface to create an observer, for example:

class CustomLaneGuidanceObserver: LaneGuidanceUpdateObserver {
    func didStartLaneGuidance(laneGuidance: LaneGuidance) {
        // Add code here that handles the lane guidance starting
    }

    func didEndLaneGuidance(laneGuidance: LaneGuidance) {
        // Add code here that handles the lane guidance ending
    }
}

Then add the observer using addLaneGuidanceUpdateObserver(_:). To stop observation of the lane guidance changes, remove the observer using removeLaneGuidanceUpdateObserver(_:).

An observer that receives navigation active route changed events.

An observer that receives navigation events of arrival at destination.

Destination arrival is detected by the TomTomSDKNavigationEngines/ArrivalDetectionEngine. On arrival detection, navigation continues in turn-by-turn mode until it’s stopped or switched into free-driving mode.

To be notified about the destination arrival event while navigating, first implement the NavigationDestinationArrivalObserver protocol:

class NavigationDestinationArrivalObserverImpl: NavigationDestinationArrivalObserver {
    func didArriveAtDestination(route: TomTomSDKRoute.Route) {
        // Add code here that handles arrival at a destination.
    }
}

Then register this observer using addDestinationArrivalObserver(_:).

To stop receiving the destination arrival event, unregister the observer using removeDestinationArrivalObserver(_:).

An observer that receives navigation error events.

An observer that receives navigation guidance events.

An observer that receives navigation horizon events.

An observer that receives TomTomNavigation.language change events.

To register a NavigationLanguageChangeObserver, use addLanguageChangeObserver(_:). To stop receiving these events, unregister the observer using removeLanguageChangeObserver(_:).

An observer that receives navigation guidance events.

An observer that receives navigation map matching events.

A typealias that contains all navigation event observers except for the NavigationErrorObserver.

An observer that receives navigation progress events.

An observer that receives navigation route added events.

Defines the reasons why a route was added to the NavigationSession.

An observer that receives navigation route events.

An observer that receives navigation route removed events.

Defines the reasons why a route was removed from the NavigationSession.

An observer that receives route tracking state updates.

The information about the route state is represented by TomTomSDKNavigationEngines/RouteTrackingState. When the driver deviates or returns to the active route, the navigation engine sends route-tracking state updates to the observer.

To be notified about the route state update while navigating, first implement the NavigationRouteTrackingStateUpdateObserver protocol:

class NavigationRouteTrackingStateUpdateObserverImpl: NavigationRouteTrackingStateUpdateObserver {
    func didUpdateRouteTrackingState(routeTrackingState: RouteTrackingState) {
        // Add code here that handles the route state update.
    }
}

To start receiving route tracking state updates, become an observer using TomTomSDKNavigation/TomTomNavigation/addRouteTrackingStateUpdateObserver(_:): To stop receiving route tracking state updates, remove the previously added observer using TomTomSDKNavigation/TomTomNavigation/removeRouteTrackingStateUpdateObserver(_:):

An observer that receives navigation route updated events.

Defines the reasons why a route was updated during the NavigationSession.

An observer that receives navigation start events.

An observer that receives navigation events related with visiting waypoints.

The waypoint arrival state changes are detected by the TomTomSDKNavigationEngines/ArrivalDetectionEngine. Different observer methods are called depending on what state has been detected by the TomTomSDKNavigationEngines/ArrivalDetectionEngine:

• didArriveAtWaypoint(waypoint:on:) is received when the TomTomSDKNavigationEngines/ArrivalDetectionEngine detects an arrival at a waypoint.
• didDepartFromWaypoint(waypoint:on:) is received when the TomTomSDKNavigationEngines/ArrivalDetectionEngine detects a departure from a waypoint.

To be notified about the waypoint arrival events while navigating, first implement the NavigationWaypointArrivalObserver protocol:

class NavigationWaypointArrivalObserverImpl: NavigationWaypointArrivalObserver {
    func didArriveAtWaypoint(waypoint: RouteStop, on route: Route) {
        // Add code here that handles an arrival at a waypoint.
    }

    func didDepartFromWaypoint(waypoint: RouteStop, on route: Route) {
        // Add code here that handles a departure from a waypoint.
    }
}

Then register this observer using addWaypointArrivalObserver(_:).

To stop receiving these events, unregister the observer using removeWaypointArrivalObserver(_:).

SegmentsFilterError defines the errors that can occur while fetching the route progress.

Specifies how to handle requests which failed during replanning of a Route.

Responsible for creating default implementation of a ReplanningRetryPolicy.

The options used for TomTomRouteReplanningEngine configuration

RouteReplanningEngine implementation responsible for route replanning.