Tangerine detects the driving behaviour of a user by analyasing device sensors using our AI engine.

CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries like Tangerine in your projects. First, add the following line to your Podfile:

pod 'Tangerine'

Second, install Tangerine into your project:

pod install

Configure API key in app's main plist.

TangerineAPIKey = <YOUR-API-KEY>

Import module

import Tangerine

Register user and Configure Tangerine

	if TangerineManager.isUserRegistered {
            TangerineManager.shared.configure()
        } else {
		TangerineManager.registerUser(withPhone:<PHONE NUMBER>completion: { (response, error) in
            		if let error = error {
               			 print("\(error.localizedDescription)")
            		} else {
                		TangerineManager.shared.configure()
            		}
        	})
	}

configure() method will initialize sensor data capturing if the trip is already started. If trip is not started yet, then this method will start listening for auto start/ stop trip based on the flag enableAutoStartAndStop. This flag is true by default. For this feature to work user should grand Always location access for the app.

At this point you should be able to build the code without errors. Running the code will result in an assertionFailure with error Please add 'location' in required background modes.

Enable Location in Backround modes. Target -> Capabilities -> Background Modes -> Location Updates

Add code below code in application(_ application:, didFinishLaunchingWithOptions launchOptions:)

    if let optn = launchOptions, optn[UIApplication.LaunchOptionsKey.location] != nil {
          TangerineManager.shared.configure()
    }

This is required to get the location updates when the system launches the app due to a location update.

Builds and run the code. You are all done.

Set enableAutoStartAndStop to false

TangerineManager.shared.enableAutoStartAndStop = false

Create An object for location LocationAuthoriser

lazy var locationAuthoriser: LocationAuthoriser = {
    return LocationAuthoriser()
}()

Request for location Access

locationAuthoriser.authoriseAppToUseLocation(progress: { (status, error) in
	    print("in progress")
	}) { (status, error) in
		if let error = error {
			print("error: \(error)")
		} else if status == .authorizedWhenInUse || status == .authorizedAlways  {
			// Call start trip
		} else if  status == .denied {
			// Promt user to enable service
			print("Error: Denied location access")
		}
	}

Call startTrip function

TangerineManager.shared.startTrip { [weak self] (response, error) in
    if let error = error, error != TangerineError.tripAlreadyStarted {
		print("error: \(error)")
    } else {
        // Do your configurations
        print("Trip started")
    }
}

The function will call server API to start trip if the current trip state is .tripNotStarted or .tripEnded. ie, will start new trip only if a the previous trip is ended. Method with invoke API for recording Sensor details if the API fails or a trip is aleady in progress.

Call stopTrip function

TangerineManager.shared.stopTrip(completion: { (response, error) in
    if let error = error {
        print("error: \(error)")
    } else {                       	
        print("Success")
    }
})

Method will call server API to end trip. This API may take little longer to complete since it will wait for upload task which syncs all the recorded sensor values to server to finish.

Drive_AI posts following notifications via NSNotificationCenter :

• NotificationName.hardBraking when hard braking is detected
• NotificationName.crashDetected when a vehicle crash is detected. The notification passes a userInfo dictionary holding the crash info. The userInfo can be of following types
  • Accelerometer crash: Crash was detected due to the change in Accelerometer values
    • (x: Double,y: Double, z: Double, dataObj: SensorData): x,y,z values of Acceleration and the value of all the sensors during the crash.
  • GPS crash: Crash was detected due to the change in the speed
    • (speedDifference: Double, dataObj: SensorData) : speed difference and the value of all the sensors during the crash.

  Rather than using the object returned along with Notification user can also get crash details as TangerineManager.shared.activeTripCrashInfo. It will contain the location and time in which crash happened. If you think detected crash is a false positive then mark it as false positive by calling TangerineManager.shared.clearCrashInfo().

• NotificationName.locationAccessPermissionChanged when the location access permision changes
• NotificationName.locationDidUpdated when the location get changed
• NotificationName.didChangeRegion when the monitored region get changed
• NotificationName.locationDidUpdated when the location get changed
• NotificationName.locationManagerDidFail when the location manger fails to get location
• NotificationName.didStartTripNotification when the a trip gets started
• NotificationName.didStopTripNotification when the a trip gets stopped

Drive_AI is distributed under the terms and conditions of the [MIT license](

Tangerine is brought to you by XYZ. If you're using Tangerine in your project, attribution would be very appreciated.