Usage

Auto API

Level 13

Last Updated

Level 13

Added In

Level 8

Identifier

0x00 0x68

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.

Acceleration durations

id: 0x2d
name: acceleration_durations
name_cased: accelerationDurations
name_pretty: Acceleration durations
name_single: acceleration_duration
added: 13
type: types.acceleration_duration
multiple: true
description: Durations of normal or other accelerations.

Example

data_component: "000007064093480000000000"
values:
  direction: longitudinal
  type: regular
  duration:
    milliseconds: 1234
description: Normal longitudinal acceleration lasted 1234.0ms.

data_component: "010107064093480000000000"
values:
  direction: lateral
  type: positive_outlier
  duration:
    milliseconds: 1234
description: Positive outlier lateral acceleration lasted 1234.0ms.

Acceleration evaluation

id: 0x03
name: acceleration_evaluation
name_cased: accelerationEvaluation
name_pretty: Acceleration evaluation
type: types.percentage
description: Acceleration evaluation percentage

Example

data_component: 3fe6666666666666
value: 0.7
description: Acceleration is evaluated at 70%

Average fuel consumption

id: 0x0e
name: average_fuel_consumption
name_cased: averageFuelConsumption
name_pretty: Average fuel consumption
type: unit.fuel_efficiency
size: 10
description: Average fuel consumption for current trip

Example

data_component: 0f00401a000000000000
value:
  liters_per_100_kilometers: 6.5
description: Average fuel consumption is 6.5 L per 100km

Average speed

id: 0x2b
name: average_speed
name_cased: averageSpeed
name_pretty: Average speed
added: 13
type: unit.speed
size: 10
description: Average speed at data collection.

Example

data_component: "16014053600000000000"
value:
  kilometers_per_hour: 77.5
description: Average speed is 77.5km/h.

Average speed last trip

id: 0x1e
name: average_speed_last_trip
name_cased: averageSpeedLastTrip
name_pretty: Average speed last trip
added: 12
type: unit.speed
size: 10
description: Average speed during last trip

Example

data_component: 1601404619999999999a
value:
  kilometers_per_hour: 44.2
description: Average speed was 44.2km/h during last trip

Average speed since reset

id: 0x1f
name: average_speed_since_reset
name_cased: averageSpeedSinceReset
name_pretty: Average speed since reset
added: 12
type: unit.speed
size: 10
description: Average speed since reset

Example

data_component: 1601404619999999999a
value:
  kilometers_per_hour: 44.2
description: Average speed was 44.2km/h since reset

Average weekly distance

id: 0x01
name: average_weekly_distance
name_cased: averageWeeklyDistance
name_pretty: Average weekly distance
type: unit.length
size: 10
description: Average weekly distance

Example

data_component: 12044084d4cccccccccd
value:
  kilometers: 666.6
description: Average weekly distance is 666.6km

Average weekly distance long run

id: 0x02
name: average_weekly_distance_long_run
name_cased: averageWeeklyDistanceLongRun
name_pretty: Average weekly distance long run
type: unit.length
size: 10
description: Average weekyl distance over long term

Example

data_component: 120440884d999999999a
value:
  kilometers: 777.7
description: Average weekly distance, over long term, is 777.7km

Braking evaluation

id: 0x2a
name: braking_evaluation
name_cased: brakingEvaluation
name_pretty: Braking evaluation
type: types.percentage
description: Braking evaluation percentage

Example

data_component: 3fe6666666666666
value: 0.7
description: Braking is evaluated at 70%

Current fuel consumption

id: 0x0f
name: current_fuel_consumption
name_cased: currentFuelConsumption
name_pretty: Current fuel consumption
type: unit.fuel_efficiency
size: 10
description: Current fuel consumption

Example

data_component: 0f00401e000000000000
value:
  liters_per_100_kilometers: 7.5
description: Current fuel consumption is 7.5 L per 100km

Distance over time

id: 0x15
name: distance_over_time
name_cased: distanceOverTime
name_pretty: Distance over time
added: 12
type: types.distance_over_time
description: Distance driven over a given time period

Example

data_component: 1204409773851eb851ec07044024000000000000
values:
  distance:
    kilometers: 1500.88
  time:
    weeks: 10
description: During the last 10.0 weeks the vehicle travelled 1500.88km

Driving duration last trip

id: 0x22
name: driving_duration_last_trip
name_cased: drivingDurationLastTrip
name_pretty: Driving duration last trip
added: 12
type: unit.duration
size: 10
description: Duration of last trip

Example

data_component: "07014053400000000000"
value:
  minutes: 77
description: Vehicle travelled 77.0min during last trip

Driving duration since reset

