otonomo-docs

Test Drive Vehicle Data from Otonomo

Our connected car data is now accessible for developers

Attribute List

This attribute list refers to all base attributes, supplementary attributes, and enrichments. It is broken up into three sections:

Data Points
Trips
Road Signs

Data Points

A   

Attribute Name

Description

Format

Unit

AC Command

Binary indication of whether the air conditioning is being turned on or off

Boolean

AC Target Temperature

The current temperature set in the AC system

Float

Celsius

Acceleration

The measured rate of change of a vehicle's speed in a set time period

Float

g

Accelerator On

Binary indication of whether the accelerator is pressed

Boolean

Accident

The yes-or-no status of whether a vehicle experienced an accident in a given point

Boolean

Active Media Source

Name of the currently active media source (AM, FM, SDARS, CD, MP3, Pandora, Spotify, iHeart, TuneIn, Aha, etc.)

String

Air Bag Status

Determines whether the vehicle's airbags have been inflated (true) or not (false)

Boolean

Album Name

Current played song album name

String

Alternator Voltage

The voltage of the vehicle's alternator

Float

Volt

Altitude

The current elevation above sea level of a given point

Float

Meter

Ambient Air Pressure

The current barometric pressure outside of the vehicle (OBD-II-PID:33)

Float

kPa

Ambient Air Temp

The current air temperature level outside of the vehicle (ODB-II-PID:46)

Float

Celsius

Artist Name

Current played song artist name

String

Audio On

Audio On/Off

Boolean

Audio Volume

Audio Volume Level

Integer

B

Attribute Name

Description

Format

Unit

Battery Current

The electrical current flowing through the battery of a vehicle

Float

amp

Battery Level

The vehicle's current power supply level

Float

Percentage

Battery Voltage

A vehicle's battery voltage level for a given point

Float

Volt

Brake Pedal Force

The measured amount of pressured force applied to the brake pedal

Boolean

kN

Brake Pedal Status

Determines whether the brake pedal is being pressed (true) or not (false)

Boolean

C

Attribute Name

Description

Format

Unit

Car Make

The vehicle's make or brand name

String

Car Model

The vehicle's model

String

Car Year

The year the vehicle was manufactured

Integer

Central Lock On

The determination of whether the central lock is on (true) or off (false)

Boolean

Color

The color of a vehicle

String

Commanded Throttle Actuator

The vehicle's commanded throttle actuator (OBD-II-PID:4C)

Float

Percentage

Convertible Top Status

The open-or-closed status of a vehicle's convertible top

Boolean

Coolant Temperature

The temperature of the engine coolant (OBD-II-PID:05)

Float

Celsius

Coolant Temperature Warning On

The on/off status of a vehicle's coolant warning light

Boolean

Cruise Control

The on-or-off status of the cruise control feature

Boolean

D

Attribute Name

Description

Format

Unit

Distance to Empty

An approximated distance a vehicle can drive before running out of fuel

Float

Percentage

Distance to Empty EV

The approximated distance an electric vehicle can drive before running out of battery

Float

km

Distance to Empty Total

The approximated distance an electric vehicle can drive before all of its power sources shut down

Float

km

Driver Age

The age of the driver

Integer

Year

Driver Door Open

The open-or-closed status of a vehicle's driver's door

Boolean

Driver Gender

The driver's gender

String

Driver Seat Belt On

An indication of whether the driver's seat belt is fastened (true) or not (false)

Boolean

dtcs

The current defined Diagnostic Trouble Codes

String

E

Attribute Name

Description

Format

Unit

Electric Power Steering Warning On

The on/off status of a vehicle's electric power steering warning light

Boolean

Engine Hood Open

Indicates if the engine's hood is open (true) or closed (false)

Boolean

Engine Load

The calculated engine load of the vehicle (OBD-II-PID:04)

Float

Percentage

Engine Oil Temp

The measured temperature of the oil in the engine

Float

Celsius

