createOnlineFirst

Creates an instance of TomTomNavigation configured to work in online first hybrid mode.

The online first navigation operates under the following principles:

• It attempts to utilize online data and routes for as long as possible, relying on the availability of cached navigation tiles.

• When the cache of navigation tiles runs low, a routing request is made to plan a route using an offline source. Upon success, the new route is applied, and the data source is switched to offline.

• A switch to offline mode also occurs if the planned Estimated Time of Arrival (ETA) and the current ETA differ by more than 30 minutes, indicating that the route is out of date.

• The system then reverts to online mode whenever navigation tiles become available again. This involves planning a new online route and synchronously switching the navigation and route back to online sources.

Effectively, the online first navigation prioritizes online data and routes, switching to offline only when necessary. It also ensures that the navigation and route sources are aligned.

For the online first navigation to function properly, a specific setup of the NavigationTileStore is required:

• The NavigationTileStoreConfiguration.prefetchingConfiguration.prefetchingAreaRadius must be set to at least 5km.

• The NavigationTileStoreConfiguration.prefetchingConfiguration.prefetchedAreaAlongRoute.corridorMinLength must be set to at least 8km.

Note that by default the NavigationTileStore configuration fulfills those requirements.

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

Parameters

Throws