Initialization

To initialize the GIZO SDK in your project, you need to add the following code snippets to the Application.kt file.

val result = Gizo.initialize(
    this,
    GizoOptions.Builder(license = <license>)
        .clientId(<clientId>)
        .clientSecret(<clientSecret>)
        .build()
)

if(result.isSuccessful){
    Gizo.enableDetections()
    Gizo.setToken(<clientId>, <clientSecret>)
}

The table below describes the available options of GIZO SDK.

GIZO Options	Type	Default Value	Description
useGizoScoring	Boolean	true	true if the recorded data are intended to be processed on the GIZO platform.
logToConsole	Boolean	true	Set to true if you want to see the logs in the console.
logToFile	Boolean	true	Set to true if you want to see the logs in the log file.
autoStart	Boolean	true	Set to true to enable automatic trip recording when a new trip is detected.
autoStop	Boolean	true	Set to true to stop recording trips automatically when the trip finishes.
clientId	String	empty	Use the client ID provided by AMI.
clientSecret	String	empty	Use the client secret provided by AMI.
uploadSetting	GizoUploadSetting	-	-
crashSetting	GizoCrashSetting	-	-

Upload Settings

To prevent unexpected costs from excessive mobile data usage, the table below outlines the available configurations for the upload manager in the GIZO SDK:

GIZO Upload Setting	Type	Default Value	Description
isMobileDataEnabled	Boolean	true	Set to true if you want to allow upload through mobile data.
isRomingDataEnabled	Boolean	false	Set to true if you want to allow uploads while roaming on a cellular network.
mobileDataUsageLimit	Number	100.0	The trip data size threshold in MB, above which the data will not be uploaded, even if uploading through mobile data is enabled.
romingDataUsageLimit	Number	100.0	The trip data size threshold in MB, above which data will not be uploaded, even if mobile data uploading while roaming is enabled.

Crash Settings

To enable and configure the functionality of crash detection feature, the following parameters can be adjusted:

GIZO Crash Setting	Type	Default Value	Description
detectCrash	Boolean	false	Set to true if you want to enable crash detection.
logToFile	Boolean	false	Set to true if you want to see the crash-related logs in the crash log file.
mode	Enum	PROD	Set to STILL_TEST when you what to test the functionality of crash detection while being stationary. To perform a crash test at lower speeds (>=15kph), use LOW_SPEED_TEST. Otherwise, set to PROD.

Initialization typically succeeds unless an unforeseen error or exception occurs. If it fails, you can review the returned result to identify the cause.