otonomo-docs

Test Drive Vehicle Data from Otonomo

Our connected car data is now accessible for developers

Fleet Data Attributes

Attribute NameDescriptionUS/EU
environment_external_temperatureThe current air temperature level outside of the vehicle ) in Celsius.US, EU
environment_road_speed_limitThe speed limit of the road a vehicle was driving on during a specific pointUS, EU
location_altitude_valueThe current elevation above sea level of a given point in meters.US, EU
location_latitude_valueThe GPS latitudinal location of a given vehicle in decimal degreesUS, EU
location_longitude_valueThe GPS longitudinal location of a given vehicle in decimal degreesUS, EU
maintenance_brake_fluid_replace_dateThis date when the brake fluid should be changed in epoch time.EU
maintenance_dtc_current_diagnosticsThe current defined Diagnostic Trouble CodesEU
maintenance_exhaust_gas_inspection_month_to_nextIndicates how many months before exhaust gas inspection is due, service advisor will be notified.EU
maintenance_inspection_due_dateThe due date of the next inspection in epoch timeEU
maintenance_service_days_to_nextThe number of days remaining before the next vehicle service is due.EU
maintenance_service_distance_to_nextThe remaining distance until next vehicle service is dueEU
maintenance_service_due_dateThe due date of the next vehicle service, epoch time.US, EU
manufacturer_color_valueThe color of a vehicleEU
manufacturer_drive_typethe vehicle drive (drivetrain) type: 1 - Rear-wheel drive 2 - Front-wheel drive 3 - Four-wheel driveUS, EU
manufacturer_engine_powerEngine's power in WattsUS, EU
manufacturer_final_inspection_dateThe final inspection date of the vehicle in UTCUS, EU
manufacturer_fuel_typeThe 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 dieselEU
manufacturer_make_valueThe vehicle's make or brand name.US, EU
manufacturer_model_valueThe vehicle's model.EU
manufacturer_transmission_typethe transmission type of the vehicle 1 - manual 2 - automaticEU
manufacturer_year_valueThe year the vehicle was manufactured.EU
metadata_identification_license_platethe license plate number of the vehicleEU
metadata_time_epochThe exact time of a given point (UTC) in Epoch formatUS, EU
mobility_acceleration_valueThe forward (positive value) -and-backward (negative value) acceleration of a vehicle in g.EU
mobility_heading_angleThe angle between the vehicle's direction in comparison to the north in degreesUS, EU
mobility_odometer_valueThe accumulated distance traveled by a vehicle in kmUS, EU
mobility_speed_valueThe vehicle's current speed in Km/hUS, EU
state_of_chargeAn electric vehicle's current battery levelUS, EU
vehicle_abs_status"An indication of the ABS (Anti-lock Braking System) status.
0 - disabled
1 - enabled - nonactive
2 - active"
EU
vehicle_adblue_levelthe adblue level in the vehicle in percentageEU
vehicle_adblue_level_warningDescribes the status of the adblue level warning 0 - inactive 1 - activeEU
vehicle_battery_levelThe vehicle's battery power level (state of charge)US, EU
vehicle_battery_level_warningIndicates whether low battery warning is active/inactive 0 - inactive 1 - activeUS, EU
vehicle_battery_voltageThe current measurement of a vehicle's battery voltage.US, EU
vehicle_brake_pre_wear_warningDetermine whether a brake lining wear pre-warning was activated 0 - not active 1 - activeUS, EU
vehicle_brake_wear_warningIndicated whether brake lining wear warning is active/inactive 0 - inactive 1 - activeEU
vehicle_brake_fluid_level_warningDescribes the status of the brake fluid level warning 0 - inactive 1 - activeEU
vehicle_charging_plug_statusThe status of the charging plug. 0 - disconnected. 1 - connected to the vehicle.US, EU
vehicle_coolant_level_warningIndicates whether the coolant level warning is active/inactive 0 - inactive 1 - activeEU
vehicle_coolant_temperatureThe 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_statusThe 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 - lockedEU
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_levelThe percentage of oil remaining in the engine's oil tankUS, EU
vehicle_engine_oil_temperatureThe measured temperature of the oil in the engineEU
vehicle_engine_rpmThe engine's revolutions per minuteUS, 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_amountThe current amount of fuel available in the fuel tank in liters.US, EU
vehicle_fuel_capacityThe vehicle's fuel tank capacity in liters.US, EU
vehicle_fuel_levelA vehicle's current fuel level expressed in percentagesUS, EU
vehicle_fuel_level_warningIndicates whether the fuel level warning is active/inactive 0 - inactive 1 - activeUS, EU
vehicle_fuel_remaining_rangeAn approximated distance a vehicle can drive before running out of fuel in kmUS, 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_currentThe maximum current of the last charging cycle (Alternating current).US
vehicle_hv_battery_ac_charging_voltageThe 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_powercurrent charging power (only valid while charging) in kWEU
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_levelHV (high voltage) battery level in percentageEU
vehicle_hv_battery_remaining_rangeThe approximated distance an electric vehicle can drive before running out of batteryEU
vehicle_identification_otonomo_idA unique vehicle's identification number created by OtonomoUS, EU
vehicle_identification_vinThe vehicle's identification numberUS, 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_poiThe amounts of POIs (points of interest) are still open in the navigation systemEU
vehicle_infotainment_navigation_max_poiThis amount of POIs (points of interest) that can be stored in the navigation systemEU
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_statusthe current status of the vehicles rotary light switch 1 - Automatic 2 - Dipped Headlights 3 - Right parking light 4 - Left parking light 5 - SidelightsEU
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_statusthe status of the rear reading lights 0 - off 1 - onEU
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_warningIndicates whether the tire pressure warning is active/inactive 0 - inactive 1 - activeEU
vehicle_trunk_status"The status of a vehicle's trunk (boot).
0 - locked
1 - closed unlocked
2 - open"
US, EU
vehicle_washer_fluid_level_warningIndicates whether wash fluid warning is active/inactive 0 - inactive 1 - activeEU
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 2 months 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.