Digital Cockpit is only available upon request.

Advanced SDK Features

Last edit: 2023.02.23

Install a map

TomTom Digital Cockpit uses an onboard map for its navigation features. You must install this map yourself on the target device or emulator.

Download the map

We offer the following map(s) for evaluation. Use your credentials to download:

Michigan, USA.

Download the keystore file

Download and extract the keystore file using your credentials.

Install the map

In these instructions the target application is the IVI Template App, with the package name com.example.ivi.template.app. Adjust this to your application name if necessary.

Make sure your target device is running. Push the keystore file to the target device:

1adb root
2adb shell mkdir /data/media/10/Android/data/com.example.ivi.template.app/files/keystore
3adb push NK_AUTO_DEV.NKS /data/media/10/Android/data/com.example.ivi.template.app/files/keystore

Extract the map data. Push the map data to the target device:

adb push my-directory-with-map-data /data/media/10/Android/data/com.example.ivi.template.app/files/map/

Restart the IVI application:

Swipe up from the bottom of the device's screen.
Click on the All apps menu icon (grid of nine squares).
Swipe up and select Settings.
Swipe up and select Apps & notifications.
Select Show all apps.
Swipe up and select IVI Template App.
Select Force stop on the top right of the screen, then click OK.
Click on the All apps menu icon (grid of nine squares).
Swipe up and restart the IVI Template App.

If the map and keystore file were successfully installed, you will see a blue arrow appear.

For advanced navigation functionality you will need to configure an API key in the SDK build files.

Register as a TomTom developer

Navigate to developer.tomtom.com, click Register, and fill out the registration form.
You will receive a confirmation email; click Activate Account and go to your TomTom developer dashboard.
The API key assigned to you should be used in the Digital Cockpit SDK, but it must still be authorized by TomTom.

You will not get a new API key. TomTom will add additional permissions to your existing API key.

Configure your API key

Now that you have your fully-authorized API key, it can be used with the SDK. Add it to the gradle.properties file that you created earlier.

Linux and Mac

Navigate to your system's Gradle directory:

cd ~/.gradle

Add your credentials to the gradle.properties file and save your changes:

1nexusUsername=<your-username>
2nexusPassword=<your-password>
3automotiveUiApiKey=<your-tomtom-api-key>

Windows