Comment on page


Localization Keys

There are some localization keys (Cocoa keys) in your Info.plist that are necessary for trip detection:
  • NSLocationAlwaysUsageDescription
  • NSLocationAlwaysAndWhenInUseUsageDescription
  • NSLocationWhenInUseUsageDescription
  • NSMotionUsageDescription
You can see an example of how to implement these keys in our sample app.

Background Modes

To integrate TripDetection or TripDetectionUmbrella into your own app, you must enable the following Background Modes in the Capabilities section of the app's Info.plist file:
  • Location updates
TIP: Learn more about Apple's iOS background modes here.


App side

The client app is responsible for requesting the proper permissions, and adding any required permissions to the manifest file of their app. The SDK uses APIs that require runtime permissions (Locations, Bluetooth). The SDK ensures that these permissions have been granted, and may trigger the permission dialog to present itself to the user when required.

Bluetooth devices

The SDK checks for Bluetooth authorizations before starting the feature. A failure when starting the Bluetooth Trip Detection feature is not reported as a failure to start trip detection.
It is possible for the client app to restrict download to only devices supporting Bluetooth LE by adding the UIRequiredDeviceCapabilities in the application plist. In this case, the Bluetooth Trip Detection feature is always available.