Companion

Better proposals are automatically applied, meaning that when they are added to the navigation session via the com.tomtom.sdk.navigation.RouteAddedListener with one of following reasons: com.tomtom.sdk.navigation.RouteAddedReason.BetterRouteProposed, com.tomtom.sdk.navigation.RouteAddedReason.AvoidBlockage or com.tomtom.sdk.navigation.RouteAddedReason.WithinRange, the com.tomtom.sdk.navigation.ActiveRouteChangedListener is invoked to announce that the better proposal is automatically selected as active without requiring actions from the integrator.

When the better proposal is found it is added to the navigation session using the com.tomtom.sdk.navigation.RouteAddedListener with one of following reasons: com.tomtom.sdk.navigation.RouteAddedReason.BetterRouteProposed, com.tomtom.sdk.navigation.RouteAddedReason.AvoidBlockage or com.tomtom.sdk.navigation.RouteAddedReason.WithinRange. It's up to the integrator to decide whether the proposed route should be selected as active with com.tomtom.sdk.navigation.TomTomNavigation.selectActiveRoute or ignored.

Proposals, which are triggered because the active route is considered unreachable, are automatically accepted. This means that when they are added to the navigation session via the com.tomtom.sdk.navigation.RouteAddedListener with com.tomtom.sdk.navigation.RouteAddedReason.AvoidBlockage or com.tomtom.sdk.navigation.RouteAddedReason.WithinRange reason, the com.tomtom.sdk.navigation.ActiveRouteChangedListener is invoked to announce that a the better proposal is automatically selected as active without requiring actions from the integrator. A route is considered unreachable if it contains a blockage or, in the case of EV navigation, there is a significant risk of running out of battery charge.