otonomo-docs

Test Drive Vehicle Data from Otonomo

Our connected car data is now accessible for developers

Fleet Data Attributes

Attribute Name

Description

US/EU

environment_external_temperature

The current air temperature level outside of the vehicle ) in Celsius.

US, EU

environment_road_speed_limit

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

US, EU

location_altitude_value

The current elevation above sea level of a given point in meters.

US, EU

location_latitude_value

The GPS latitudinal location of a given vehicle in decimal degrees

US, EU

location_longitude_value

The GPS longitudinal location of a given vehicle in decimal degrees

US, EU

maintenance_brake_fluid_replace_date

This date when the brake fluid should be changed in epoch time.

EU

maintenance_dtc_current_diagnostics

The current defined Diagnostic Trouble Codes

EU

maintenance_exhaust_gas_inspection_month_to_next

Indicates how many months before exhaust gas inspection is due, service advisor will be notified.

EU

maintenance_inspection_due_date

The due date of the next inspection in epoch time

EU

maintenance_service_days_to_next

The number of days remaining before the next vehicle service is due.

EU

maintenance_service_distance_to_next

The remaining distance until next vehicle service is due

EU

maintenance_service_due_date

The due date of the next vehicle service, epoch time.

US, EU

manufacturer_color_value

The color of a vehicle

EU

manufacturer_drive_type

the vehicle drive (drivetrain) type: 1 - Rear-wheel drive 2 - Front-wheel drive 3 - Four-wheel drive

US, EU

manufacturer_engine_power

Engine's power in Watts

US, EU

manufacturer_final_inspection_date

The final inspection date of the vehicle in UTC

US, EU

manufacturer_fuel_type

The manufacturer definition of the vehicle's type of fuel 1 - Gasoline 2 - Methanol 3 - Ethanol 4 - Diesel 5 - LPG 6 - CNG 7 - Propane 8 - Electric 9 - Bifuel running Gasoline 10 - Bifuel running Methanol 11 - Bifuel running Ethanol 12 - Bifuel running LPG 13 - Bifuel running CNG 14 - Bifuel running Propane 15 - Bifuel running Electricity 16 - Bifuel running electric and combustion engine 17 - Hybrid gasoline 18 - Hybrid Ethanol 19 - Hybrid Diesel 20 - Hybrid Electric 21 - Hybrid running electric and combustion engine 22 - Hybrid Regenerative 23 - Bifuel running diesel

EU

manufacturer_make_value

The vehicle's make or brand name.

US, EU

manufacturer_model_value

The vehicle's model.

EU

manufacturer_transmission_type

the transmission type of the vehicle 1 - manual 2 - automatic

EU

manufacturer_year_value

The year the vehicle was manufactured.

EU

metadata_identification_license_plate

the license plate number of the vehicle

EU

metadata_time_epoch

The exact time of a given point (UTC) in Epoch format

US, EU

mobility_acceleration_value

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

EU

mobility_heading_angle

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

US, EU

mobility_odometer_value

The accumulated distance traveled by a vehicle in km

US, EU

mobility_speed_value

The vehicle's current speed in Km/h

US, EU

state_of_charge

An electric vehicle's current battery level

US, EU

vehicle_abs_status

"An indication of the ABS (Anti-lock Braking System) status.
0 - disabled
1 - enabled - nonactive
2 - active"

EU

vehicle_adblue_level

the adblue level in the vehicle in percentage

EU

vehicle_adblue_level_warning

Describes the status of the adblue level warning 0 - inactive 1 - active

EU

vehicle_battery_level

The vehicle's battery power level (state of charge)

US, EU

vehicle_battery_level_warning

Indicates whether low battery warning is active/inactive 0 - inactive 1 - active

US, EU

vehicle_battery_voltage

The current measurement of a vehicle's battery voltage.

US, EU

vehicle_brake_pre_wear_warning

Determine whether a brake lining wear pre-warning was activated 0 - not active 1 - active

US, EU

vehicle_brake_wear_warning

Indicated whether brake lining wear warning is active/inactive 0 - inactive 1 - active

EU

vehicle_brake_fluid_level_warning

Describes the status of the brake fluid level warning 0 - inactive 1 - active

EU

vehicle_charging_plug_status

