References
This section describes the main response codes of the trip analysis API.
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 |
Value | Description |
1 | Gasoline |
2 | Diesel |
3 | Electric vehicle |
4 | Gasoline-electric hybrid |
5 | Diesel-electric hybrid |
Value | Description |
1 | Automatic |
2 | Manual 5-speed |
3 | Manual 6-speed |
4 | Manual 7-speed |
5 | Manual 8-speed |
Value | Description |
0 | Front-wheel drive |
1 | Rear-wheel drive |
2 | Four-wheel drive |
Value | Description |
0 | Unknown |
1 | Clear sky |
2 | Cloudy |
3 | Foggy |
4 | Rainy |
5 | Snowy |
6 | Icy |
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 |
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 |
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 |
Last modified 1yr ago