Synthesis
Last updated
Was this helpful?
Last updated
Was this helpful?
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.
GET
https://service.drivequant.com/v3/drivekit/admin/drivers/{userId}/synthesis
Get a synthesis of DriveQuant scores and statistics for a specified driver.
userId
string
Driver's unique identifier
DriveKit-Admin-API-Key
string
Admin API Key
The table below summarizes the list of synthesis data.
userInfo
User information
smartphoneData
Information about the user's smartphone
customerData
Specific customer-related data
scoresTimeRange
Average driving scores per period
scoresRoadContext
Driving statistics and average scores per road context
userId
string
User unique identifier
firstname
string
User first name
lastname
string
User last name
companyName
string
Company name
registerDate
date
User registration date
Date format: YYYY-MM-dd’T’HH:mm:ss.SSSZ
firstTrip
date
Date of the first trip
Date format: YYYY-MM-dd’T’HH:mm:ss.SSSZ
lastTrip
date
Date of the last trip
Date format: YYYY-MM-dd’T’HH:mm:ss.SSSZ
lastUpdate
date
Date of the last synthesis data update.
Date format: YYYY-MM-dd’T’HH:mm:ss.SSSZ
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
Customer data consists of customer-specific metadata such as: license plate number, commercial email opt-in, contract number (formatted as a map of key-value).
For each theme (efficiency, safety, phoneDistraction, speeding, distance, acceleration, braking, adherence, fuelVolume, co2Mass):
overall
double
Average score based on all trips
currentWeek
double
Average score based on trips performed during the current week
currentMonth
double
Average score based on trips performed during the current month
roadContext
string
Road context (see below)
distance
double
Total driving distance (in km)
duration
double
Total driving duration (in min)
efficiencyScore
double
Average ecodriving score
safetyScore
double
Average safety score
Driving contexts are calculated from the GPS velocity. They are not based on map data.
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