integrations.sh
← all integrations

Quick start - Telematics SDK

OpenAPI apis-guru iot

Introduction

We have prepared a set of APIs for quick start to integrate telematics SDK that powers mobile telematics inside 3rd party mobile applications.

Overview

Datamotion provides telematics infrastructure for mobile applications.

Telematics SDK turns any smartphone into telematics data gathering device to collect Location, driving and behavior data. API services unlocks power of your mobile application

There are 3 groups of methods:

  • 1 - user management
  • 2 - statistics for mobile app
  • 3 - statistics for back-end(s)

in certain cases you will need SNS or any other notification services. read more

Possible architecture

There are three common schemes that are used by our clients. These schemes can be combined

  • Collect, Process, Store (required: 1&2)
  • Collect, Process (required: 1& sns)
  • Collect (required 1&sns)

Collect, Process, Store

Collect, Process, Store

Collect, Process

Collect, Process

Collect

Collect
Telematic sdk

Common use-cases:

  • Safe and efficient driving
  • Usage-based insurance
  • Safe driving assessment
  • Driver assessment
  • Trip log
  • Geo-analysis
  • Accident monitoring
  • Driving engagements
  • Location based services
  • Realtime Tracking and beyond

How to start

  • Register a
  • Get
  • Follow the guide from

Authentication

To create a user on datamotion platform, you require to use InstanceID and InstanceKEY. You can get it in Datahub -> management -> user-service credentials

Once you create a user, you will get Device token, JWT token and refresh token. then, you will use it for APIs

Homepage
https://api.apis.guru/v2/specs/telematicssdk.com/1.0.0.json
Provider
telematicssdk.com
OpenAPI version
3.0.3
Spec (JSON)
https://api.apis.guru/v2/specs/telematicssdk.com/1.0.0/openapi.json
Spec (YAML)
https://api.apis.guru/v2/specs/telematicssdk.com/1.0.0/openapi.yaml

Tools (11)

Extracted live via the executor SDK.

  • 2ForMobileAppOptional.tripsTripDetails

    Trips - trip details

  • 2ForMobileAppOptional.userSafeScoringAccumulatedValueV1ScoringsIndividual

    Safe driving score API. This API is a part of Telematics API that we provide to our clients.

    Rating description presents the universal approach, developed by our company on the basis of many years of experience; most of the input variables presented in this document could be adopted depending on the needs of the company and the focus on the specific characteristics of clients' driving style. Since 2019 we have moved to the 3rd Generation of the scoring model which allows distinguishing a context of events and add penalty points in accordance with a level of risk generated by an event

  • 2ForMobileAppOptional.userSafeScoringDailyValueV1ScoringsIndividualDaily

    User safe scoring - daily value - /v1/Scorings/individual/daily

  • 2ForMobileAppOptional.userStatisticeDailyValueV1StatisticsIndividualDaily

    User statistice - Daily value - v1/Statistics/individual/daily

  • 2ForMobileAppOptional.userStatisticsAccumulatedValueV1StatisticsIndividual

    User statistics - Accumulated value - /v1/Statistics/individual

  • 3ForBackEndOptional.v1ScoringsConsolidated

    /v1/Scorings/consolidated

  • 3ForBackEndOptional.v1ScoringsConsolidatedDaily

    /v1/Scorings/consolidated/daily

  • 3ForBackEndOptional.v1StatisticsConsolidated

    /v1/Statistics/consolidated

  • 3ForBackEndOptional.v1StatisticsConsolidatedDaily

    /v1/Statistics/consolidated/daily

  • openapi.previewSpec

    Preview an OpenAPI document before adding it as a source

  • openapi.addSource

    Add an OpenAPI source and register its operations as tools