id: 0x23
name: driving_duration_since_reset
name_cased: drivingDurationSinceReset
name_pretty: Driving duration since reset
added: 12
type: unit.duration
size: 10
description: Duration of travelling since reset

Example

data_component: "07014056000000000000"
value:
  minutes: 88
description: Vehicle travelled 88.0min since last reset

Driving modes activation periods

id: 0x05
name: driving_modes_activation_periods
name_cased: drivingModesActivationPeriods
name_pretty: Driving modes activation periods
type: types.driving_mode_activation_period
multiple: true
name_singular: driving_modes_activation_period

Example

data_component: 003fc999999999999a
values:
  driving_mode: regular
  period: 0.2
description: Driving mode 'regular' is engaged 20% of the time

data_component: 013fd3333333333333
values:
  driving_mode: eco
  period: 0.3
description: Driving mode 'eco' is engaged 30% of the time

data_component: 023fb999999999999a
values:
  driving_mode: sport
  period: 0.1
description: Driving mode 'eco' is engaged 10% of the time

data_component: 033fb999999999999a
values:
  driving_mode: sport_plus
  period: 0.1
description: Driving mode 'eco' is engaged 1% of the time

data_component: 043fd3333333333333
values:
  driving_mode: eco_plus
  period: 0.3
description: Driving mode 'eco_plus' is engaged 30% of the time

data_component: "050000000000000000"
values:
  driving_mode: comfort
  period: 0
description: Driving mode 'eco' is engaged 0% of the time

Driving modes energy consumptions

id: 0x06
name: driving_modes_energy_consumptions
name_cased: drivingModesEnergyConsumptions
name_pretty: Driving modes energy consumptions
name_singular: driving_mode_energy_consumption
type: types.driving_mode_energy_consumption
multiple: true

Example

data_component: 000c044034333333333333
values:
  driving_mode: regular
  consumption:
    kilowatt_hours: 20.2
description: Driving mode 'regular' consumed 20.2kWh of electric energy

data_component: 010c04404099999999999a
values:
  driving_mode: eco
  consumption:
    kilowatt_hours: 33.2
description: Driving mode 'eco' consumed 33.2kWh of electric energy

data_component: 020c04404b266666666666
values:
  driving_mode: sport
  consumption:
    kilowatt_hours: 54.3
description: Driving mode 'sport' consumed 54.3kWh of electric energy

data_component: 030c044050333333333333
values:
  driving_mode: sport_plus
  consumption:
    kilowatt_hours: 64.8
description: Driving mode 'sport_plus' consumed 64.8kWh of electric energy

data_component: 040c044032000000000000
values:
  driving_mode: eco_plus
  consumption:
    kilowatt_hours: 18
description: Driving mode 'eco_plus' consumed 18.0kWh of electric energy

data_component: 050c044040d9999999999a
values:
  driving_mode: comfort
  consumption:
    kilowatt_hours: 33.7
description: Driving mode 'comfort' consumed 33.7kWh of electric energy

Driving style evaluation

id: 0x04
name: driving_style_evaluation
name_cased: drivingStyleEvaluation
name_pretty: Driving style evaluation
type: types.percentage
description: Driving style evaluation percentage

Example

data_component: 3fec28f5c28f5c29
value: 0.88
description: Driving style is evaluated at 88%

Eco-score bonus range

id: 0x27
name: eco_score_bonus_range
name_cased: ecoScoreBonusRange
name_pretty: Eco-score bonus range
added: 12
type: unit.length
size: 10
description: Eco-score bonus range

Example

data_component: 12043fe6666666666666
value:
  kilometers: 0.7
description: Eco-score bonus range is 0.7km

Eco-score constant

id: 0x26
name: eco_score_constant
name_cased: ecoScoreConstant
name_pretty: Eco-score constant
added: 12
type: types.percentage
description: Eco-score rating constant

Example

data_component: 3fe6666666666666
value: 0.7
description: Eco-score constant is 70%

Eco-score free wheel

id: 0x25
name: eco_score_free_wheel
name_cased: ecoScoreFreeWheel
name_pretty: Eco-score free wheel
added: 12
type: types.percentage
description: Eco-score rating for free-wheeling

Example

data_component: 3fe6666666666666
value: 0.7
description: Eco-score free-wheeling rating is 70%

Eco-score total

id: 0x24
name: eco_score_total
name_cased: ecoScoreTotal
name_pretty: Eco-score total
added: 12
type: types.percentage
description: Overall eco-score rating

Example

data_component: 3fe6666666666666
value: 0.7
description: Total eco-score rating is 70%

Electric consumption average

id: 0x29
name: electric_consumption_average
name_cased: electricConsumptionAverage
name_pretty: Electric consumption average
added: 13
type: unit.energy_efficiency
size: 10
description: Average electric energy consumption calculated based on the last 20km

