INRIX documentation logo

Overview

Dangerous Slowdowns, also referred to as DSD, is a product feature under the INRIX safety alerts umbrella and is intended to offer advance warning for where back-of-queue slowdowns exist to allow drivers to appropriately consider a potential safety event ahead of them. The product has been developed atop the rich traffic flow dataset that INRIX uses to produce segment level speeds.

INRIX takes real-time speeds from segment A, and the upstream segment B to determine if there is a greater than 15 mph delta suggesting a slowdown where drivers would need to take avoidance actions. Where a qualifying difference in speeds exists a DSD is placed at the upstream end of segment A. DSDs are assigned a severity based on the difference in miles per hour from segment B to segment A (segment = XDS or INRIX XD Segment).

Not all areas of congestion will produce a DSD. If there is a queue where speeds gradually slow over multiple segments this may not trigger the >15 mph minimum threshold between segments and therefore may not trigger the creation of a DSD. In this way DSD differ from Congestion Alerts. DSD are intended to describe a point in space where severe braking occurs. DSD generation is dependent on real-time data densities and therefore the prevalence of DSD may differ by geographic area, time of day, and day of week

Q and A on Dangerous Slowdowns:

Q: Are Dangerous Slowdowns based on real-time data?
A: Yes. DSD are calculated based on real time data from multiple segments where the speed delta between a target segment and the upstream (XDS) segment is considered. A DSD is created when the speed delta from the two segments is greater than 15 MPH. If a DSD is expected but INRIX has not created an alert it may be due to trigger thresholds not being met (>15MPH), or because insufficient real-time data was present to conclude the rapidity of the slowdown

Q: Are the alerts filterable by severity?
A: Yes, each DSD is assigned a severity based on the nature of the slowdown at the end of the queue; the severity rating is based on the speed difference between segments

Q: Where are DSD published?
A: On all limited access roadways.

Q: How long do DSD last?
A: Depends on the data that that the platform has available at the time. DSD can be ephemeral (1 minute) or persist for an hour. It just depends on what data we have available to consider for DSD calculation, and whether that data tips the thresholds we set.

Q: What does the DSD output look like?
A: Suggestion is that you review the documentation at docs.inrix.com. For a quick reference there is sample output to the left (output fields may change in the future as we move toward V2 of this product)

Q: Is the DSD feature included in the INRIX Mobile SDK?
A: Yes. For access to the Mobile SDK please discuss with INRIX sales engineers

Q: Is this an INRIX XD-only product?
A: Currently, yes.

Q: How often are DSDs calculated?
A: Once per minute

Q: Is there documentation for DSD?
A: Yes. The docs.inrix.com has onboarding documentation. Additional assistance can be provided by INRIX sales engineers.

Q: What are the severity thresholds for DSD? (can be toggled on Demo)
A: (1)15-25mph; (2)25-35mph; (3)35- 45mph; (4)45-60mph; (5)>60mph [speed drop between segment B, and the downstream segment A]

Q: Does INRIX populate mile marker data?
A: Currently there is a placeholder for mile marker data which may be populated in the future. There is no unified reference of mile marker data for most countries and therefore additional work would be required to fulfill delivery of mile marker values. Please discuss this need with INRIX sales engineering staff


Description: Gets Dangerous Slowdown incidents in a specified region.

dsd-api.inrix.com/v1/DangerousSlowdowns

GET Gets Dangerous Slowdown incidents in a specified region.

Parameters

  = required
Name Located In Type Description
accesstoken Query String A valid access token provided from the GET appToken API response. Alternatively, the accesstoken can be added to the request header instead of a url parameter using format 'Authorization: Bearer xxxx.xxx.xxxx'.
box Query String “box” specifies two latitude and longitude pairs (using the WGS 84 datum) that outline a bounding box. The first lat/long pair should be the northwestern most point, and the second pair the southeastern most point. Format- [lat1]|[long1],[lat2]|[long2]. Either box or point and radius parameters are required.
point Query String Used to select a region based on a point and radius. If used, other Location parameters cannot be used. Format- [lat]|[long]. Either box or point and radius or geoId parameters are required.
radius Query Double Used to select a region based on a point and radius in meters. If used, other Location parameters cannot be used. Either box or point and radius or geoId parameters are required.
geoId Query Integer Used to select a region based on a geography. “geoid” specifies the ID of the specified geography. For more information on how to obtain the ID, see GetGeography. When using a custom GeoId (previously created with CreateGeography), the first call will create cached files. Once these have been created the call will return the correct information. Using Geographies with a large area (e.g. countries) is not recommended. Either box or point and radius or geoId parameters are required.
units Query Integer Use 0 for English units, 1 for metric. Default is 0.