Engine On

The determination of whether the engine is currently on (true) or off (false)

Boolean

Engine On Duration

The vehicle's run time since the engine was ignited (OBD-II-PID:1F)

Float

Second

Engine Temp

The current temperature of the vehicle's engine

Float

Celsius

EV Battery Consumption

An electric vehicle's current battery consumption

Float

km/kwh

EV Battery Level

The current battery level of an electric vehicle from -100% to +100%

Float

Percentage

EV Engine Temp

The temperature of the engine in an electric vehicle

Float

Celsius

EV Regenerative Brake

The determination of whether an electric vehicle is being charged while driving (true) or not (false)

Boolean

EV Regenerative Brake Front

The determination of whether energy flows from the front wheels to the battery (true) or not (false)

Boolean

EV Regenerative Brake Rear

The determination of whether energy flows from the rear wheels to the battery (true) or not (false)

Boolean

Evap Pressure

The vehicle's evaporative system vapor pressure (OBD-II-PID: 54)

Float

Pa

F

Attribute Name

Description

Format

Unit

F Interior Lights

The on/off status of a vehicle's interior front lights

Boolean

Fast Acceleration

An indication of whether there was a quick acceleration

Boolean

FL Door Lock Status

The locked-or-unlocked status of a vehicle's front left door

Boolean

FL Door Status

The open-or-closed status of a vehicle's front left door

Boolean

FL Reading Lamp

The on/off status of a vehicle's front left reading lamp

Boolean

FL Seat Belt Status

An indication of whether the front left seat belt is fastened (true) or not (false)

Boolean

FL Window Status

The open-or-closed status of a vehicle's front left window

Boolean

FR Door Lock Status

The locked-or-unlocked status of a vehicle's front right door

Boolean

FR Door Status

The open-or-closed status of a vehicle's front right door

Boolean

FR Reading Lamp

The on/off status of a vehicle's front right reading lamp

Boolean

FR Seat Belt Status

An indication of whether the front right seat belt is fastened (true) or not (false)

Boolean

FR Window Status

The open-or-closed status of a vehicle's front right window

Boolean

Fuel Amount

The current amount of fuel available in the fuel tank

Float

Liter

Fuel Consumption

The vehicle's rate of fuel consumption

Float

Percentage/ km

Fuel Injection Timing

Crank Angle Degrees (CAD) relative to TDC of the compression stroke; OBD-II-PID: 5D

Float

Degrees

Fuel Level

A vehicle's current fuel level expressed in percentages (OBD-II-PID:2F)

Float

Percentage

Fuel Pressure

The current fuel/gauge pressure within the vehicle (OBD-II-PID:0A)

Float

kPa

Fuel Pump Temp

The temperature of the fuel pump.

Float

Percentage

Fuel Tank Lock Status

The locked-or-unlocked status of a vehicle's fuel tank

Boolean

Fuel Type

The type of fuel this vehicle is currently equipped with (OBD-II-PID:51)

String

G

Attribute Name

Description

Format

Unit

Gear Engaged

An indication of whether the gear is being engaged in the gearbox (true) or not (false)

Boolean

Gear Position

The current position of the gear stick

String

Geocoding City

The name of the city a vehicle was located in for a given point

String

Geocoding City Block

The name of the city block a vehicle was on during a given point

String

Geocoding Continent

The name of the continent a vehicle was located in during a given point

String

Geocoding Country

The name of the country a vehicle was located in for a given point

String

Geocoding Country Long

The name of the country a vehicle was located in during a given point

String

Geocoding County

The name of the county a vehicle was located in during a given point

String

Geocoding District

The name of the district a vehicle was located during a given point

String

Geocoding Farm

The name of the farm a vehicle was located in during a given point

String

Geocoding House

The address of the house a vehicle was located near during a given point

String

Geocoding House Number

The numerical address of the house a vehicle was located near during a given point

String

Geocoding Island

The name of the island a vehicle was located in during a given point

