NavigationTileStore

NavigationTileStore Implementation of a DataStore which is based on an online map. It requires a position around which the cloud data will be fetched.

NavigationTileStore provides navigation map tiles fetched from an online map service. It maintains a persistent cache of the downloaded tiles to enhance performance, reduce bandwidth usage, and ensure continued navigation functionality. With cached tiles, clients can continue using navigation based on prefetched data as long as relevant tiles are available in the cache, even during periods of limited connectivity.

The persistent cache allows for quick access to frequently used tiles, ensuring that the application can efficiently navigate without repeatedly fetching the same data from the online service. This caching mechanism is particularly beneficial in scenarios where network connectivity is limited or when immediate access to map data is required.

The cache is stored in the application's cache directory, allowing the operating system to manage its persistence. The cache can be cleared under specific circumstances, which may affect the availability of previously downloaded tiles. One key reason for flushing the cache is when the service URL is changed, as the existing cache may be invalidated to prevent inconsistencies with newly fetched data.

Note: The flushing conditions may evolve with future updates to the SDK, and this documentation may be updated to reflect those changes. Users should refer to the SDK release notes for the latest information regarding caching behavior.

IMPORTANT: Only one NavigationTileStore existing at any given time is supported. Instantiating multiple objects at the same time could yield unexpected results (including instability and increased bandwidth usage). There is no substantial practical advantage in creating multiple instances of this object. A single instance can be created and its reference can be shared across all necessary components.

Parameters

context

Android context.

config

Parameters needed to configure NavigationTileStore.

Types

Link copied to clipboard
object Companion

Functions

Link copied to clipboard
open override fun close()
Link copied to clipboard
open override fun updateActiveRoute(polyline: List<GeoPoint>)

Sets the active route around which cloud data will be fetched. If the route is longer than 35km, only the first 35km of the route will be used.

Link copied to clipboard
open override fun updatePosition(position: GeoPoint)

Sets current position around which cloud data will be fetched.