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.
get
https://service.drivequant.com
/v3/drivekit/admin/drivers/{userId}/timeline
Timeline of driver's scores

Response

The table below summarizes the list of timeline data.
Field
Type
Description
roadContext
string
Road context (see below)
date
array[date]
Vector of dates (first day of the week/month): date format (YYYY-MM-dd’T’HH:mm:ss.SSSZ)
numberTripScored
array[int]
Vector of trips number (scored)
numberTripTotal
array[int]
Vector of trips number (total)
distance
array[number]
Vector of driving distances (in km)
duration
array[number]
Vector of driving durations (in min)
efficiency
array[number]
Vector of average ecodriving scores
safety
array[number]
Vector of average safety scores
acceleration
array[int]
Vector of total hard accelerations
braking
array[int]
Vector of total hard brakings
adherence
array[int]
Vector of total adherence limits
phoneDistraction
array[number]
Vector of average phone distraction scores
speeding
array[number]
Vector of average speeding scores
co2Mass
array[number]
Vector of total CO2 mass (in kg)
fuelVolume
array[number]
Vector of total fuel volume (in l)

Road context

Road 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