The status of the charging plug. 0 - disconnected. 1 - connected to the vehicle.

US, EU

vehicle_coolant_level_warning

Indicates whether the coolant level warning is active/inactive 0 - inactive 1 - active

EU

vehicle_coolant_temperature

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

US, EU

vehicle_door_i_j_status

"The vehicle door status. The (i_j) notation refers to the i-th row and j-th column starting from (1,1) top left. E.g. on a typical passenger vehicle, vehicle_door_1_1_status relates to the front-left door.
2 - open
3 - closed"

EU

vehicle_door_central_lock_status

"Status of the vehicle central lock.
0 - open
1 - locked
2 - vehicle locked internally
3 - vehicle locked externally
4 - vehicle selectively unlocked"

EU

Vehicle_door_lock_i_j_status

The vehicle door lock status. The (i_j) notation refers to the i-th row and j-th column starting from (1,1) top left. 0 - open 1 - locked

EU

vehicle_emergency_brake_system_status

"The emergency braking system status.
0 - off
1- warning
2 - active
The following values are a summary of the last 20 seconds:
50 - off and warning
51 - off and active
52 - warning and active
53 - off, warning and active
54 - value not used
55 - value not used and off
56 - value not used and warning
57 - value not used, warning and off
58 - value not used and active
59 - value not used, off and active
60 - value not used, warning and active
61 - value not used, warning, active and off"

EU

vehicle_engine_oil_level

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

US, EU

vehicle_engine_oil_temperature

The measured temperature of the oil in the engine

EU

vehicle_engine_rpm

The engine's revolutions per minute

US, EU

vehicle_engine_status

"Engine status.
0 - not running
1 - starting
2 - running
3 - Engine stopped by the start/stop system"

EU

vehicle_esp_status

"An indication of the ESP (Electronic Stability Control) status.
0 - disables
1 - enabled - nonactive
2 - active"

US, EU

vehicle_fog_light_front_status

"The status of a vehicle's front fog lamp
0 - off
1 - on"

US, EU

vehicle_fog_light_rear_status

"The status of a vehicle's rear fog lamp.
0 - off
1 - on"

US, EU

vehicle_fuel_amount

The current amount of fuel available in the fuel tank in liters.

US, EU

vehicle_fuel_capacity

The vehicle's fuel tank capacity in liters.

US, EU

vehicle_fuel_level

A vehicle's current fuel level expressed in percentages

US, EU

vehicle_fuel_level_warning

Indicates whether the fuel level warning is active/inactive 0 - inactive 1 - active

US, EU

vehicle_fuel_remaining_range

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

US, EU

vehicle_fuel_tank_door_status

"The status of a vehicle's fuel tank.
0 - locked
1 - unlocked"

US, EU

vehicle_headlights_status

"The status of a vehicle's headlights.
0 - off
1 - on"

US, EU

vehicle_hood_status

"Indicates the engine's hood (bonnet) status.
0 - closed
1 - open"

US, EU

vehicle_hv_battery_ac_charging_current

The maximum current of the last charging cycle (Alternating current).

US

vehicle_hv_battery_ac_charging_voltage

The Voltage of the last charging cycle (Alternating current).

US

vehicle_hv_battery_charging_method

"Vehicle charging current (AC/DC) and plug type.
0 - No Charging
1 - AC Type1 Plug
2 - AC Type2 Plug"

EU

vehicle_hv_battery_charging_power

current charging power (only valid while charging) in kW

EU

vehicle_hv_battery_charging_status

"The charging status of a vehicle's (Hybrid or EV) high voltage battery
0 - not charging
1 - charging while driving - regenerative brake
2 - charging at a charging station"

EU

vehicle_hv_battery_level

HV (high voltage) battery level in percentage

EU

vehicle_hv_battery_remaining_range

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

EU

vehicle_identification_otonomo_id

A unique vehicle's identification number created by Otonomo

US, EU

vehicle_identification_vin

The vehicle's identification number

US, EU

vehicle_ignition_status

"Ignition status. (state of the Ignition switch)
0 - Lock/Off turn the engine off, keys can be removed only in this state
1 - Accessory. The vehicle systems receive energy from the battery, the engine is off.
2 - On/Run - the engine is on
3 - start - ignition event (cranking the engine)
4 - initialization"

