Start the integration in less than 5 minutes.
Learn how to integrate the truemetrics Android SDK into your app. The other sections of this document describe in detail how to integrate and use the SDK in your application.
For using the SDK to upload data from the integrating app (e.g. your driver app), an API key is required. The integrating app has to set this api key (called SDK API KEY) in the initialization of the SDK (see also here in the documentation).
If you only want to make some first upload tests, you can use our demo SDK API KEY
MSgcfnGu0p3E2KhFwTP3N5NSrCSXm54U6DI0PW51
To ensure a smooth integration in your app, we prepared a sample integration with a basic demonstrator just for you. You can find this repository here. Just clone the repository locally, by following these instructions in your terminal.
Just run or deploy the application in your favorite IDE.
Integrate the SDK into your app by following these steps:
We have also prepared a React Native demo app to show how to integrate our SDK. You can find it here.
There is a native module called TruemetricsSdkModule
in the android
module of React Native demo app. TruemetricsSdkModule
handles interaction with the SDK.
You can find Expo demo app here.
The second API key (called RESULTS API KEY) is used when you want to receive the results of a delivery from https://api.truemetrics.cloud/V2/results.
If you plan to use all features and to actually receive results, request an API Key by sending us a message. We’ll get back to you as fast as possible.
SDK requires location permissions (including background location) to collect fused location data that helps our algorithms provide efficient results. You can refer to Android developers guidelines to integrate location permissions and user consent. Additionally, SDK requires permission to post notifications in order to show Foreground service notification. Demo app showcases creating notification channels and asking for permission to post notifications.
Android SDK can run on minimum Android 7.0 (API level 24)
Start the integration in less than 5 minutes.
Learn how to integrate the truemetrics Android SDK into your app. The other sections of this document describe in detail how to integrate and use the SDK in your application.
For using the SDK to upload data from the integrating app (e.g. your driver app), an API key is required. The integrating app has to set this api key (called SDK API KEY) in the initialization of the SDK (see also here in the documentation).
If you only want to make some first upload tests, you can use our demo SDK API KEY
MSgcfnGu0p3E2KhFwTP3N5NSrCSXm54U6DI0PW51
To ensure a smooth integration in your app, we prepared a sample integration with a basic demonstrator just for you. You can find this repository here. Just clone the repository locally, by following these instructions in your terminal.
Just run or deploy the application in your favorite IDE.
Integrate the SDK into your app by following these steps:
We have also prepared a React Native demo app to show how to integrate our SDK. You can find it here.
There is a native module called TruemetricsSdkModule
in the android
module of React Native demo app. TruemetricsSdkModule
handles interaction with the SDK.
You can find Expo demo app here.
The second API key (called RESULTS API KEY) is used when you want to receive the results of a delivery from https://api.truemetrics.cloud/V2/results.
If you plan to use all features and to actually receive results, request an API Key by sending us a message. We’ll get back to you as fast as possible.
SDK requires location permissions (including background location) to collect fused location data that helps our algorithms provide efficient results. You can refer to Android developers guidelines to integrate location permissions and user consent. Additionally, SDK requires permission to post notifications in order to show Foreground service notification. Demo app showcases creating notification channels and asking for permission to post notifications.
Android SDK can run on minimum Android 7.0 (API level 24)