Traffic TPEG API Developer's Guide

Delta Updates

Delta updates reduce getmessages response size by sending only changed and new traffic events after the first request.

Delta Update calculation rules

The following rules are used for Delta Update calculation:
  • When successive intersecting Proximity only or Corridor only searches are requested the last result will have items from all previous requests filtered out.

    Figure 1. Calculating Delta Update for same type search

    Scenario: user requests traffic for the first Proximity area (Prox #1) and gets all events (no Delta at this point). Then user requests traffic for the second Proximity area (Prox #2), which is intersecting with first area, and gets only Delta Update as events from intersecting area were filtered out. Then user requests traffic for the third Proximity area (Prox #3), which is intersecting with both previously used areas, and gets only Delta Update as events from both intersecting areas were filtered out. Same logic applies for sequential corridor search.

  • When successive intersecting searches are requested with changing type of search (Proximity-to-Corridor-to-Proximity or Corridor-to-Proximity-to-Corridor) the last result will also have items from previous search of the same type filtered out.

    Figure 2. Calculating Delta Update for changed type search

    Scenario: user requests traffic for the first area (Prox #1) and gets all events (no Delta at this point). Then user requests traffic for Corridor area intersecting with first area (Corr #2) and gets only Delta Update as events from intersecting area were filtered out. Then user requests traffic again for Proximity area intersecting with both previously used areas (Prox #3) and gets only Delta Update as events from both intersecting areas were filtered out.

Delta Update response size sample

The following example shows the size difference when driving approximately 300km in Germany, doing first proximity search, and then using route corridor search for incidents and traffic flow during the drive.

Figure 3. Sizes of GetMessages response

The first getmessages request is for a 10km proximity search, subsequent getmessages requests are for route-corridor searches with waypoints for the whole route. A new getmessages request is sent every 2 minutes, from the position where the car would be located, for the remaining route.

In total 152 getmessages requests are sent, and as many responses returned by the TPEG service. The blue line shows the getmessages response size when delta updates are used. The graph also shows the size of the non-delta responses using compressed TrafficML (TML) and binary TPEG format.

Delta Update Thresholds

Traffic Event Compact (TEC): when any incident parameter changes, the incident is updated in the next getmessages response if the incident is still within the search area.

Delta for flow (TFP): Values of below parameters will be taken into consideration for threshold calculations. By default Traffic TPEG API uses units defined in the feeds.

Full Updates

Table 1. Attributes Used In Traffic Flow and Prediction with Delta detection
Parameter Threshold [units defined in the real time feeds]
Average Speed [SP]
5
Free Flow [FF]
5
Jam Factor [JF]
1
Confidence [CN]
0.1
Length of TMC (sub-segement) [LE]
0.001

To always recive full traffic updates instead of delta updates, set TimeOut=0 in the InitSession request. If TimeOut is greater than zero, the only way to get a full traffic update before that duration is to start a new session.