US, EU

vehicle_indication_light_oil_level

"The status of a vehicle's oil level warning light.
0 - off
1 - on"

US, EU

vehicle_indication_light_oil_maintenance

"The status of a vehicle's oil maintenance warning light.
0 - off
1 - on"

US, EU

vehicle_infotainment_navigation_free_poi

The amounts of POIs (points of interest) are still open in the navigation system

EU

vehicle_infotainment_navigation_max_poi

This amount of POIs (points of interest) that can be stored in the navigation system

EU

vehicle_lane_assist_left_status

"Left lane keep assist.
0 - Keep assist system is off
1 - Keep assist system is on, but unavailable (due to road condition for example)
2 - Keep assist system is on
3 - Active. Correction in progress
The following values are a summary of the last 20 seconds:
50 - Keep assist was off and unavailable
51 - Keep assist was on and off
52 - Keep assist was on, unavailable and on again
53 - Keep assist was on, unavailable and off
54 - Keep assist was off and active
55 - Keep assist was on, unavailable and active
56 - Keep assist was on, unavailable, active and off
57 - Keep assist was on and active
58 - Keep assist was off, on and active
59 - Keep assist was on, unavailable, on and active
60 - Keep assist was off, on, unavailable, on and active"

EU

vehicle_lane_assist_right_status

"Right lane keep assist.
0 - Keep assist system is off
1 - Keep assist system is on, but unavailable (due to road condition for example)
2 - Keep assist system is on
3 - Active. Correction in progress
The following values are a summary of the last 20 seconds:
50 - Keep assist was off and unavailable
51 - Keep assist was on and off
52 - Keep assist was on, unavailable and on again
53 - Keep assist was on, unavailable and off
54 - Keep assist was off and active
55 - Keep assist was on, unavailable and active
56 - Keep assist was on, unavailable, active and off
57 - Keep assist was on and active
58 - Keep assist was off, on and active
59 - Keep assist was on, unavailable, on and active
60 - Keep assist was off, on, unavailable, on and active"

EU

vehicle_light_switch_status

the current status of the vehicles rotary light switch 1 - Automatic 2 - Dipped Headlights 3 - Right parking light 4 - Left parking light 5 - Sidelights

EU

vehicle_parking_brake_status

"The status of the hand/parking brake.
0 - off
1- on"

US, EU

vehicle_reading_light_1_j_status

"The status of a vehicle's reading lamp. The (j) notation refers to the j-th column starting from (1) for the left.
0 - off
1 - on"

EU

vehicle_reading_light_rear_status

the status of the rear reading lights 0 - off 1 - on

EU

vehicle_roof_convertible_status

"The status of a vehicle's convertible top.
0 - closed and locked
1 - unlocked
2 - open and locked"

US, EU

vehicle_roof_sunroof_status

"The status of a vehicle's sunroof.
0 - Closed
1 - Open
2 - Sunroof is tilted-open
3 - Sunroof is running
4 - Sunroof in anti-wobble position
5 - Sunroof in an intermediate sliding position
6 - Sunroof in an intermediate tilted position"

US, EU

vehicle_tire_i_j_pressure

"The exact amount of tire pressure the vehicle's (i,j) wheel is experiencing.
The (i_j) notation refers to the i-th row and j-th column starting from (1,1) top left."

US, EU

vehicle_tire_pressure_warning

Indicates whether the tire pressure warning is active/inactive 0 - inactive 1 - active

EU

vehicle_trunk_status

"The status of a vehicle's trunk (boot).
0 - locked
1 - closed unlocked
2 - open"

US, EU

vehicle_washer_fluid_level_warning

Indicates whether wash fluid warning is active/inactive 0 - inactive 1 - active

EU

vehicle_window_i_j_status

"The status of a vehicle's (i,j) window.
The vehicle door status. The (i_j) notation refers to the i-th row and j-th column starting from (1,1) top left.
0 - Intermediate position
1 - Opened
2 - Closed
3 - Airing position
4 - Intermediate, airing position
5 - Currently running"

US, EU

Updated 26 days ago

Fleet Data Attributes


Suggested Edits are limited on API Reference Pages

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