Trips

Auto API
Level 12
Last Updated
Level 12
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
type: enum
size: 1
description: Type of the trip
enum_values:
  - id: 0x00
    name: single
  - id: 0x01
    name: multi

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
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
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
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
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
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
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
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
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
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
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
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
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
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
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'