otonomo-docs

Test Drive Vehicle Data from Otonomo

Our connected car data is now accessible for developers

Trips Attributes

In this section you will find the available attributes for our Trips data set only.
To see the available attributes for other data sets, read:

As of API V1, we use our new, coherent data attribute naming convention.
Attribute names are determined according to three tiers:

Category – the frame of reference. For example: Vehicle, Mobility, Environment, Driver
Element – a component of the category. For example: Engine (in the Vehicle category), Speed (in the Mobility category)
Specific - a description of the element. For example: Temperature (of the Engine), Average (of the Speed)
Each data attribute is a unique trio, separated by two underscores ("__").

Some examples:
VehicleEngineTemperature - The current temperature of the vehicle's engine
EnvironmentExternalTemperature - The current air temperature level outside of the vehicle (ODB-II-PID:46) in celsius.
MobilitySpeedValue - The vehicle's current speed in Km/h (ODB-II-PID:0D)

attribute_name description type unit_name
location__city__end The GPS geocoding of the city where a trip has ended String string
location__city__start The GPS geocoding of a city where a trip has started String string
location__city__summary The list of cities a vehicle has driven in during a given trip ArrayString array<string>
location__country__end The GPS geocoding of the country where a trip has ended String string
location__country__start The GPS geocoding of a country where a trip has started String string
location__country__summary A list of countries a vehicle has driven in during a given trip ArrayString array<string>
location__latitude__end A vehicle's latitude location at the end of a trip Float deg
location__latitude__start A vehicle's latitude location at the start of a trip Float deg
location__longitude__end The vehicle's longitude location at the end of a trip Float deg
location__longitude__start A vehicle's longitude location at the start of a trip Float deg
location__road__summary The list of roads a vehicle has driven on during a given trip ArrayString array<string>
location__state__end The name of the state where the vehicle trip has ended. Calculated by reverse-geotagging  GPS coordinates. String str
location__state__start The name of the state where the vehicle trip has started. Calculated by reverse-geotagging  GPS coordinates. String str
location__state__summary List of states the vehicle has gone through on its trip. Calculated by reverse-geotagging  GPS coordinates. ArrayString array<string>
location__town__end The town a vehicle has ended its trip in String str
location__town__start The town a vehicle has started its trip in String str
location__town__summary The list of towns a vehicle has driven on during a given trip ArrayString array<string>
location__village__end The village a vehicle has ended its trip in String str
location__village__start The village a vehicle has started its trip in String str
location__village__summary The list of villages a vehicle has driven on during a given trip ArrayString array<string>
manufacturer__category__value The classification of a given vehicle String string
manufacturer__color__value The color of a vehicle String string
manufacturer__fuel_type__value A manufacturer definition of the vehicle's type of fuel String string
manufacturer__make__value The vehicle's make or brand name. String string
manufacturer__model__value The vehicle's model. String string
manufacturer__purchase__country The car's purchase country code. String  
manufacturer__year__value The year the vehicle was manufactured. Integer year
metadata__anonymization__type_name The type of anonymization preformed on the data String string
metadata__identification__trip_id A unique identifier for a given trip String string
metadata__provider__name The name of the provider String string
metadata__quality__end_reason The reason a trip has ceased String str
metadata__quality__ignitions_used The number of ignitions used to determine the start and end time of a trip Integer integer
metadata__quality__score_description A list of attributes with suspicious values and therefore lowers the quality of the trip. ArrayString array<string>
metadata__quality__score_value The level of quality a trip holds, with 0% indicating a low quality trip and 100% indicating a high quality trip. Float percentage
metadata__quality__start_reason The reason a trip has begun String str
metadata__record__count The total amount of points accumulated in a trip Long integer
metadata__record__frequency The average time between transmitted data points within a given trip Float milliseconds
metadata__service_name__first_received The first Otonomo service processing incoming data String  
metadata__time__duration The duration between the start and end of a trip Long milliseconds
metadata__time__end_epoch The end time of a trip (UTC) in Epoch Long epoch
metadata__time__start_epoch The start time of a trip (UTC) in Epoch Long epoch
mobility__distance__aerial The aerial distance between the start and end of a trip Float km
mobility__distance__traveled The total distance of a trip in meters. Float km
mobility__fuel__amount_consumed The total amount of fuel used in a single trip Float liter
mobility__fuel__percentage_consumed The total amount of fuel consumed by a vehicle during a trip Float percentage
mobility__hv_battery__comfort_energy_consumption Electrical energy consumption of the last trip done in comfort mode. Float kWh
mobility__hv_battery__electrical_energy_ratio The percentage of distance driven, on the last trip, using electrical energy. Float percentage
mobility__hv_battery__end_level The vehicles high voltage battery level, in percentage, at the end of the last trip. Float percentage
mobility__hv_battery__recuperated_energy The average recuperated energy in the last driver in KWh per 100 km. Float kWh/100km
mobility__hv_battery__total_energy_consumption Overall electrical energy consumption in the last trip. Float kWh
mobility__odometer__end The odometer reading at the end of a trip Float km
mobility__odometer__start The odometer reading at the start of a trip Float km
mobility__speed__average The average speed a vehicle was driving during a trip in km/h Float km/h
mobility__speed__average_by_distance The average speed of a vehicle during a given trip, calculated by distance / time. Float km/h
mobility__speed__max_by_distance The maximum speed of a vehicle during a given trip, calculated by distance / time per segment Float km/h
mobility__speed__maximum The maximum speed a vehicle was driving during a trip in km/h Float km/h
mobility__speed__minimum The minimum speed a vehicle drove in a single trip Float km/h
vehicle__fuel__capacity The vehicle's fuel tank capacity in liters. Float liter
vehicle__identification__daily_id A vehicle's daily identification number created by otonomo String string
vehicle__identification__otonomo_id A unique vehicle's identification number created by Otonomo String string
vehicle__identification__vin The vehicle's identification number String string

Updated 4 months ago

Trips Attributes


Suggested Edits are limited on API Reference Pages

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