Traffic API Developer's Guide

Requesting Traffic Incident Data

The following GET request obtains traffic incident data for an area around Frankfurt, Germany .

https://traffic.cit.api.here.com/traffic/6.2/incidents/xml/8/134/86
  ?app_id={YOUR_APP_ID}
  &app_code={YOUR_APP_CODE}
The response to the above request contains the following high-level elements:
  • a timestamp of the obtained traffic data
  • an array of <TRAFFIC_ITEM> elements that contain the incident location, time, duration, severity, description and other details
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<TRAFFICML_INCIDENTS TIMESTAMP="03/17/2017 09:48:27" TIMESTAMP2="2017-03-17T09:48:27Z" EXTENDED_COUNTRY_CODE="E0">
  <TRAFFIC_ITEMS>
    <TRAFFIC_ITEM mid="10831636_original">
      <TRAFFIC_ITEM_ID>881739768227194517</TRAFFIC_ITEM_ID>
      <ORIGINAL_TRAFFIC_ITEM_ID>3795526337806050757</ORIGINAL_TRAFFIC_ITEM_ID>
      <TRAFFIC_ITEM_STATUS_SHORT_DESC>ACTIVE</TRAFFIC_ITEM_STATUS_SHORT_DESC>
      <TRAFFIC_ITEM_TYPE_DESC>CONSTRUCTION</TRAFFIC_ITEM_TYPE_DESC>
      <START_TIME>01/13/2017 09:03:03</START_TIME>
      <END_TIME>12/31/2017 22:59:53</END_TIME>
      <ENTRY_TIME>03/14/2017 17:04:00</ENTRY_TIME>
      <CRITICALITY>
        <ID>0</ID>
        <DESCRIPTION>critical</DESCRIPTION>
      </CRITICALITY>
      <VERIFIED>true</VERIFIED>
      <ABBREVIATION>
        <SHORT_DESC>CONST</SHORT_DESC>
        <DESCRIPTION>construction</DESCRIPTION>
      </ABBREVIATION>
      <COMMENTS>B26, Schweinfurt - Aschaffenburg in beiden Richtungen, zwischen Anschlussstelle Hösbach und Anschlussstelle Goldbach, wegen Baustelle gesperrt, eine Umleitung ist eingerichtet, bis 31.12.2017</COMMENTS>
      <RDS-TMC_LOCATIONS>
        <RDS-TMC>
          <ORIGIN>
            <EBU_COUNTRY_CODE>D</EBU_COUNTRY_CODE>
            <TABLE_ID>1</TABLE_ID>
            <LOCATION_ID>22235</LOCATION_ID>
            <LOCATION_DESC>Laufach</LOCATION_DESC>
            <RDS_DIRECTION>+</RDS_DIRECTION>
          </ORIGIN>
          <TO>
            <EBU_COUNTRY_CODE>D</EBU_COUNTRY_CODE>
            <TABLE_ID>1</TABLE_ID>
            <LOCATION_ID>22234</LOCATION_ID>
            <LOCATION_DESC>Goldbach</LOCATION_DESC>
            <RDS_DIRECTION>+</RDS_DIRECTION>
          </TO>
          <DIRECTION>-</DIRECTION>
          <ALERTC>
            <TRAFFIC_CODE>735</TRAFFIC_CODE>
            <QUANTIFIERS>0</QUANTIFIERS>
            <DESCRIPTION>Wegen Baustelle gesperrt.</DESCRIPTION>
            <ALERTC_DURATION>L</ALERTC_DURATION>
            <ALERTC_DIRECTION>1</ALERTC_DIRECTION>
            <URGENCY>U</URGENCY>
            <UPDATE_CLASS>5</UPDATE_CLASS>
            <PHRASE_CODE>E1.C1</PHRASE_CODE>
            <EXTENT>1</EXTENT>
            <DURATION>0</DURATION>
          </ALERTC>
          <PRIMARY_OFFSET>0.96933</PRIMARY_OFFSET>
          <LENGTH>1.69523</LENGTH>
        </RDS-TMC>
      </RDS-TMC_LOCATIONS>
      <LOCATION>
        <DEFINED>
          <ORIGIN>
            <ROADWAY ID="50280">
              <DESCRIPTION TYPE="NTCSA">B26</DESCRIPTION>
              <DESCRIPTION TYPE="RDSGN">B26</DESCRIPTION>
              <DESCRIPTION TYPE="LOCAL">B26</DESCRIPTION>
            </ROADWAY>
            <POINT ID="22235">
              <DESCRIPTION TYPE="NTCSA">Laufach</DESCRIPTION>
              <DESCRIPTION TYPE="RDSGN">Laufach</DESCRIPTION>
              <DESCRIPTION TYPE="LOCAL">Laufach</DESCRIPTION>
              <DESCRIPTION TYPE="BNAME">B26</DESCRIPTION>
            </POINT>
            <DIRECTION ID="0">
              <DESCRIPTION TYPE="LOCAL">ASCHAFFENBURG</DESCRIPTION>
              <DESCRIPTION TYPE="NTCSA">ASCHAFFENBURG</DESCRIPTION>
              <DESCRIPTION TYPE="RDSGN">ASCHAFFENBURG</DESCRIPTION>
            </DIRECTION>
            <PROXIMITY>
              <ID>AT</ID>
              <DESCRIPTION>at</DESCRIPTION>
            </PROXIMITY>
          </ORIGIN>
          <TO>
            <ROADWAY ID="50280">
              <DESCRIPTION TYPE="NTCSA">B26</DESCRIPTION>
              <DESCRIPTION TYPE="RDSGN">B26</DESCRIPTION>
              <DESCRIPTION TYPE="LOCAL">B26</DESCRIPTION>
            </ROADWAY>
            <POINT ID="22234">
              <DESCRIPTION TYPE="NTCSA">Goldbach</DESCRIPTION>
              <DESCRIPTION TYPE="RDSGN">Goldbach</DESCRIPTION>
              <DESCRIPTION TYPE="LOCAL">Goldbach</DESCRIPTION>
              <DESCRIPTION TYPE="BNAME">B26</DESCRIPTION>
            </POINT>
            <DIRECTION ID="0">
              <DESCRIPTION TYPE="LOCAL">ASCHAFFENBURG</DESCRIPTION>
              <DESCRIPTION TYPE="NTCSA">ASCHAFFENBURG</DESCRIPTION>
              <DESCRIPTION TYPE="RDSGN">ASCHAFFENBURG</DESCRIPTION>
            </DIRECTION>
            <PROXIMITY>
              <ID>AT</ID>
              <DESCRIPTION>at</DESCRIPTION>
            </PROXIMITY>
          </TO>
        </DEFINED>
        <GEOLOC>
          <ORIGIN>
            <LATITUDE>50.005303</LATITUDE>
            <LONGITUDE>9.225782</LONGITUDE>
          </ORIGIN>
          <TO>
            <LATITUDE>49.998172</LATITUDE>
            <LONGITUDE>9.194162</LONGITUDE>
          </TO>
        </GEOLOC>
        <NAVTECH>
          <EDGE>
            <EDGE_ID>1063970961</EDGE_ID>
            <EDGE_ID>...</EDGE_ID>
            <EDGE_ID>791234963</EDGE_ID>
          </EDGE>
          <VERSION_ID>201701</VERSION_ID>
        </NAVTECH>
      </LOCATION>
      <TRAFFIC_ITEM_DETAIL>
        <ROAD_CLOSED>true</ROAD_CLOSED>
        <EVENT>
          <EVENT_ITEM_CANCELLED>false</EVENT_ITEM_CANCELLED>
          <SCHEDULED_CONSTRUCTION_EVENT>
            <SCHEDULED_CONSTRUCTION_TYPE_DESC>CONSTRUCTION</SCHEDULED_CONSTRUCTION_TYPE_DESC>
            <SCHEDULED_CONSTRUCTION_DETAIL>construction</SCHEDULED_CONSTRUCTION_DETAIL>
          </SCHEDULED_CONSTRUCTION_EVENT>
        </EVENT>
      </TRAFFIC_ITEM_DETAIL>
      <TRAFFIC_ITEM_DESCRIPTION TYPE="short_desc">Geschlossen zwischen Laufach und Goldbach - Wegen Baustelle gesperrt. eine Umleitung ist eingerichtet.</TRAFFIC_ITEM_DESCRIPTION>
      <TRAFFIC_ITEM_DESCRIPTION TYPE="desc">Geschlossen zwischen Laufach und Goldbach - Wegen Baustelle gesperrt. eine Umleitung ist eingerichtet. B26, Schweinfurt - Aschaffenburg in beiden Richtungen, zwischen Anschlussstelle Hösbach und Anschlussstelle Goldbach, wegen Baustelle gesperrt, eine Umleitung ist eingerichtet, bis 31.12.2017</TRAFFIC_ITEM_DESCRIPTION>
      <TRAFFIC_ITEM_DESCRIPTION TYPE="no_exit_description">Wegen Baustelle gesperrt. eine Umleitung ist eingerichtet. B26, Schweinfurt - Aschaffenburg in beiden Richtungen, zwischen Anschlussstelle Hösbach und Anschlussstelle Goldbach, wegen Baustelle gesperrt, eine Umleitung ist eingerichtet, bis 31.12.2017</TRAFFIC_ITEM_DESCRIPTION>
    </TRAFFIC_ITEM>
    <TRAFFIC_ITEM mid="13510316">...
    </TRAFFIC_ITEM>
    ...
  </TRAFFIC_ITEMS>
</TRAFFICML_INCIDENTS>