TripListener

The TripListener interface provides useful information and event about trips analyzed by DriveKit.

For example, you can be informed when a trip analysis has started, finished, cancelled, when a crash is detected, etc.

Add a TripListener

DriveKitTripAnalysis

func addTripListener(_ tripListener: TripListener)

You can remove a specific listener using the following method:

DriveKitTripAnalysis

func removeTripListener(_ tripListener: TripListener)

To remove all TripListeners objects:

DriveKitTripAnalysis

func removeAllTripListeners()

If you remove all your trip listeners or forget to add one, your app will not received any feedback from the trip analysis module. It will not prevent the analysis from working but your code will not be able to execute its own logic (UI updates, notification, etc.).

Do not forget to remove your TripListener objects when you don't need it anymore.

TripListener interface includes several methods to implement:

Method	Description
tripPoint(tripPoint: TripPoint)	Called when a trip is started and confirmed, for each GPS point recorded by the SDK. Data available in TripPoint object are described here.
tripStarted(startMode: StartMode)	Called each time a trip is started. StartMode indicates which event starts the trip. Possible values are described here.
tripSavedForRepost()	Called if at the end of the trip, the trip can be sent to DriveQuant's server for the analysis. The trip is saved locally on the SDK and will be sent later.
tripFinished(post: PostGeneric, response: PostGenericResponse)	Called when a trip has been recorded by the SDK and sent to DriveQuant's server to be analyzed. PostGeneric object contains raw data sent to DriveQuant's server, PostGenericResponse object contains the trip analysis made on DriveQuant's server. Detailed description of these data are available here.
tripCancelled(cancelTrip: CancelTrip)	Called when a trip is cancelled. CancelTrip indicates which event cancels the trip. Possible values are described here.
beaconDetected()	Called when a beacon sets in the SDK is detected.
significantLocationChangeDetected()	Called when a user significant location change is detected.
sdkStateChanged(state: State)	Called every time the state of the SDK changed with the new state as parameter. States are described here.
crashDetected(crashInfo: DKCrashInfo)	Called when a crash event is detected. Triggered if Crash Detection is enabled. Read more here
crashFeedbackSent(crashInfo: DKCrashInfo, feedbackType: DKCrashFeedbackType, severity: DKCrashFeedbackSeverity)	called when crash feedback is enabled and a confirmed crash is detected. Triggered if Crash Detection is enabled. Read more here

End of trip notification: Depending on the trip analysis service's response in the tripFinished() callback, we recommend that you specify the notification content if you decide to display a user feedback:

• For a vehicle trip, you can display a message such as: Your trip has been analyzed.

• For a trip by rail it is better to display the following message: Your trip was made by train.

Get the trip response status

Once the DriveQuant servers has analyzed a trip, the tripFinished() callback is triggered with the data in the PostGenericResponse object.

It can be useful to check the trip response status in order to check for example if the trip is valid or not with detailed information.

To to this, call the following method:

func getTripResponseStatus(_ tripResponse: PostGenericResponse) -> TripResponseStatus

The TripResponseStatus model is described in the References part.