Example

data_component: 0d00402670a3d70a3d71
value:
  kwh_per_100_kilometers: 11.22
description: Average consumption is 11.22kWh/100km

Electric consumption rate since reset

id: 0x17
name: electric_consumption_rate_since_reset
name_cased: electricConsumptionRateSinceReset
name_pretty: Electric consumption rate since reset
added: 12
type: unit.energy_efficiency
size: 10
description: Electric energy consumption rate since a reset

Example

data_component: 0d004036547ae147ae14
value:
  kwh_per_100_kilometers: 22.33
description: Consumed 22.33kWh/100km since a reset

Electric consumption rate since start

id: 0x16
name: electric_consumption_rate_since_start
name_cased: electricConsumptionRateSinceStart
name_pretty: Electric consumption rate since start
added: 12
type: unit.energy_efficiency
size: 10
description: Electric energy consumption rate since the start of a trip

Example

data_component: 0d00402670a3d70a3d71
value:
  kwh_per_100_kilometers: 11.22
description: Consumed 11.22kWh/100km since the start of a trip

Electric distance last trip

id: 0x18
name: electric_distance_last_trip
name_cased: electricDistanceLastTrip
name_pretty: Electric distance last trip
added: 12
type: unit.length
size: 10
description: Distance travelled with electricity in last trip

Example

data_component: 120040fb198000000000
value:
  meters: 111000
description: Vehicle travelled 111000.0m using electricity during the last trip

Electric distance since reset

id: 0x19
name: electric_distance_since_reset
name_cased: electricDistanceSinceReset
name_pretty: Electric distance since reset
added: 12
type: unit.length
size: 10
description: Distance travelled with electricity since reset

Example

data_component: 1200410b198000000000
value:
  meters: 222000
description: Vehicle travelled 222000.0m using electricity since last reset

Electric duration last trip

id: 0x1a
name: electric_duration_last_trip
name_cased: electricDurationLastTrip
name_pretty: Electric duration last trip
added: 12
type: unit.duration
size: 10
description: Duration of travelling using electricity during last trip

Example

data_component: "07014053400000000000"
value:
  minutes: 77
description: Vehicle travelled 77.0min using electricity during last trip

Electric duration since reset

id: 0x1b
name: electric_duration_since_reset
name_cased: electricDurationSinceReset
name_pretty: Electric duration since reset
added: 12
type: unit.duration
size: 10
description: Duration of travelling using electricity since reset

Example

data_component: "07014056000000000000"
value:
  minutes: 88
description: Vehicle travelled 88.0min using electricity since last reset

Fuel consumption rate last trip

id: 0x1c
name: fuel_consumption_rate_last_trip
name_cased: fuelConsumptionRateLastTrip
name_pretty: Fuel consumption rate last trip
added: 12
type: unit.fuel_efficiency
size: 10
description: Liquid fuel consumption rate during last trip

Example

data_component: 0f00401599999999999a
value:
  liters_per_100_kilometers: 5.4
description: Consumed 5.4 L/100km during last trip

Fuel consumption rate since reset

id: 0x1d
name: fuel_consumption_rate_since_reset
name_cased: fuelConsumptionRateSinceReset
name_pretty: Fuel consumption rate since reset
added: 12
type: unit.fuel_efficiency
size: 10
description: Liquid fuel consumption rate since reset

Example

data_component: 0f004015333333333333
value:
  liters_per_100_kilometers: 5.3
description: Consumed 5.3 L/100km since reset

Fuel distance last trip

id: 0x20
name: fuel_distance_last_trip
name_cased: fuelDistanceLastTrip
name_pretty: Fuel distance last trip
added: 12
type: unit.length
size: 10
description: Distance travelled with (liquid) fuel during last trip

Example

data_component: 120040fb198000000000
value:
  meters: 111000
description: Vehicle travelled 111000.0m using fuel during the last trip

Fuel distance since reset

id: 0x21
name: fuel_distance_since_reset
name_cased: fuelDistanceSinceReset
name_pretty: Fuel distance since reset
added: 12
type: unit.length
size: 10
description: Distance travelled with (liquid) fuel since reset

Example

data_component: 1200410b198000000000
value:
  meters: 222000
description: Vehicle travelled 222000.0m using fuel since last reset

Last trip average energy recuperation

id: 0x0b
name: last_trip_average_energy_recuperation
name_cased: lastTripAverageEnergyRecuperation
name_pretty: Last trip average energy recuperation
type: unit.energy_efficiency
size: 10
description: Energy recuperation rate for last trip

Example

