Trips

Auto API
Level 13
Last Updated
Level 13
Added In
Level 12
Identifier
0x00 0x6a

This page specifies the Auto API protocol for Vehicle Status. Head over to the REST API, iOS SDK, Android SDK or Node.js SDK code reference pages for platform specifics.

Type

id: 0x01
name: type
name_cased: type
name_pretty: Type
added: 12
type: enum
size: 1
description: Type of the trip
enum_values:
  - id: 0x00
    name: single
  - id: 0x01
    name: multi
  - id: 0x02
    name: eco

Example

data_component: "00"
value: single
description: Trip had a single stop

Driver name

id: 0x02
name: driver_name
name_cased: driverName
name_pretty: Driver name
added: 12
type: string
description: Name of the driver of the trip

Example

data_component: 486172692053656c646f6e
value: Hari Seldon
description: Driver name is 'Hari Seldon'

Description

id: 0x03
name: description
name_cased: description
name_pretty: Description
added: 12
type: string
description: Description of the trip

Example

data_component: 546f20736176652068756d616e6b696e64
value: To save humankind
description: Description of the trip is 'To save humankind'

Start time

id: 0x04
name: start_time
name_cased: startTime
name_pretty: Start time
added: 12
type: timestamp
size: 8
description: Start time of the trip

Example

data_component: 00000172cc7e5190
value: 2020-06-19T12:12:10.000Z
description: Trip started at 19 June 2020 at 12:12:10 GMT

End time

id: 0x05
name: end_time
name_cased: endTime
name_pretty: End time
added: 12
type: timestamp
size: 8
description: End time of the trip

Example

data_component: 00000172ccb54010
value: 2020-06-19T13:12:10.000Z
description: Trip ended at 19 June 2020 at 13:12:10 GMT

Start address

id: 0x06
name: start_address
name_cased: startAddress
name_pretty: Start address
added: 12
type: string
description: Start address of the trip

Example

data_component: 536b616c69747a65722053747261c39f652036382c203130393937204265726c696e2c204765726d616e79
value: Skalitzer Straße 68, 10997 Berlin, Germany
description: Trip started from Skalitzer Straße 68, 10997 Berlin, Germany

End address

id: 0x07
name: end_address
name_cased: endAddress
name_pretty: End address
added: 12
type: string
description: End address of the trip

Example

data_component: 536b616c69747a65722053747261c39f652036382c203130393937204265726c696e2c204765726d616e79
value: Skalitzer Straße 68, 10997 Berlin, Germany
description: Trip ended at Skalitzer Straße 68, 10997 Berlin, Germany

Start coordinates

id: 0x08
name: start_coordinates
name_cased: startCoordinates
name_pretty: Start coordinates
added: 12
type: types.coordinates
description: Start coordinates of the trip

Example

data_component: 404a40090b417ca2402ae122d948dc12
values:
  latitude: 52.500276
  longitude: 13.439719
description: Trip started from 52.500276:13.439719

End coordinates

id: 0x09
name: end_coordinates
name_cased: endCoordinates
name_pretty: End coordinates
added: 12
type: types.coordinates
description: End coordinates of the trip

Example

data_component: 404a40090b417ca2402ae122d948dc12
values:
  latitude: 52.500276
  longitude: 13.439719
description: Trip ended at 52.500276:13.439719

Start odometer

id: 0x0a
name: start_odometer
name_cased: startOdometer
name_pretty: Start odometer
added: 12
type: unit.length
size: 10
description: Odometer reading at the start of the trip

Example

data_component: 120440c4820000000000
value:
  kilometers: 10500
description: At the start of the trip the odometer was showing 10500.0km

End odometer

id: 0x0b
name: end_odometer
name_cased: endOdometer
name_pretty: End odometer
added: 12
type: unit.length
size: 10
description: Odometer reading at the end of the trip

Example

data_component: 120440c4978000000000
value:
  kilometers: 10543
description: At the start of the trip the odometer was showing 10543.0km

Average fuel consumption

id: 0x0c
name: average_fuel_consumption
name_cased: averageFuelConsumption
name_pretty: Average fuel consumption
added: 12
type: unit.fuel_efficiency
size: 10
description: Average fuel consumption during the trip

Example

data_component: 0f00401d5c28f5c28f5c
value:
  liters_per_100_kilometers: 7.34
description: Average fuel consumption during the trip was 7.34 l/100km

Distance

id: 0x0d
name: distance
name_cased: distance
name_pretty: Distance
added: 12
type: unit.length
size: 10
description: Distance of the trip

Example

data_component: "12044045800000000000"
value:
  kilometers: 43
description: Distance of trip was 43.0km

Start address components

