Integration through Sygic Professional Navigation

Introduction

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

On the client side the Sygic Professional Navigation (Android or iOS) is used configured to associate users with your organization.
The Sygic navigation 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 backend system is equipped with Rest API service for standard integration.

On-device integration

On-device integration means a proper configuration of the navigation to associate drivers with your organization.

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 is used for configuration of navigation.

  2. Configure navigation

    Obtained client_id needs to be placed inside settings.ini (alternatively via settings_overload.ini)
    in the section [OnlineSettings] through the parameter m_strDrivingClientID

    Example:

    [OnlineSettings]
    ...
    m_strDrivingClientID=com.myorg.mydriving

    Note
    The files settings.ini/settings_overload.ini can be found in SygicAppRoot/Android folder (in case of Android platform) or SygicAppRoot/Drive (in case of iOS platform).
    When modifying any settings-ini file, please remove the auto generated file settings2.dat present nearby so that you avoid undesired caching effects.

Minimum HW requirements

  • HW sensors: GPS, accelerometer, gyroscope, pedometer

Software requirements

  • Minimum OS version: Android 4.04, iOS 11
  • Sygic Professional Navigation as of version 13.9.9

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.