ℹ️Covered in this guide
What is it all about?
EV Transition Potential Assessment Details
EV Transition API
Related Recipe

What is this all about?

Our Data Augmentation API can deliver, for every single location of a trip, the whole context of road characteristics and quality, road topology and limitations, traffic signals, and weather information, to name only some.

In order to augment trip data, the following details are needed: timestamp, latitude, longitude, speed, and heading. Locations on a trip are first map-matched, and several layers of information are requested to our partnered services, including premium map databases and accurate weather services. As our customer, you can request augmented data for any trip, worldwide, in a real-time or historical manner.

Contextual Data Analytics On Trip Level

Name	Description
speedlimit/cars	Get speed limit for cars per location. Depending on the query parameters, you can include dates and locations.
speedlimit/trucks	Get speed limit for trucks per location. Depending on the query parameters, you can include dates and locations.
road	Get road information per location: local date and time, longitude, latitude, slope, curvature, road roughness (IRI), radius
locations/matched	Get matched locations for a trip. Depending on the query parameters, you can include dates.
illegal_actions	Get illegal actions per location: illegal turn, illegal U-turn, illegal direction
illegal_actions/turn	Get illegal turn actions per location
illegal_actions/u_turn	Get illegal U-turn actions per location
illegal_actions/direction	Get illegal direction actions per location
weather	Get weather along a trip: date and time, cloud, sunset and sunrise time, humidity, pressure, sky info, dew point, gust speed, heat index, total snow, visibility, wind speed, wind degree, wind direction, wind chill temperature, temperature, perceived temperature, precipitation
possible_speed	Get possible speed for a location
road_type	Get road type for a location: rural, urban, or motorway
road_elements	Get road elements for a location: ramp, bridge, roundabout, intersection, or tunnel
pois	Get points of interest along the route, e.g., restaurants, charging station, parking, etc.

Contextual Data Analytics For Fleet, Device, Or Driver Depending On The Query Parameters

Name	Description
orig_dest	Get a list of start/end locations of the trips
summary	Get context summary for fleet, driver, device, or trip depending on the query parameters. Default time window is from 14 days ago until the present time. 'from_datetime' overrides 'days'. See extended examples below.
gforce	Get minimum, maximum, and average g-force
illegal_driver_actions	Get total illegal actions
start_time/dist	Get start time distribution of trips
distance_travelled	Get spatial repartition (road quality distance, weather distance, road type distance)

Example: Context Summary

https://api.motion-s.com/analytics/context/v1/summary

[
  {
    "elapsed_time": 65744,
    "distance": 870,
    "number_of_locations": 65229,
    "number_of_trips": 62,
    "countries_visited": [
      "Luxembourg",
      "France"
    ],
    "average_speed": 50,
    "max_speed": 160,
    "average_roughness": 3.6,
    "average_slope": 0.8,
    "average_traffic_speed": 42,
    "road_rural_distance": 424,
    "road_urban_distance": 333,
    "road_motorway_distance": 113,
    "peak_morning_distance": 233,
    "peak_afternoon_distance": 345,
    "road_quality_distance_good": 177,
    "road_quality_distance_fair": 307,
    "road_quality_distance_poor": 123,
    "weather_distance_clear": 220,
    "weather_distance_cloudy": 383,
    "weather_distance_fog": 89,
    "weather_distance_rain": 69,
    "weather_distance_snow_or_ice": 108,
    "average_IRI": 3.6
  }
]

Maps & Context API

Check our reference to see our endpoints: Maps and Context

Related Recipe

🦉

Contextual Data

Open Recipe