Timeline
The driver timeline service provides a driver's score history and statistics. It is presented as a vector of chronologically sorted data. Two time scales are available:
weekly and
monthly.
The data are obtained by averaging scores and aggregating trip data over a week or a month.
Timeline data is updated hourly.
If you have your admin API key, you can try the API via this link.
Timeline of driver's scores
GET
https://service.drivequant.com/v3/drivekit/admin/drivers/{userId}/timeline
Get monthly and weekly averages of DriveQuant scores 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 timeline data.
Timeline
Averages of scores for all context and each road context.
Field | Type | Description |
---|---|---|
allContext | Averages of scores for all contexts | |
roadContext |
| Averages of scores for each context (see RoadTimelineItem) |
AllTimelineItem
Average of scores for all contexts
Field | Type | Description |
---|---|---|
date |
| Vector of dates (first day of the week/month): date format (YYYY-MM-dd’T’HH:mm:ss.SSSZ) |
numberTripScored |
| Vector of trips number (scored) |
numberTripTotal |
| Vector of trips number (total) |
distance |
| Vector of driving distances (in km) |
duration |
| Vector of driving durations (in min) |
safety |
| Vector of average safety scores |
acceleration |
| Vector of total hard accelerations |
braking |
| Vector of total hard brakings |
adherence |
| Vector of total adherence limits |
efficiency |
| Vector of average ecodriving scores |
co2Mass |
| Vector of total CO2 mass (in kg) |
fuelVolume |
| Vector of total fuel volume (in l) |
efficiencyAcceleration |
| Vector of efficiency subscores related to acceleration phase |
efficiencyBrake |
| Vector of efficiency subscores related to brake phases |
efficiencySpeedMaintain |
| Vector of efficiency subscores related to speed maintain phases |
phoneDistraction |
| Vector of average phone distraction scores |
unlock |
| Vector of tot unlocks - only for allContext |
lock |
| Vector of total locks - only for allContext |
callAuthorized |
| Vector of total authorized calls - only for allContext |
callForbidden |
| Vector of total unauthorized calls - only for allContext |
callAuthorizedDuration |
| Vector of authorized calls duration (in sec) - only for allContext |
callForbiddenDuration |
| Vector of unauthorized calls duration (in sec) - only for allContext |
numberTripWithForbiddenCall |
| Vector of number of trips with one or more forbidden call |
speeding |
| Vector of average speeding scores |
speedingDuration |
| Vector of duration over speed limits |
speedingDistance |
| Vector of distance travelled over speed limits |
tripCategory |
| |
tripCategoryDistance |
| |
weather |
| |
weatherDistance |
| |
dayDistance |
| Distance travelled during the daylight |
weekDayDistance |
| Distance travelled during week days (monday to friday) |
RoadTimelineItem
Average of scores for each contexts
Field | Type | Description |
---|---|---|
roadContext |
| Road context (see below) |
date |
| Vector of dates (first day of the week/month): date format (YYYY-MM-dd’T’HH:mm:ss.SSSZ) |
numberTripScored |
| Vector of trips number (scored) |
numberTripTotal |
| Vector of trips number (total) |
distance |
| Vector of driving distances (in km) |
duration |
| Vector of driving durations (in min) |
safety |
| Vector of average safety scores |
acceleration |
| Vector of total hard accelerations |
braking |
| Vector of total hard brakings |
adherence |
| Vector of total adherence limits |
efficiency |
| Vector of average ecodriving scores |
co2Mass |
| Vector of total CO2 mass (in kg) |
fuelVolume |
| Vector of total fuel volume (in l) |
efficiencyAcceleration |
| Vector of efficiency subscore related to acceleration phas |
efficiencyBrake |
| Vector of efficiency subscore related to brake phases |
efficiencySpeedMaintain |
| Vector of efficiency subscore related to speed maintain phases |
RoadContext
Road 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 |
TripCategory
Category of trips by distance
Index | Description |
---|---|
0 | Less than 2 km |
1 | From 2 to 10 km |
2 | From 10 to 50 km |
3 | From 50 to 100 km |
4 | More than 100 km |
Weather
Type of weather
Index | Description |
---|---|
0 | Unknown |
1 | Sunny |
2 | Cloudy |
3 | Foggy |
4 | Rainy |
5 | Snowy |
6 | Ice |
Last updated