otonomo-docs

Test Drive Vehicle Data from Otonomo

Our connected car data is now accessible for developers

Aggregated Data APIs

There are several report types a user can consume data from. The Historical Data requests are asynchronous and are generated in the background. The output of the request depends on the type of data selected as the format varies.

The two types of historical data available:

Raw Data: data is displayed via a point by point view of a vehicle’s drive. Each row represents a single point, while each column represents an attribute from your bundle. The attributes are determined based on the bundle associated with your specific service.

Trips: data is aggregated and displays a summarized view of an entire vehicle’s drive (trip). Each row represents a single trip, while each column represents an attribute. The attributes are determined based on the bundle associated with your specific service.

Every report displays data based on the attributes and enrichments associated with your Service. Additionally, every report is based on the vehicle limit you’ve selected for your Service.

The type of historical data available to you and the exact content within each CSV depends on the data bundle associated with your Service.

The following table summarizes all available historical data APIs.

API

Request Type

Time Frame

Description

Raw Data

Vehicle Data

Up to 1 month

Provides data points from all the vehicles associated with a specific service.

Aggregated Trips Data

Aggregated Vehicle Data

Up to 1 month

Provides aggregated data on the various trips vehicles have driven.

Trip Points

Vehicle Data

Length of trip

Provides data points from a specific trip a vehicle has driven.

In order to ensure standardisation, the time zone used is the Coordinated Universal Time or UTC. If, for example, you are located in the Pacific Time Zone (GMT-8), you would add 8 hours to calculate the corresponding Coordinated Universal Time.

How many requests may be executed per day?
By default, you may execute up to a total of 10 requests for each application per day (UTC time).

To access the report, run the Report Status API. The output presented in the response body will be a downloadable link to a CSV file of up to 1 GB. If the data comprised in the report should be larger than 1 GB, a new CSV file will be generated.

What is the duration for which the report is downloadable?
Reports are available for download for 30 days.

Updated 10 months ago

Aggregated Data APIs


Suggested Edits are limited on API Reference Pages

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