Ranking
The ranking service is used to retrieve the ranking of all drivers belonging to a group. This service returns the ranking of the current month and the previous month.
To be ranked, a driver must have completed at least 5 trips and travelled 20 km in a month.
The ranking of the current month is updated every 10 minutes.
The ranking of the previous month is frozen on the 1st day of the current month.
If you have your admin API key, you can try the API via this link.
get
https://service.drivequant.com/v3
/drivekit/admin/drivers/ranking
Get driver's ranking
You may not have access to all the types. Please ask your DriveQuant contact if you need more information.

Response

The table below summarizes the list of ranking data.
Field
Text
Description
currentMonth
Drivers with their rank in the group in the current month
previousMonth
Drivers with their rank in the group in the previous month
type
String
Ranking type set in the service call. Can be safety, eco-driving, distraction, speeding

MonthRanking

MonthRanking contains the list of drivers in a group with their rank.
Field
Type
Description
monthNumber
Int
Month number of the ranking period (1 -> january, 2 -> february, ...)
driverRankedNumber
Int
Number of ranked drivers
driverRanked
array[UserRanked]
List of ranked drivers
driverNotRanked
List of unranked drivers (i.e. who have not driven the minimum distance and completed the minimum number of trips)

UserRanked

Field
Type
Description
userId
String
Driver's unique identifier
fisrtname
String
Driver's firstname
lastname
String
Driver's lastname
pseudo
String
Driver's pseudo
rank
Int
Driver's rank
score
Number
Driver's score
distance
Number
Monthly driving distance (in km)

UserNotRanked

Field
Type
Description
userId
String
Driver's unique identifier
fisrtname
String
Driver's firstname
lastname
String
Driver's lastname
pseudo
String
Driver's pseudo
distance
Number
Monthly driving distance (in km)
Last modified 15d ago