Sorry, you need to enable JavaScript to visit this website.

TomTom Traffic Incidents - Intermediate Service - Upcoming feature - Area messages

 

On this page

Scope

This document describes the upcoming feature "Area messages" and its implementation in TomTom Traffic Incidents – Intermediate Service – DATEX II and TomTom Traffic Incidents - Intermediate Service - Protobuf.

What is the Area Message feature?

Some events published by TomTom are better referred to as area locations, instead of stretch or point locations that are supported today. These events impact an area where particular warnings are applicable.

TomTom will publish area messages that have a direct relation to disaster and crisis situations. The current types of disasters and crises include:

  • Flooding - expressing disaster cases like hurricanes, levy breaks, major storms
  • Fire - expressing disaster cases like wildfires, major building fires
  • Terror incident - expressing disaster cases like bombings, mass shootings
  • Demonstration / March expressing mass demonstrations / marches
  • Public disturbance - expressing all other disasters and crises

The warnings issued as area message can be used to inform drivers and other user groups to raise awareness and enhance safe road usage.

  • Warn users of navigation applications in the map view
  • Warn users of navigation applications that (are about to) enter the impacted area
  • Warn users of navigation applications that are located inside the area

Area messages can be used for routing purposes, but TomTom advises to continue using the closure content in case the driver does not want or can avoid the whole area. The TomTom closure content aims to mimic the actual accessibility of the road. This provides value when users need to rely on escaping the area (i.e. evacuation routes).

▲ Return to top

How are Area Messages implemented in DATEX II and Protobuf?

Area messages use OpenLR to describe the affected area. TMC is not supported.

OpenLR supports area locations without holes *. For the upcoming use cases of area messages, there is no immediate need to support more complex area shapes. Most prospective suppliers of area messages also use simple polygons without holes.

* Definition OpenLR polygon: a polygon location is a non-intersecting shape defined by a sequence of geo-coordinate pairs. The coordinate pairs can be everywhere on the surface. They define the corners of the underlying geometrical polygon. The boundary of this polygon is constituted by straight lines between every pair of consecutive corners in the sequence, plus the straight line between the last and the first corner.

Data format Example
DATEX II
<situation [...]>
  [...]
  <situationRecord xsi:type="Activities" [...]>
    [...]
    <groupOfLocations>
      <locationContainedInGroup xsi:type="Area">
        <locationExtension>
          <openlr>
            <binary version="3">
              E6lPxhpo5gAAAAAfMwgmGAjuMP688+Xpw/tLxsUGzwtHEdMK3PoJ
            </binary>
          </openlr>
        </locationExtension>
      </locationContainedInGroup>
    </groupOfLocations>
    <situationRecordExtension>
      <alertCEventCode>1501</alertCEventCode>
      <alertCEventCode>1458</alertCEventCode>
    </situationRecordExtension>
    <publicEventType>majorEvent</publicEventType>
    <publicEventType>bicycleRace</publicEventType>
  </situationRecord>
</situation>

Protobuf

trafficIncidents {
  [...]
  location {
    type: AREA
    openlr: "\023\251O\306\032h\346\000\000\000\000\0373\b&\030\b\3560↵
             \376\274\363\345\351\303\373K\306\305\006\317\vG\021\323\n\334\372\t"
  event {
    alertCEventCode {
      mainEvent: 1501
      additionalEvents: 1458
    }
  }
}

▲ Return to top

Supported disaster types

Area messages use available and suitable Alert-C event codes and DATEX II classifications to express different types of disasters. The following Alert-C event codes are used:

  • Alert-C event code 907 (Flooding), expressing disaster cases like hurricanes, levy breaks, major storms
  • Alert-C event code 921 (Fire), expressing disaster cases like wildfires, major building fires
  • Alert-C event code 1478 (Terror incident), expressing disaster cases like bombings, mass shootings
  • Alert-C event code 1512 (Demonstration), expressing mass demonstrations
  • Alert-C event code 1513 (March), expressing protest marches
  • Alert-C event code 1514 (Public disturbance), expressing all other disasters

▲ Return to top

Test phase Area Messages

This test phase allows clients and TomTom moderators to experiment with the correct implementation of the area message feature. The TomTom moderation team will monitor disasters around the globe and experiment with the area message functionality during Q3-Q4 2020. This means that events classified as disaster by the TomTom moderation team will, next to the normal closure content, be covered as area message. During the test phase, the data consumption of the area messages is neglectable.

Currently there are no other data format extensions scheduled.

▲ Return to top