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.
Synthesis of driver's scores
GET
https://service.drivequant.com/v3/drivekit/admin/drivers/{userId}/synthesis
Get a synthesis of DriveQuant scores and statistics for a specified driver.
Path Parameters
Name | Type | Description |
---|---|---|
userId | string | Driver's unique identifier |
Headers
Name | Type | Description |
---|---|---|
DriveKit-Admin-API-Key | string | Admin API Key |
Response
The table below summarizes the list of synthesis data.
Field | Type | Description |
---|---|---|
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 |
User info
Field | Type | Description |
---|---|---|
userId |
| User unique identifier |
firstname |
| User first name |
lastname |
| User last name |
companyName |
| Company name |
registerDate |
| User registration date
Date format: |
firstTrip |
| Date of the first trip
Date format: |
lastTrip |
| Date of the last trip
Date format: |
lastUpdate |
| Date of the last synthesis data update.
Date format: |
Smartphone data
Field | Type | Description |
---|---|---|
phoneModel |
| Device model name |
appBuildNumber |
| Application build number |
osVersion |
| Version of the operating system |
osType |
| Platform: iOS or Android |
sdkVersion |
| Version of the DriveKit SDK |
phoneLanguage |
| Phone language |
rawPhoneLanguage |
| Raw phone language |
Customer data
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).
ScoresTimeRange
For each theme (efficiency, safety, phoneDistraction, speeding, distance, acceleration, braking, adherence, fuelVolume, co2Mass):
Field | Type | Description |
---|---|---|
overall |
| Average score based on all trips |
currentWeek |
| Average score based on trips performed during the current week |
currentMonth |
| Average score based on trips performed during the current month |
ScoresRoadContext
Field | Type | Description |
---|---|---|
roadContext |
| Road context (see below) |
distance |
| Total driving distance (in km) |
duration |
| Total driving duration (in min) |
efficiencyScore |
| Average ecodriving score |
safetyScore |
| Average safety score |
Road context
Driving contexts are calculated from the GPS velocity. They are not based on map data.
Value | Description |
---|---|
| Speed below 30 km/h and distance between two stops greater than 100m |
| 30 km/h < Speed < 65 km/h |
| 65 km/h < Speed < 96 km/h |
| Speed > 96 km/h |
Last updated