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 6 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.