iOS

Integration

To add the Trip Simulator module to your app, add this dependency in the Podfile:
1
pod 'DriveKitTripSimulator'
Copied!
This component has been designed to facilitate preliminary testing and should never remain in your production app.

Usage

DriveQuant offers the possibility of running simulations from a list of preset trips. After integrating and activating the trip simulation component, you can select a preset trip from those described in the table below. Once the simulation is launched, the Trip Analysis SDK will receive the configured callbacks automatically.
Name
Duration
Distance
Description
shortTrip
8 min
2 km
Trip too short that does not allow to rate the driver's behavior
mixedTrip
15 min
12 km
A 15-minute mixed trip in urban and suburban areas
cityTrip
20 min
8 km
A 20-minute city trip
suburbanTrip
30 min
30 km
A 30-minute trip performed in a suburban environment mostly
highwayTrip
55 min
100 km
A 55-minute highway trip
trainTrip
10 min
5 km
Trip recorded in a train to test the alternative transportation modes detection
boatTrip
40 min
25 km
Trip recorded in a boat to test the alternative transportation modes detection
tripWithCrash
5 min
1 km
A trip dedicated to simulate a crash.

Simulate a trip

To simulate a trip, you just need to send the desired trip to the start method:
1
import DriveKitTripSimulatorModule
2
DriveKitTripSimulator.shared.start(<The_PresetTrip_you_want>)
Copied!

Stop the simulation

To stop the simulation of a trip, it is necessary to call the stop() method:
1
import DriveKitTripSimulatorModule
2
DriveKitTripSimulator.shared.stop()
Copied!

Simulate a crash during a trip

In order to mock a crash to check your integration, you must call the startCrashTrip function with a PresetCrashConfiguration item as parameter. Possible values for PresetCrashConfiguration enumeration are described in the table below:
Name
Description
confirmed30KmH
A short trip with a collision at 30 km/h that occurs 137 seconds after the trip begins and that corresponds to a confirmed accident.
confirmed20KmH
A short trip with a collision at 20 km/h that occurs 141 seconds after the trip begins and that corresponds to a confirmed accident.
confirmed10KmH
A short trip with a collision at 10 km/h that occurs 146 seconds after the trip begins and that corresponds to a confirmed accident.
unconfirmed0KmH
A short trip with a collision during a vehicle stop that occurs 159 seconds after the trip begins and that corresponds to an unconfirmed accident.
1
DriveKitTripSimulator.shared.startCrashTrip(.confirmed20KmH)
Copied!