Synthesis
The driver synthesis service provides a driver's scores and driving statistics. The data are obtained by averaging scores and aggregating trip data over the driver's entire activity, the current month, and the current week.
The driver synthesis is updated each time a new trip is analyzed.
If you have your admin API key, you can try the API via this link.
get
https://service.drivequant.com
/v3/drivekit/admin/drivers/{user_id}/synthesis
Synthesis of driver's scores

Response

The table below summarizes the list of synthesis data.
Field
Type
Description
userInfo
object
User information
smartphoneData
object
Information about the user's smartphone
customerData
object
Specific customer-related data
scoresTimeRange
object
Average driving scores per period
scoresRoadContext
object
Driving statistics and average scores per road context

userInfo

Field
Type
Description
userId
string
User unique identifier
firstname
string
User first name
lastname
string
User last name
companyName
string
Company name
registerDate
string
User registration date
firstTrip
string
Date of the first trip
lastTrip
string
Date of the last trip
lastUpdate
date
Date of the last synthesis data update

smartphoneData

Field
Type
Description
phoneModel
string
Device model name
appBuildNumber
string
Application build number
osVersion
string
Version of the operating system
osType
string
Platform: iOS or Android
sdkVersion
string
Version of the DriveKit SDK
phoneLanguage
string
Phone language
rawPhoneLanguage
string
Raw phone language

scoresTimeRange

For each theme (efficiency, safety, phoneDistraction, speeding, distance, acceleration, braking, adherence, fuelVolume, co2Mass):
Field
Type
Description
overall
number
Average score based on all trips
currentWeek
number
Average score based on trips performed during the current week
currentMonth
number
Average score based on trips performed during the current month

scoresRoadContext

Field
Type
Description
roadContext
string
Road context (see below)
distance
number
Total driving distance (in km)
duration
number
Total driving duration (in min)
efficiencyScore
number
Average ecodriving score
safetyScore
number
Average safety score

Road context

Driving contexts are calculated from the GPS velocity. They are not based on map data.
Value
Description
HEAVY_URBAN_TRAFFIC
Speed below 30 km/h and distance between two stops greater than 100m
CITY
30 km/h < Speed < 65 km/h
SUBURBAN
65 km/h < Speed < 96 km/h
EXPRESSWAYS
Speed > 96 km/h
Last modified 4mo ago