Requests

Example Get dangerous slowdowns in a box request
Query
https://dsd-api.inrix.com/v1/DangerousSlowdowns?box=47.77577|-122.207249,47.743362|-122.16227&units=1&accesstoken={token}

Responses

200 Success
{
  "copyright": "Copyright INRIX Inc. 2016",
  "versionNumber": "v1",
  "createdDate": "2016-11-10T00:17:45.4714315Z",
  "responseId": "2e492ce9-0383-42bf-90a0-01f46c6e4dde",
  "result": {
    "dangerousSlowdowns": {
      "dangerousSlowdown": {
        "id": "8341848|3559026",
        "version": 2,
        "severity": 3,
        "speedBefore": 51,
        "speedAt": 12,
        "speedDelta": 39,
        "location": {
            "position": {
                "latitude": 47.6429328918457,
                "longitude": -122.31671905517578
            },
            "segment": {
                "type": "XDS",
                "code": "3559026",
                "offset": 0
            },
        },
        "schedule": {
            "occurrenceStartTimeUTC": "2016-11-10T22:48:39.8953224Z"
        },
        "description": {
            "roadName": "I-405 N",
            "direction": 0,
            "mileMarker": ""
        }
      }
    }
  }
}

Response Elements

Property Type Description
dangerousSlowdowns Array A container for DangerousSlowdown elements
Property Type Description
dangerousSlowdown Array A single Dangerous Slowdown ID
country String The country the Dangerous Slowdown is in.
Property Type Description
description Array The road name, direction and mile marker information.
Property Type Description
roadname String The name of the road in the local language.
direction Integer The directionality of the road- 0 = Unknown, 1 = Northbound, 2 = Southbound, 3 = Eastbound, 4 = Westbound, 5 = Clockwise, 6 = Counter-clockwise
mileMarker String The highway mile marker closest to the Dangerous Slowdown.
id String The unique identifier associated with the Dangerous Slowdown. The same ID value will be associated with the Dangerous Slowdown while it stays in the same location on the road. If it moves to the start of another XD segment the ID will change.
version String The version of the Dangerous Slowdown report.
severity Integer The severity of the Dangerous Slowdown. This value can be in the range of 1-5, with 5 indicating the highest severity. 1 – Minimal impact (15-25 mph speed delta), 2 – Low impact (25-35 mph speed delta), 3 – Moderate impact (35-45 mph speed delta), 4 – High impact (45-60 mph speed delta), 5 – Severe impact (more than 60 mph speed delta)
speedBefore String The speed leading up to the Dangerous Slowdown. Values are in mph or km/h depending upon the input “Units” value.
speedAt String The speed at the Dangerous Slowdown. Values are in mph or km/h depending upon the input “Units” value.
speedDelta String speedAt – speedBefore (i.e. if speedAt = 96km/h and speedBefore = 56km/h then speedDelta = 40km/h). Values are in mph or km/h depending upon the input “Units” value.
location Array The location and segment of the Dangerous Slowdown
Property Type Description
geometry Geojson The Dangerous Slowdown location defined as a longitude, latitude tuple. The location “coordinates” must be in this order. Locations will be provided in GeoJSON in JSON payloads.
segment Array The XD segment and offset showing the location of the Dangerous Slowdown. The Offset value will always be zero as the Dangerous Slowdown will be shown between two segments.
schedule Array The time the Dangerous Slowdown was first reported.
Property Type Description
occurrenceStartTime String UTC time when the incident began.