String

Geocoding Municipality

The name of the municipality a vehicle was located near during a given point

String

Geocoding Neighbourhood

The name of the neighborhood a vehicle was located in during a given point

String

Geocoding Quarter

The name of the quarter a vehicle was located in during a given point

String

Geocoding Region

The name of the region a vehicle was located in during a given point

String

Geocoding Road

The name of the road a vehicle was on during a given point

String

Geocoding Square

The name of the square a vehicle was on during a given point

String

Geocoding State

The name of the state a vehicle was located in during a given point

String

Geocoding Suburb

The name of the suburb a vehicle was located in during a given point

String

Geocoding Town

The name of the town a vehicle was located in during a given point

String

Geocoding Village

The name of the village a vehicle was located in during a given point

String

Geohash

A geographic location shortened into letters and digits that represent a specific area.

String

GPS Fix

GPS location latitude (5 decimal)

Float

GPS Quality

The quality level of the GPS location from low to high

Float

Degree

GPS Validity

Indicates whether the GPS data is valid (true) or not (false)

Boolean

Gyroscope X

The vehicle's angular velocity around its lateral axis

Float

rad/s

Gyroscope Y

The vehicle's angular velocity around its longitudinal axis

Float

rad/s

H

Attribute Name

Description

Format

Unit

Hand Brake On

The determination of whether the handbrake was pulled (true) or not (false)

Boolean

Hard Brake

An indication of whether the driver used the hard brake

Boolean

HDOP

GPS Quality Standard - Horizontal Dilution Of Precision

Float

Ratio

Head Lamp

An on-or-off status of a vehicle's headlights

Boolean

Head Unit Elapsed Time

