References
This section describes the main response codes of the trip analysis API.
Vehicle body type
1
Car
Compact
2
Car
Sedan
3
Car
Luxury vehicle
4
Car
Estate car
5
Car
Minivan
6
Car
4x4, SUV
7
Car
Sports car
8
Car
Convertible
9
Car
Commercial vehicle
200
Truck
2-axle trailer
201
Truck
3-axle trailer
202
Truck
4-axle trailer
203
Truck
2-axle tractor
204
Truck
3-axle tractor
Engine type
1
Gasoline
2
Diesel
3
Electric vehicle
4
Gasoline-electric hybrid
5
Diesel-electric hybrid
6
Biofuel
7
Bi-fuel gasoline bioethanol
8
Dual-fuel gasoline NGV
9
Dual-fuel gasoline LPG
10
Not available
11
Plug-in gasoline hybrid
12
Hydrogen
Gearbox type
1
Automatic
2
Manual 5-speed
3
Manual 6-speed
4
Manual 7-speed
5
Manual 8-speed
Drive wheels type
0
Front-wheel drive
1
Rear-wheel drive
2
Four-wheel drive
Weather code
0
Unknown
1
Clear sky
2
Cloudy
3
Foggy
4
Rainy
5
Snowy
6
Icy
Transportation Mode
0
Unknown
1
Passenger car
2
Motorcycle
3
Heavy-duty vehicle
4
Bus
5
Coach
6
Rail trip
7
Boat trip
8
Bike trip
9
Plane
10
Ski
11
On foot
12
Idle
13
Other
Road conditions
0
Traffic jam
This corresponds to vehicle displacements of less than 100 meters and performed with speeds below 10 km/h
1
Heavy urban traffic
Speed below 30 km/h and distance between two stops greater than 100 m
2
City
30 km/h < Speed < 65 km/h
3
Suburban
65 km/h < Speed < 96 km/h
4
Expressways
Speed > 96 km/h
Error codes
true
0
OK
The data are correct and the process ran fine
false
10
Mandatory account object not found
The « account» block is not set
false
13
Mandatory route object not found
The « route » block is not available → The trip analysis is not possible
false
14
Invalid route definition
Error when parsing the Route block
false
15
Velocity data is missing
The vehicle or GPS velocity is not available → The trip analysis is not possible
true
16
Engine speed not available
The engine speed is not available → The trip analysis is performed with an estimated value of the engine speed
true
17
Engine speed is null
The engine speed is always at 0 rpm while the vehicle is moving → The trip analysis is performed but with an estimated value of the engine speed
true
18
One or more vehicle parameters are missing (<list of missing parameters>). Default values are used
The vehicle characteristics are not set or some values are missing → The trip analysis is performed with generic vehicle model parameters
false
19
Invalid sampling period: one second recording interval is recommended for input variables
The input variables have an invalid acquisition period → The trip analysis is not possible
true
20
More than 25% of data loss
More than 25% of data loss is detected during the trip
false
21
Invalid customerId
Unknown account value. Unauthorized access.
false
23
Date data is missing
The field vehicleDate or gpsDate is not available → The trip analysis is not possible
false
24
Daily request number is reached
The maximum daily request number is reached
true
25
The trip distance is lower than 1 km
This error message indicates that the trip was analysed but the distance is not sufficient to provide an accurate energy analysis
false
26
Your request could not be processed. If the problem persist, please contact us
The service failed to process your data. There is a need to diagnose your data to determine the origin of this problem
false
27
Your request could not be processed. If the problem persist, please contact us
The service failed to process your data. There is a need to diagnose your data to determine the origin of this problem
true
28
One or more vehicle parameters are out of bound (<list of missing parameters>)
The vehicle characteristics are not in the range of available values. See vehicle characteristics for range limits
false
29
Beacon is missing
The beacon has not been detected and it is required to validate the trip analysis
false
30
Invalid beacon data
A beacon was detected during the trip but it does not have the correct identifiers
false
31
A similar trip has already been processed and stored with same account
The duplicate trip feature is enabled and the trip has already been analyzed
true
32
The vehicleId is invalid
No vehicle found for the vehicleId provided into the API request
false
33
The total of GPS points are under 10
There is not enough GPS points to perform an analysis
false
34
The account of this driver is disabled
The driver account is disabled
false
35
The automatic driver account creation is disabled
The automatic creation is disabled, use a valid authentication process to create the driver account
false
36
All the dates are negatives
The field vehicleDate or gpsDate contains negative values → The trip analysis is not possible
false
37
Your request could not be processed. If the problem persist, please contact us
The service failed to process your data. There is a need to diagnose your data to determine the origin of this problem
false
38
Unable to create a new driver: maximum number of drivers reached for the account
The trip's driver cannot be created automatically, because you reached the maximum allowed number of drivers for your account. Please contact us to increase this threshold.
Last updated