Profile
Last updated
Was this helpful?
Last updated
Was this helpful?
Each driver has a signature that depends on the way they use their vehicle. This service provides an accurate picture of the driver's profile based on an analysis of driving data.
The driver profile reflects the driver's habits: frequency of trips, regularity, distance travelled per year and mobility area.
The reliability and accuracy of the results improves with the amount of historical data analyzed. A minimum of 2 active weeks and 500 km travelled are required to get a response.
userId
string
Driver's unique identifier
The table below summarizes the list of a driver profile's data.
userInfo
Generic information about the user
statistics
Synthesis of the user's data since his first recorded trip
regularity
Regularity of the user
distanceEstimation
Estimated driving distances per week, month and year
profile
User's driving habits
percentageRoadContext
array[object]
commonTrips
array[object]
mobilityArea
array[object]
The table below summarizes the content of the userInfo object.
userId
string
User unique identifier
firstname
string
User firstname
lastname
string
User lastname
companyName
string
Company name
registerDate
string
User registration date
Date format: YYYY-MM-dd’T’HH:mm:ss.SSSZ
firstTrip
string
Date of the first trip
Date format: YYYY-MM-dd’T’HH:mm:ss.SSSZ
lastTrip
string
Date of the last trip
Date format: YYYY-MM-dd’T’HH:mm:ss.SSSZ
The table below summarizes the content of the statistics object.
tripsNumber
int
Total number of trips
totalDistance
int
Total distance (in km)
totalDuration
int
Total driving duration (in min)
week
int
Number of weeks since user registration
activeWeek
int
Number of active weeks since user registration
month
int
Number of months since user registration
activeMonth
int
Number of active months since user registration
peakHour
string
Peak hour trip start
Format: hh:mm
peakDay
string
Weekday with most trips completed.
Allowed values: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY
The table below summarizes the content of the regularity object.
week
object
User's regularity on a weekly basis
month
object
User's regularity on a monthly basis
The structure of week an month object is very similar, as described in the tables below:
numberWeek
int
Number of weeks used to compute the regularity
numberTripMean
int
Average number of trips per week
numberTripStd
int
Standard deviation of the number of trips per week
distanceMean
int
Average weekly distance (in km)
distanceStd
int
Standard deviation for the weekly distance (in km)
durationMean
int
Average weekly driving duration (in min)
durationStd
int
Standard deviation of the weekly driving duration (in min)
The table below summarizes the content of the distanceEstimation object.
week
int
Estimated weekly distance (in km)
month
int
Estimated monthly distance (in km)
year
int
Estimated annual distance (in km)
confidence
string
Confidence level indicator
Allowed values: LOW, MEDIUM, HIGH
The table below summarizes the content of the profile object.
distance
string
User's distance class
Allowed values: VERY_SHORT, SHORT, MEDIUM, LONG, VERY_LONG
activity
string
User's activity class
Allowed values: LOW, MEDIUM, HIGH
regularity
string
User's regularity class
Allowed values: REGULAR, INTERMITTENT
roadContext
string
User's major road context (distance based)
Allowed values: TRAFFIC_JAM, HEAVY_URBAN_TRAFFIC, CITY, SUBURBAN, EXPRESSWAYS
mobility
string
User's mobility class
Allowed values: NARROW, SMALL, MEDIUM, LARGE, WIDE, VAST
comment
string
Short description of the user's profile in plain english
VERY_SHORT
Very short distance driver
less than 5 000
SHORT
Short distance driver
5 000 to 10 000
MEDIUM
Medium distance driver
10 000 to 20 000
LONG
Long distance driver
20 000 to 40 000
VERY_LONG
Professional driver
more than 40 000
LOW
Low activity driver
less than 30 %
MEDIUM
Medium activity driver
30 to 60 %
HIGH
High activity driver
more than 60 %
NARROW
90% of trips are within a radius of less than 10 km
SMALL
90% of trips are within a radius of less than 20 km
MEDIUM
90% of trips are within a radius of less than 30 km
LARGE
90% of trips are within a radius of less than 50 km
WIDE
90% of trips are within a radius of less than 100 km
VAST
90% of trips are within a radius of 100 km or more
The percentageRoadContext array contains a data object for each allowed context value:
context
string
Road context
Allowed values: TRAFFIC_JAM, HEAVY_URBAN_TRAFFIC, CITY, SUBURBAN, EXPRESSWAYS
distance
double
Percentage of total distance spent in this context
duration
double
Percentage of total duration spent in this context
energy
double
Percentage of total energy spent in this context
The commonTrips array contains a data object for each allowed type value:
type
string
Typology of the most common trip.
Allowed values: MOST_FREQUENT
count
int
Number of trips
distance
int
Average trip distance (in km)
duration
int
Average trip duration (in min)
roadContext
string
Road context
Allowed values: TRAFFIC_JAM, HEAVY_URBAN_TRAFFIC, CITY, SUBURBAN, EXPRESSWAYS
The mobilityArea array contains a data object for each allowed type value:
type
string
Percentile of trips
Allowed values:
PERCENTILE_50TH, PERCENTILE_90TH
radius
int
Radius (in km) of the circle containing the trips
Distribution of the user's trip by road context (see )
Typology of usual user trips (see )
User mobility area (see )
This service returns information describing a driver's profile and his driving habits. The accuracy of the results depends on the distance travelled and the activity duration. A minimum of 2 active weeks and 500 km travelled are required to get a response.
User's username
Drivekit Admin API key