Integration with your mobile app using Sygic server storage

Introduction

The integration of the Sygic ADAS subsystem in this scenario as depicted in the picture below.

The 3rd party mobile app integrates Sygic Library as a part of Sygic ADAS SDK package.
The library automatically detects driving events and communicates with the Sygic server-side backend system to store trip data.
The Sygic backend services can be used e.g. to retrieve trip data for all users of the organization by e.g. a customer built web portal.
The on-device integration is supported with libraries for the iOS and Android platforms, while the backend system is equipped with Rest API service for standard integration.

On-device integration

On-device integration means that ADAS library module (Android or iOS) needs to be contained in a mobile application.

Integration steps

  1. Get client_id
    Make sure you have client_id ready (in the form of com.myorg.mydriving).
    You can obtain it from your Sygic sales representative or contact us through Contact form.
    The given client_id will be the input to the initialize method.

  2. Import library into your project

    Android

    adapt the android project's repository and dependencies as follows:
    Project build.gradle

    repositories { maven { url "https://public.repo.sygic.com/repository/maven-sygic-releases/" }}

    App module build.gradle

    dependencies { implementation(“com.sygic.driving:driving-lib:1.2.8@aar") { transitive true    }}

    iOS

    retrieve the library from the following link:
    https://public.repo.sygic.com/#browse/browse:maven-sygic-releases:com%2Fsygic%2Fdriving%2Fdriving-lib

  3. Coding
    You can help yourself with sample apps on github:
    Android: https://github.com/Sygic/driving-example-android.git
    iOS: https://github.com/Sygic/driving-example-ios.git
    Or continue with the sections Android Library or iOS Library to go through the available functions.

Minimum HW requirements

  • Minimum OS version: Android 4.04, iOS 11
  • HW sensors: GPS, accelerometer, gyroscope, pedometer

Release notes

Android

  • Devices without pedometer are not supported
  • More users on the same client can create undesired effect of missing up trips
  • If client app calls WorkManager.initialize, malfunctioning of the library can occur, see the issue: https://stackoverflow.com/a/58345092/3489516

Backend integration

Using Sygic backend services you can retrieve data
to reconstruct trip trajectories, visualize them on map along with the driver behavior events they committed,
retrieve their driver scoring statistics, potentially to create leaderboards, etc.

Integration steps

  1. Get client_id and client_secret
    You can obtain it from your Sygic sales representative or contact us through https://www.sygic.com/enterprise/contact-us
    You will need client_id and client_secret for to retrieve access token for all the available data and control functions.

  2. Coding
    Continue reading with the section Backend API to go through the available functions.