Road Signs Data Set Tutorial

Otonomo provides access to road signs data.

Overview

Otonomo provides access to road signs data which are collected using ADAS component within vehicles.
This document provides information on how to obtain access to road signs data.

The data collected includes the following information: road sign type, GPS location, location relative to the car, attitude, start/end of condition and more.

Step #1 - Generate a Workspace Access Token

A Workspace access token allows you to request road sign data from our APIs.
The access token is based on the protocol OAuth 2.0 and is used for authorization.

To retrieve the token, use the following API: Service Access Token

Once retrieved, the access token is valid for 24 hours.
After 24 hours, a new access token should be generated

curl -X POST \
  https://consent.otonomo.io/v1/oauth/token/ \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'client_id=thisismyclientID&client_secret=thisismyclientsecret&grant_type=client_credentials&service=myservicename'
{
    "token_type": "Bearer",
    "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwczovL290b25vbW8uaW8vY29uc3VtZXJfbmFtZSI6IsdfsdfsfsdfsGDDp84He7ITKaxCoZFspminDgGImyUPQfe-nRV3kmoPQURutjPwNXcEPPqQ_lL_Kcy_nsYb1J4hPz7ZDsoSKUHJe_8LaoPpz-uawPacgNfO2XSciXNNfo_uw7C84Vq36Mt9JEs8sUQvKHY5saQbAmGlNf9oKQj6g772gaHWILalwnonzchE0JN92dFcG2fVHco71XaevSv3Ne8OD59fco_VNVOtdxWusdWllYopCWxxWUIdsEM4PASFuKry3yNvqqKBdsfsdfRGfvxmlvZiO5zmpoMGMQSG2aEKQ",
    "expires_in": 3600
}

Step #2 - Generate Road Sign Report

Now that you have retrieved an access token, you can continue to the next step, which is generating a road sign report.

To generate a road sign data report, use the following API: Road Sign
You can filter the results based on country, state, city, polygon and sign types.
The available sign types are listed at the end of this article

Below is a description of the request parameters:

Parameter name

Description

Required

start_datetime

The start date and time of the report (YYYY-MM-DD HH:MM:SS)

V

end_datetime

The start date and time of the report (YYYY-MM-DD HH:MM:SS)

V

sign_types

Comma separated list of required filters. Click here for a list of the available filters

country_codes

Comma separated strings of 2-or-3 lettered country codes.

polygon

Either WKT format polygon or a list of lists comprised of dictionaries representing each point (lon, lat) in a polygon. The report includes any sign that was located within the polygon

cities

Comma separated strings of city names. The report includes any sign that was located in the listed cities

states

Comma separated strings of state names. The report includes any sign that was located in the listed states

Here is a code example of the request:

curl -X POST \
  https://api.otonomo.io/v1/aggregate/reports/HistoricalRoadSignsData \
  -H 'Authorization: Bearer {Service Token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "start_datetime": "2019-11-18 10:00:00",
    "end_datetime": "2019-11-18 11:00:00"
      }'
{
    "report_status": "Pending",
    "request_id": 8689
}

For more examples, visit the API reference page - Road Sign

Step #3 - Download the report

Once a report generation request has been made, you will need to wait for the report to be ready.
This is can be done by going to the reports tab in our platform or by using the Request Report Status API.

Once the report status is set to "Completed" you be able to download the report via the platform UI or by using the download URL provided in the Request Report Status response.

Download the report via API:

curl -X GET \  https://api.otonomo.io/v1/aggregate/reports/requests/8689 \
  -H 'Authorization: Bearer eyJheNNVeXSVToSRGfvxmlvZiO5zmpoMGMQSG2aEKQ' \
{
    "report": "HistoricalRoadSignsData",
    "status": "Completed",
    "id": 8689,
    "result_url_list": {
        "part-00000-7affb391--1f86755459b7-c000.csv": {
            "url": "https://prod-otonomo-reports.s3-accelerate.amazonaws.com/8689/part-00000-7affb391-8dce55459b7-c000.csv?response-content-disposition=attachment%3B%20filename%20Fpart-00000-7affb391-8dce-48de-a8fd-1f86755459b7-c000_20191118T110000Z.csv&Expires=1576688007&Signature=%2FFYLBqCTY5vccsA8nKaa8kd%2FEmA%3D",
            "size": 23696724
        }
    }
}

📘

Need help? Have a question?
Feel free to contact us at [email protected]

Available filters

Here is a list of available filters:

  • Speed Limit
  • Passing Restriction
  • Derestriction
  • Stop
  • Yield
  • Town
  • Motorway
  • Motor Road
  • Priority Road
  • Environmental Zone
  • Residential Area
  • General Withdrawal
  • Withdrawal Speed Limit 2 Digits
  • Withdrawal Speed Limit 3 Digits
  • Mandatory Passing Left
  • Mandatory Passing Right
  • Mandatory Passing Straight
  • Roundabout
  • No Entry
  • Vehicles Prohibited
  • End Of Motorway
  • Start Of Expressway
  • End Of Expressway
  • Start Of Traffic Calming Zone
  • End Of Traffic Calming Zone
  • Yield
  • End Of Priority Road
  • Bend Left
  • Bend Right
  • Double Bend First To Left
  • Double Bend First To Right
  • Road Narrow On Both Sides
  • Road Narrow On Left Side
  • Road Narrow On Right Side
  • Cross Road
  • Cross Road Small Road
  • Road From Left Degree
  • Road From Right Degree
  • One Bump
  • Two Bump
  • Concave
  • Traffic Jam
  • Road Works
  • Right Downwards
  • Right Upwards
  • Traffic Light
  • Animal Crossing
  • Children
  • Snow
  • Slippery Road
  • Give Way Roundabout
  • Wind From Side
  • Pedestrian Crossing
  • Bicycle Crossing
  • Train Cross Without Barrier
  • Train Cross With Barrier
  • Gravel
  • Two Way Traffic
  • Start Of City Limit
  • End Of City Limit
  • Start End Of City Limit
  • End Of Environmental Zone

Did this page help you?