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

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