Enable Navigation Features

The TomTom Digital Cockpit SDK is not available for general use.
Please contact us for more information.

Navigation Features

Long-Distance Electrical Vehicle Routing (LDEVR)

TomTom’s Long-Distance Electrical Vehicle Routing (LDEVR) allows customers to drive routes over long distances and without running out of power. Routes will include EV charging stations at locations where the vehicle is expected to be low on battery. Read more about how to provide the data needed for the LDEVR algorithm on this page.

In addition to providing data from the vehicle, the following needs to be in place for LDEVR to work:

• The user needs to give consent to share their private data, see the section on User Consent. Note that both ConsentType.CONNECTED_SERVICES and ConsentType.LOCATION need to be included.
• Trusted CA and root certificates need to be in place on the device, see add certificates.
• An API key containg the entitlements for the relevant online services needs to included in the product, see configure the API key.

Map management

Map management allows the user to manage map content on the device, update, add or remove maps and map regions.

For this to work:

• A base map needs to be installed on the device, see Install a Map for how to install an evaluation map.
• The user needs to give consent to share their private data, see the section on User Consent. Note only ConsentType.CONNECTED_SERVICES needs to be included.

Add certificates

Root certificates that are needed can be found in the source of the SDK examples:

• resources/certificates/cacert.pem
• resources/certificates/nkw.crt

They need to be placed in the data folder of the user profile running the applications, in this example user 10:

adb push cacert.pem /data/user/10/com.example.ivi.template.app/files/config/OnlineServices/
adb push nkw.crt /data/user/10/com.example.ivi.template.app/files/config/OnlineServices/

Configure the API key

For online search and routing to work, an API key must be included in the product. You should have received an API key as part of the registration process. Otherwise contact your TomTom sales representative.

Configure the key in the gradle.properties file in your Gradle user home directory (for Linux and Mac ~/.gradle/ and for Windows %USERPROFILE%\.gradle\):

automotiveUiApiKey=<your-API-key>

For completeness enable the API key build time check, by commenting out the following line in the project gradle.properties file:

# disableAutomotiveUiApiKeyBuildTimeCheck=true