Get started

Prerequisite

Before starting DriveKit Timeline UI integration, make sure that you have initialized Driver Data and Common UI modules.

Integration

To add Timeline UI module to your app, add the following line to your dependencies in your application build.gradle file:

dependencies {
    implementation 'com.drivequant.drivekit:drivekit-timeline-ui:$drivekitui_version'
}

Replace $drivekitui_version with the DriveKit version you are using in your app

On this Github repository, you can also find a demo application that contains the DriveKit Timeline component. This code is open source and you can use it as an example.

Initialization

If you have disabled the SDK auto-initialization, the Timeline UI module must also be manually initialized.

Then, to initialize the module in your app, you must call the initialization method in onCreate method of your Application class:

DriveKitDriverDataTimelineUI

fun initialize()

Configure main screen scores

You can select which scores you want to display on the main screen as well as the scores ordering, by calling the following method:

Kotlin

DriveKitUI.scores = listOf(
   DKScoreType.SAFETY,
   DKScoreType.ECO_DRIVING,
   DKScoreType.DISTRACTION,
   DKScoreType.SPEEDING
)

Java

DriveKitUI.INSTANCE.setScores(Arrays.asList(
       DKScoreType.SAFETY,
       DKScoreType.ECO_DRIVING,
       DKScoreType.DISTRACTION,
       DKScoreType.SPEEDING)
);

Default and accepted values:

[ SAFETY, ECO_DRIVING, DISTRACTION, SPEEDING ]

For DISTRACTION and SPEEDING scores, make sure that the services are activated on your DriveQuant account or the SDK will filter them out and they will not be displayed in the UI even if you add them here.