Route simulation
Navigation SDK for Android is only available upon request. Contact us to get started.
Navigation functionality depends on knowing the user’s location. Location updates are provided by the LocationProvider
. To obtain user location, you can use the Built-in Location Providers or implement your own.
Location updates along a route can also be simulated for testing purposes. To use the LocationProvider
that provides simulated locations, add the following dependency in the module’s build.gradle.kts
.
implementation("com.tomtom.sdk.location:provider-simulation:1.20.1")
SimulationLocationProvider
The SimulationLocationProvider
simulates location updates using the provided list of locations. It implements the LocationProvider
interface. To define the strategy for generating location updates a SimulationStrategy
has to be provided to the constructor.
val timestampStrategy = TimestampStrategy(locations = locations)val simulationLocationProvider = SimulationLocationProvider.create(timestampStrategy)
SimulationStrategy
SimulationLocationProvider
requires a SimulationStrategy
that determines how location updates should occur.
Two predefined strategies are available: InterpolationStrategy
and TimestampStrategy
. You can also create a custom strategy for providing simulated locations. To do this, implement the SimulationStrategy
interface. The interface contains two methods:
SimulationStrategy.calculateLocation()
- Calculates and returns aSimulationLocation
to broadcast as the location update.SimulationStrategy.hasNext()
- Determines if there are any remaining locations to be sent out.
InterpolationStrategy
InterpolationStrategy
uses interpolation to determine a simulated position.
It should be used if the successive locations are not close enough together. The main use case of this strategy is simulating from a route, because the coordinates are too far away from each other for smooth rendering.
To create an InterpolationStrategy
object, provide a list of GeoLocation
that will be used during simulation. The rest of the parameters are optional. You can specify the delay after the first position is provided and the delay before the provision of each subsequent location. You can also define the speed of the moving object in meters per second.
1val interpolationStrategy =2 InterpolationStrategy(3 locations = locations,4 startDelay = 1.seconds,5 broadcastDelay = 500.milliseconds,6 currentSpeed = metersPerSecond(13.0),7 )
TimestampStrategy
TimestampStrategy
calculates the delay between simulated locations based on the differences between GeoLocation.time
in consecutive locations. This strategy is useful if you are using previously recorded traces, where the consecutive locations are closer to each other than for a route.
Location simulation based on the
TimestampStrategy
only works if the timestamps of theGeoLocation
sequence are valid.
To create this object, provide a list of GeoLocation
objects.
1val timestampStrategy =2 TimestampStrategy(3 locations = locations,4 )
Changing navigation location providers
The LocationProvider
used for navigation is initially specified using the Configuration
object. However, you can retrieve and change the LocationProvider
responsible for location updates at any time. For example, you can switch to simulated locations even if the navigation was started with the user location.
1val timestampStrategy = TimestampStrategy(locations = locations)2val simulationLocationProvider = SimulationLocationProvider.create(timestampStrategy)3tomTomNavigation.locationProvider = simulationLocationProvider
Next steps
Since you have learned how to simulate a route, here are recommendations for the next steps: