otonomo-docs

Test Drive Vehicle Data from Otonomo

Our connected car data is now accessible for developers

Creating an Aggregate Service

Table of content

Step #1 - Enter "Create Service" Mode
Step #2 - General Settings Configuration
Step #3 - Choose Required Attributes
Step #4 - Using Your Service

Step #1 - Enter "Create Service" Mode

  1. Login to Otonomo platform at market.otonomo.io
  2. Go to "Services" tab
  3. Press "+Create" button on the top of your screen, next to the "Aggregate" listing

Step #2 - General Settings Configuration

  1. Add Service name
  2. Select a use case. This information is required by Otonomo and Otonomo providers, and is used as part of the service approval process.
    Below you will find a list of the available use cases.
  3. Add description of the service
  4. Choose the countries for which data is required.
  5. Click Next

Use Case

Description

Regulatory Bodies

Government, state agencies and NGOs use vehicle data to research fuel and energy consumption compliance information and obtain independent confirmation. Governments may also be interested in obtaining statistics such as seat belts usage to better target safety campaigns.

Gas & Energy

Allows gas and energy companies (e,g, Shell, BP, ExxonMobil and others) to better understand patterns of drivers that consume fuel and other products in fuel stations. These data sets can help define how to market to those drivers who did not stop at their locations.

EV Infrastructure

Obtain information on EV drivers behavioral patterns (for example 'Range Anxiety'), identify optimal locations for placements of public charging stations, and to help with issues regarding load balancing of the power grid.

Greenwave Service

Leverage offline and real-time traffic data to calculate patterns and vehicles routes to allow the driver to know the speed needed to catch the green light wave on his route.

Safety & Emergency

Improve response times, reduce congestion, decrease property damage, and save lives with connected car data. Information like airbag triggering, hard braking, speed, and location give emergency responders a headstart and also identify problem areas to transportation planners.

Traffic management

Empowering cities, governments, mobility providers and urban planners to predict traffic patterns, gain accurate and real time street level insights, and reduce traffic congestion and optimize road conditions.

Location Intelligence

Enabling retailers, real-estate asset managers, financial services and advertisers to better understand customers' spatial behavior (where do people come from, how long they spent in each location, popular times and more associated with each POI), identify best locations for business and optimize operations.

Parking

Find parking place: Parking applications leverage vehicle data to optimize on and off-street parking vacancies. These services help drivers locate available parking spots on the street or in parking lots and reduce city congestion. Data is also used to better estimate parking lots availability
Automated parking payments: Parking apps which allow seamless payment for parking services for consumers and fleets

Media & Advertisment

Media data from entertainment systems is used to improve and personalize out of home advertising in public areas including roadside advertisements.

Navigation & Mapping

Help commercial organizations, municipalities and state agencies to build and update SD and HD maps. Vehicle data is also used to provide real time traffic data feeds and analysis. Other applications can include sensor-based analysis of right of way for utility companies surveying sites for installation of items such as transmission lines.

Financial Services

Financial organizations such as Hedge Funds employ various alternative data sources to obtain advantages in choosing investment opportunities. Vehicle data can be used as alternative data used to provide unique insights on, for example, customer traffic to and from shopping centers and commercial businesses and the amount of time spent there in order to evaluate the performance of those businesses.

Automotive Parts Improvements

Tier1 and Tier2 automotive parts vendors use vehicle data to assess their manufactured parts and components performance and improve their product development processes.

Media Research & Ratings

Audience measurements help advertisers and advertising agencies measure radio listening habits and generate radio ratings for commercial, media spend optimization and content production.

Weather

Organizations and companies performing weather research and weather prediction collect weather related information such as temperature, pressure, and precipitation to build more accurate weather maps and predictions.

Smart city

ities and organizations that operate smart city infrastructures require vehicle data to obtain insights such as dangerous road assessment, emergency and roadside assistance, as well as to analyze road and traffic management issues. It can also be used to identify, react and investigate car accidents faster, and real-time alerts on road hazard conditions.

Fleet Management

Vehicle data is used by fleet owners to perform benchmarking and comparison research on their own fleet performance compared to benchmarks. On the personal case, fleet data is used to provide driver-specific fleet services such as routing and automated parking payments.

Step #3 - Choose Required Attributes

In this step, you will choose the required attributes for your service.
The attribute screen has two columns: filters column on the left and attribute list on the right.

By default, the filter column will be set to "All", and therefore all the available attributes will be listed.
Once you choose an attribute, it will be marked with a blue checkmark and you will be able to set the attribute as a Mandatory attribute.

What are Mandatory attributes?
When you mark an attribute as Mandatory, it means that any data that will be received by the service will have a valid, non-empty result for that attribute.
If for any reason, a data point from a vehicle is missing a mandatory attribute value, that point will not be included in the provided data/report.

By default, all the attributes are set to Optional. If you want to set an attribute as Mandatory, activate the toggle to the right of the attribute name.

Categories and Data Sets
Otonomo attributes are separated to different categories. Each attribute belongs only to a single category.

The list of available categories and their description can be found here: Attribute List

In addition, each attribute belongs to one or more data sets.
Data-set defines the type of data that the service will support.
There are 3 types of data-sets:

  • Points - Each data point in the generated file will describe a single time sample of the selected attributes
  • Trips - Each data point in the generated file will describe a single trip summary
  • Road Signs - Each data point in the generated file will describe a single road sign observation

Pick Default - By choosing the default attributes, the service will be assigned with the most commonly used attributes.
Once chosen, you can add/remove additional attributes to this list.

Step #4 - Using Your Service

Once finished with the service creation, the service will be available in "Test" mode until our staff has approved the service for production. Note that APIs cannot be used on service in test mode.

While waiting for approval, you will be given with a sample report for you to test with.
The sample report folder contains 2 type of reports with simulated data:

  1. Example_trip_report.csv - contains simulated data of vehicle trips
  2. Example_raw_data_points_reports.csv - contains simulated data of vehicle data points

For any additional questions or help, please contact us at [email protected]

Updated about a month ago


What's Next

Understand how to use our APIs to retrieve vehicles data

Aggregated Data APIs

Creating an Aggregate Service


Suggested Edits are limited on API Reference Pages

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