Links

References

This section describes the main response codes of the trip analysis API.

Vehicle body type

Value
Type
Description
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

Value
Description
1
Gasoline
2
Diesel
3
Electric vehicle
4
Gasoline-electric hybrid
5
Diesel-electric hybrid

Gearbox type

Value
Description
1
Automatic
2
Manual 5-speed
3
Manual 6-speed
4
Manual 7-speed
5
Manual 8-speed

Drive wheels type

Value
Description
0
Front-wheel drive
1
Rear-wheel drive
2
Four-wheel drive

Weather code

Value
Description
0
Unknown
1
Clear sky
2
Cloudy
3
Foggy
4
Rainy
5
Snowy
6
Icy

Transportation Mode

Value
Description
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

Value
Description
Comment
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

Status
Code
Comment
Description
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
11
Invalid account definition
Error when parsing the account block. or there are missing values → The trip analysis is not possible
false
12
Invalid vehicle definition
Error when parsing the Vehicle block
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
22
Unauthorized request type
The account is not authorized to query this request type
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
false
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