Integration through Sygic Professional Navigation

Introduction

The integration of the Sygic Mobile Telematics 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 credentials
    Make sure you have your credentials, which consist of:
    • client_id in the form of com.myorg.mydriving
    • license in the form of eyJ0eXaiOi...
    You can obtain them from your Sygic sales representative or contact us through our Contact form.
    These credentials are used for configuration of navigation.

  2. Configure navigation
    Obtained client_id and license need to be placed inside settings.ini (alternatively via settings_overload.ini)
    in the section [OnlineSettings] through the parameter m_strDrivingClientID and m_strDrivingLicense

    Example:

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

    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

Software requirements

  • Minimum OS version: Android 5, iOS 11
  • Sygic Professional Navigation as of version 22.1.3

Release notes

Android:

  • 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.

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 Contact form.
    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.