The time since the head unit (centerpiece of the vehicle's sound system) was turned on

Integer

Second

Heading

The angle between the vehicle's direction in comparison to the north

Float

Degrees

Horn Status

An indication of whether the horn is being pressed (true) or not (false)

Boolean

Hybrid Battery Level

The current hybrid battery level (OBD-II-PID:5B)

Float

Percentage

I

Attribute Name

Description

Format

Unit

Ignition

Indicates whether the vehicle's ignition is being turned on (true) or off (false)

Boolean

Indicator Light Name

The title of an indication of a potential problem or safety issue

String

Indicator Light State

The ON-or-OFF state of the indication described in INDICATOR LIGHT NAME

Boolean

Intake Air Temperature

The temperature of the air entering the vehicle

Float

Celsius

Intake Map

The vehicle's intake manifold absolute pressure (OBD-II-PID:0B)

Float

kPa

Interior Temperature

The current air temperature inside a vehicle

Float

Celsius

Is ABS Active

An indication of whether the ABS (Anti-lock Braking System) is active

Boolean

Is Airbag System Disabled

The enabled/disabled status of a vehicle's airbag system

Boolean

Is ESP Active

An indication of whether the ESP (Electronic Stability Control) is active

Boolean

Is Traction Control Active

The on/off status of a vehicle's Traction Control System

Boolean

L

Attribute Name

Description

Format

Unit

Lateral Acceleration

The right (positive value) -and-left (negative value) acceleration of a vehicle

Float

g

Latitude

The GPS latitudinal location of a given vehicle

Float

Degrees

Left Blinker Status

Determines if the left blinkers are turned on (true) or off (false)

Boolean

Location City

The city a vehicle is currently located in

String

Location Country

The country a vehicle is currently located in

String

Longitude

The GPS longitudinal location of a given vehicle

Float

Degrees

Longitudinal Acceleration

The forward (positive value) -and-backward (negative value) acceleration of a vehicle

Float

g

Low Fuel Indicator On

The determination of whether the low fuel light indicator is on (true) or off (false)

Boolean

M

Attribute Name

Description

Format

Unit

Mass Air Flow

The mass of air flowing into the engine's air intake system (OBD-II-PID:10)

Integer

kg/s

Mil Alert

An alert represented in the dashboard to inform the driver of a malfunction with the vehicle

String

Mil Cleared Distance

Distance traveled since codes cleared; OBD-II-PID: 31

Float

km

Mil On Distance

The total distance a vehicle has traveled with the malfunction indicator lamp on (OBD-II-PID:21)

Float

km

Mil On Duration

The run time of a given vehicle with the malfunction indicator lamp on (OBD-II-PID:4D)

Float

Minute

Mil Status

The lights on-or- lights off status of the MIL alert

Boolean

O

Attribute Name

Description

Format

Unit

obuid

An identifier of the vehicle's OBD (On-Board Diagnostics) system

String

Odometer

The accumulated distance traveled by a vehicle

Float

km

OEM

The name of the Original Equipment Manufacturer

String

Oil Level

The amount of oil remaining in the engine's oil tank

Float

Percentage

Oil Level Warning On

The on/off status of a vehicle's oil level warning light

Boolean

Oil Maintenance Warning On

The on/off status of a vehicle's oil maintenance warning light

Boolean

Oil Pressure Warning On

The on/off status of a vehicle's oil pressure warning light

Boolean

Otonomo Daily ID

A vehicle's daily identification number created by otonomo

String

Otonomo ID

A vehicle's identification number created by otonomo

String

Over Speed

An indication of whether the vehicle's speed is over the limit

Boolean

P

Attribute Name

Description

Format

Unit

Parking Brake On

The determination of whether the hand brake/ parking brake is on (true) or off (false)

Boolean

Passenger Door Open

The open-or-closed status of a vehicle's passenger's door

Boolean

Provider

The name of the provider

String

R

Attribute Name

Description

Format

Unit

R Interior Lights

The on/off status of a vehicle's interior rear lights

Boolean

Radio Frequency

Frequency of the radio station in the vehicle

Float

MHz

Radio Station Name

Name of the radio station currently played in the vehicle

String

Received Time

Msg received time

Long

epoch

Right Blinker Status

Determines if the right blinkers are turned on (true) or off (false)

Boolean

Rl Door Lock Status

The locked-or-unlocked status of a vehicle's rear left door

Boolean

Rl Door Status

The open-or-closed status of a vehicle's rear left door

Boolean

Rl Seat Belt Status

An indication of whether the rear left seat belt is fastened (true) or not (false)

Boolean

Rl Window Status

The open-or-closed status of a vehicle's rear left window

Boolean

Rm Seat Belt Status

An indication of whether the rear middle seat belt is fastened (true) or not (false)

Boolean

Road Temp

The temperature of the road

Float

Celsius

Roll Angle

Current degrees from flat

Float

Degree

Roof Status

The open-or-closed status of a vehicle's roof

Boolean

Rpm

The engine's revolutions per minute (OBD-II-PID:0C)

Float

r/m

Rr Door Lock Status

The locked-or-unlocked status of a vehicle's rear right door

Boolean

Rr Door Status

The open-or-closed status of a vehicle's rear right door

Boolean

Rr Seat Belt Status

An indication of whether the rear right seat belt is fastened (true) or not (false)

Boolean

Rr Window Status

The open-or-closed status of a vehicle's rear right window

Boolean

S

Attribute Name

Description

Format

Unit

Satellites Count

The amount of GPS satellites available

Long

Number

Sharp Turn

An indication of whether a sharp turn took place

Boolean

Slope

The tangent of the angle of the vehicle to the horizontal

Float

Degree

Song Name

Current played song title

String

Speed

The vehicle's current speed (ODB-II-PID:0D)

Float

km/h

State Of Charge

An electric vehicle's current battery level

Float

Percentage

Steering Wheel Angle Position

The angle in which a steering wheel is currently placed (0 degrees means the vehicle is straight)

Float

Degree

Steering Wheel Rotation Speed

The speed in which the steering wheel rotates

Float

deg/s

Suspension Height Fl

The difference in the front-left wheels suspension length from its starting position.

Float

mm

Suspension Height Fr

The difference in the front-right wheels suspension length from its starting position

Float

mm

Suspension Height Rl

The difference in the rear-left wheels suspension length from its starting position

Float

mm

Suspension Height Rr

The difference in the rear-right wheels suspension length from its starting position

Float

mm

T

Attribute Name

Description

Format

Unit

Throttle Position

The vehicle's throttle position (OBD-II-PID:11)

Float

Percentage

Time

The exact time of a given point (UTC)

Long

epoch milliseconds

Time Stamp

The run time since an engine has turned on

Long

hh:mm:ss

Timing Advance

The ignition timing advance for #1 cylinder (OBD-II-PID:0E)

Float

Degrees

Tire Pressure Fl

The exact amount of tire pressure the front left wheel is experiencing

Float

psi

Tire Pressure Fr

The exact amount of tire pressure the front right wheel is experiencing

Float

psi

Tire Pressure Rl

The exact amount of tire pressure the rear left wheel is experiencing

Float

psi

Tire Pressure Rr

The exact amount of tire pressure the rear right wheel is experiencing

Float

psi

Tires Pressure

The vehicle's tire pressure amount

Float

psi

Trunk Lock Status

The locked-or-unlocked status of a vehicle's trunk

Boolean

Trunk Status

The open-or-closed status of a vehicle's trunk

Boolean

Turn Signals Status

The status of a turn signal

String

Tire Pressure Warning On

The on/off status of a vehicle's tire pressure warning light

Boolean

V

Attribute Name

Description

Format

Unit

Vehicle Category

The classification of a given vehicle

String

Vehicle Descriptor

A portion of the vehicle identification number

String

Vehicle Lock

The status of a command to lock a vehicle

Boolean

Vehicle Unlock

The status of the command to unlock a vehicle

Boolean

Vertical Acceleration

The up (positive value) -and-down (negative value) acceleration of a vehicle

Float

g

VIN

The vehicle's identification number

String

Vin Car Make

The vehicle's make or brand, decoded from VIN

String

Vin Car Model

The vehicle's model, decoded from VIN

String

Vin Car Year

The year the vehicle was manufactured, decoded from VIN

Integer

Year

Vin Fuel Type

The vehicle's primary fuel type, decoded from VIN

String

Vin Vehicle Category

The vehicle's category, decoded from VIN

String

W

Attribute Name

Description

Format

Unit

Wheel Slip Fl

The ratio between the angular velocity of the front-left tire to the velocity of the vehicle

Float

Ratio

Wheel Slip Fr

The ratio between the angular velocity of the front-right tire to the velocity of the vehicle

Float

Ratio

Wheel Slip Rl

The ratio between the angular velocity of the rear-left tire to the velocity of the vehicle

Float

Ratio

Wheel Slip Rr

The ratio between the angular velocity of the rear-right tire to the velocity of the vehicle

Float

Ratio

Wiper Status

An indication whether the front windshield wipers are on (true) or off (false)

Boolean

Y

Attribute Name

Description

Format

Unit

Yaw Rate

The vehicle's angular velocity around its vertical axis

Float

rad/s

Trips

Attribute Name

Description

Format

Unit

End Geocoding City

The GPS geocoding of the city where a trip has ended

String

End Geocoding Country

The GPS geocoding of the country where a trip has ended

String

End Geocoding Town

The town a vehicle has ended its trip in

String

End Geocoding Village

The village a vehicle has ended its trip in

String

End Latitude

A vehicle's latitude location at the end of a trip

Float

Degree

End Longitude

The vehicle's longitude location at the end of a trip

Float

Degree

End Odometer

The odometer reading at the end of a trip

Float

km

End Time

The end time of a trip (UTC)

Long

epoch

Start Geocoding City

The GPS geocoding of a city where a trip has started

String

Start Geocoding Country

The GPS geocoding of a country where a trip has started

String

Start Geocoding Town

The town a vehicle has started its trip in

String

Start Geocoding Village

The village a vehicle has started its trip in

String

Start Latitude

A vehicle's latitude location at the start of a trip

Float

Degree

Start Longitude

A vehicle's longitude location at the start of a trip

Float

Degree

Start Odometer

The odometer reading at the start of a trip

Float

km

Start Time

The start time of a trip (UTC)

Long

epoch

Trip Aerial Distance

The aerial distance between the start and end of a trip

Float

km

Trip Average Fuel Consumption

The average amount of fuel consumed by a vehicle during a trip

Float

Percentage

Trip Average Speed

The average speed a vehicle was driving during a trip

Float

km/h

Trip Average Speed By Distance

The average speed of a vehicle during a given trip, calculated by distance / time

Float

km/h

Trip Distance

The total distance of a trip

Float

km

Trip Distance

The total distance of a trip

Long

Milliseconds

Trip Duration

The duration between the start and end of a trip

String

Milliseconds

Trip End Reason

The reason a trip has ceased

String

Trip ID

A unique identifier for a given trip

Integer

Trip Ignitions Used

The number of ignitions used to determine the start and end time of a trip

Float

km/h

Trip Max Speed By Distance

The maximum speed of a vehicle during a given trip, calculated by distance / time per segment

Float

km/h

Trip Maximal Speed

The maximum speed a vehicle was driving during a trip

Float

km/h

Trip Minimal Speed

The minimum speed a vehicle drove in a single trip

Long

Trip Point Count

The total amount of points accumulated in a trip

Float

Milliseconds

Trip Points Interval Avg

The average time between transmitted data points within a given trip

Float

Percentage

Trip Quality

The level of quality a trip holds, with 0% indicating a low quality trip and 100% indicating a high quality trip.

ArrayString

Trip Quality Description

A list of attributes with suspicious values and therefore lowers the quality of the trip.

String

Trip Start Reason

The reason a trip has begun

ArrayString

Trip Summary Cities

The list of cities a vehicle has driven in during a given trip

ArrayString

Trip Summary Countries

A list of countries a vehicle has driven in during a given trip

ArrayString

Trip Summary Roads

The list of roads a vehicle has driven on during a given trip

ArrayString

Trip Summary Towns

The list of towns a vehicle has driven on during a given trip

ArrayString

Trip summary Villages

The list of villages a vehicle has driven on during a given trip

ArrayString

Trip Total Fuel Amount

The total amount of fuel used in a single trip

Float

Liter

Trip Total Fuel Consumption

The total amount of fuel consumed by a vehicle during a trip

Float

Percentage

Road Signs

Distance Sign

Whether the sign distance definition is no/zero (false) or yes/greater than zero (true)

Boolean

Duration Sign

Whether the sign duration definition is no/zero (false) or yes/greater than zero (true)

Boolean

Fixed Sign

Whether the sign presence is permanent (true) or variable (false)

Boolean

Lateral Offset

The left/right offset between the car's position and a traffic sign

Float

Longitudinal Offset

The forward offset between the car's position and a traffic sign

Float

Sign Condition

The current upkeep of a road sign

String

Sign Latitude

GPS location latitude of a road sign

Float

Degree

Sign Location

Location of the sign relative to the vehicle

String

Sign Longitude

GPS location longitude of a road sign

Float

Degree

Sign Scope

The area or subject matter that the sign pertains to

String

Sign Type

Determines exactly what the sign signifies through color, image, and/or statement

String

Sign Vehicle Type

Vehicle types to which the sign refers to

String

Speed Limit

The speed limit of the road a vehicle was driving on during a specific point

Float

Speed Unit

The speed limit unit

String

Vertical Offset

The height offset between the car's position a traffic sign

Float

Zone Sign

Whether sign zone definition is present (true) or not (false)

Boolean

Updated 10 months ago

Attribute List


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.