data_component: 0d004016b851eb851eb8
value:
  kwh_per_100_kilometers: 5.68
description: 5.68kWh/100km of electric energy was recuperated during last trip

Last trip battery remaining

id: 0x0c
name: last_trip_battery_remaining
name_cased: lastTripBatteryRemaining
name_pretty: Last trip battery remaining
type: types.percentage
size: 8
description: Battery % remaining after last trip

Example

data_component: 3fe0000000000000
value: 0.5
description: Battery is at 50% after last trip

Last trip date

id: 0x0d
name: last_trip_date
name_cased: lastTripDate
name_pretty: Last trip date
type: timestamp
size: 8
description: The last trip date

Example

data_component: 0000016682059d50
value: 2018-10-17T12:34:58.000Z
description: Last trip happened at 17 October 2018 at 12:34:58 UTC

Last trip electric portion

id: 0x0a
name: last_trip_electric_portion
name_cased: lastTripElectricPortion
name_pretty: Last trip electric portion
type: types.percentage
size: 8
description: Portion of the last trip used in electric mode

Example

data_component: 3fe6666666666666
value: 0.7
description: Electric postion of the last trip is 70%

Last trip energy consumption

id: 0x07
name: last_trip_energy_consumption
name_cased: lastTripEnergyConsumption
name_pretty: Last trip energy consumption
type: unit.energy
size: 10
description: Energy consumption in the last trip

Example

data_component: 0c044059533333333333
value:
  kilowatt_hours: 101.3
description: Last trip consumed 101.3kWh of electric energy

Last trip fuel consumption

id: 0x08
name: last_trip_fuel_consumption
name_cased: lastTripFuelConsumption
name_pretty: Last trip fuel consumption
type: unit.volume
size: 10
description: Fuel consumption in the last trip

Example

data_component: "19024036800000000000"
value:
  liters: 22.5
description: Last trip consumed 22.5 L of fuel

Late night grade

id: 0x14
name: late_night_grade
name_cased: lateNightGrade
name_pretty: Late night grade
added: 12
type: types.grade
description: Grade given for late night driving over time

Example

data_component: "00"
value: excellent
description: Late night driving is graded as excellent

Mileage after last trip

id: 0x09
name: mileage_after_last_trip
name_cased: mileageAfterLastTrip
name_pretty: Mileage after last trip
deprecated:
  new_name: odometer_after_last_trip
  reason: "'mileage' is an incorrect term for this"
type: unit.length
size: 10
description: Mileage after the last trip

Example

data_component: 120440f7590000000000
value:
  kilometers: 95632
description: Mileage is 95'632km after last trip

Odometer after last trip

id: 0x10
name: odometer_after_last_trip
name_cased: odometerAfterLastTrip
name_pretty: Odometer after last trip
added: 12
type: unit.length
size: 10
description: Odometer after the last trip

Example

data_component: 120440f7590000000000
value:
  kilometers: 95632
description: Odometer is 95'632km after last trip

Rapid acceleration grade

id: 0x12
name: rapid_acceleration_grade
name_cased: rapidAccelerationGrade
name_pretty: Rapid acceleration grade
added: 12
type: types.grade
description: Grade given for rapid acceleration over time

Example

data_component: "00"
value: excellent
description: Rapid acceleration is graded as excellent

Rapid deceleration grade

id: 0x13
name: rapid_deceleration_grade
name_cased: rapidDecelerationGrade
name_pretty: Rapid deceleration grade
added: 12
type: types.grade
description: Grade given for rapid deceleration over time

Example

data_component: "01"
value: normal
description: Rapid deceleration is graded as normal

Recuperation power

id: 0x2c
name: recuperation_power
name_cased: recuperationPower
name_pretty: Recuperation power
added: 13
type: unit.power
size: 10
description: Recuperation energy of the drivetrain.

Example

data_component: 140040a1f80000000000
value:
  watts: 2300
description: Recuperation energy is 2300.0W.

Safety driving score

id: 0x11
name: safety_driving_score
name_cased: safetyDrivingScore
name_pretty: Safety driving score
added: 12
type: types.percentage
description: Safety driving score as percentage

Example

data_component: 3fe6666666666666
value: 0.7
description: Safety driving score is evaluated at 70%

Trip meters

id: 0x28
name: trip_meters
name_cased: tripMeters
name_pretty: Trip meters
name_singular: trip_meter
added: 13
type: types.trip_meter
multiple: true

Example

data_component: 011204407c833333333333
values:
  id: 1
  distance:
    kilometers: 456.2
description: Trip meter 1`s distance is 456.2km

data_component: 02120440a372999999999a
values:
  id: 2
  distance:
    kilometers: 2489.3
description: Trip meter 2`s distance is 2489.3km