id: 0x0e
name: start_address_components
name_cased: startAddressComponents
name_pretty: Start address components
name_singluar: start_address_component
added: 12
type: types.address_component
multiple: true
description: Start address components

Example

data_component: 0000064265726c696e
values:
  type: city
  value: Berlin
description: City component value is 'Berlin'
data_component: 0100074765726d616e79
values:
  type: country
  value: Germany
description: Country component value is 'Germany'
data_component: "0200024445"
values:
  type: country_short
  value: DE
description: Country short component value is 'DE'
data_component: 0300064265726c696e
values:
  type: district
  value: Berlin
description: District component value is 'Berlin'
data_component: "0400053130313137"
values:
  type: postal_code
  value: "10117"
description: Postal code component value is '10117'
data_component: 050014536b616c69747a65722053747261c39f65203638
values:
  type: street
  value: Skalitzer Straße 68
description: Street component value is 'Skalitzer Straße 68'
data_component: 06000b4272616e64656e62757267
values:
  type: state_province
  value: Brandenburg
description: Country component value is 'Brandenburg'
data_component: 0700074765726d616e79
values:
  type: other
  value: Germany
description: Other component value is 'Germany'

End address components

id: 0x0f
name: end_address_components
name_cased: endAddressComponents
name_pretty: End address components
name_singluar: end_address_component
added: 12
type: types.address_component
multiple: true
description: End address components

Example

data_component: 0000064265726c696e
values:
  type: city
  value: Berlin
description: City component value is 'Berlin'
data_component: 0100074765726d616e79
values:
  type: country
  value: Germany
description: Country component value is 'Germany'
data_component: "0200024445"
values:
  type: country_short
  value: DE
description: Country short component value is 'DE'
data_component: 0300064265726c696e
values:
  type: district
  value: Berlin
description: District component value is 'Berlin'
data_component: "0400053130313137"
values:
  type: postal_code
  value: "10117"
description: Postal code component value is '10117'
data_component: 050014536b616c69747a65722053747261c39f65203638
values:
  type: street
  value: Skalitzer Straße 68
description: Street component value is 'Skalitzer Straße 68'
data_component: 06000b4272616e64656e62757267
values:
  type: state_province
  value: Brandenburg
description: Country component value is 'Brandenburg'
data_component: 0700074765726d616e79
values:
  type: other
  value: Germany
description: Other component value is 'Germany'

Event

id: 0x01
name: event
name_cased: event
name_pretty: Event
added: 13
type: enum
size: 1
enum_values:
  - id: 0x00
    name: harsh_braking
  - id: 0x01
    name: harsh_acceleration
  - id: 0x02
    name: sharp_turn
  - id: 0x03
    name: over_rpm
    name_pretty: Over RPM
  - id: 0x04
    name: overspeed
  - id: 0x05
    name: idling_engine_on

Example

data_component: "01"
value: harsh_acceleration
description: Driving event of harsh acceleration encountered

Eco level

id: 0x01
name: eco_level
name_cased: ecoLevel
name_pretty: Eco level
added: 13
type: enum
size: 1
enum_values:
  - id: 0x00
    name: high
  - id: 0x01
    name: medium

Example

data_component: "00"
value: high
description: Eco driving level is high

Thresholds

id: 0x01
name: thresholds
name_cased: thresholds
name_pretty: Thresholds
name_singluar: Threshold
added: 13
type: types.eco_driving_threshold
multiple: true
description: Eco driving thresholds

Example

data_component: "000000000000000000"
values:
  type: zero
  value: 0
description: Eco driving zero-threshold is set at 0.0
data_component: "010000000000000000"
values:
  type: one
  value: 0
description: Eco driving one-threshold is set at 0.0

Total fuel consumption

id: 0x01
name: total_fuel_consumption
name_cased: totalFuelConsumption
name_pretty: Total fuel consumption
added: 13
type: unit.volume
size: 10
description: Total fuel consumption during the trip

Example

data_component: "19024037666666666666"
value:
  liters: 23.4
description: Total fuel consumption during the trip was 23.4 l

Total idle fuel consumption

id: 0x02
name: total_idle_fuel_consumption
name_cased: totalIdleFuelConsumption
name_pretty: Total idle fuel consumption
added: 13
type: unit.volume
size: 10
description: Fuel consumed while idle since the last ignition on.

Example

data_component: "19024004000000000000"
value:
  liters: 2.5
description: Since the last ignition the vehicle has consumed 2.5 l while ideling.

Maximum speed

id: 0x02
name: maximum_speed
name_cased: maximumSpeed
name_pretty: Maximum speed
added: 13
type: unit.speed
size: 10
description: Maximum speed recorded since the last igntion on.

Example

data_component: 16014050d33333333333
value:
  kilometers_per_hour: 67.3
description: Maximum speed since last ignition on is 67.3km/h