Traffic API Developer's Guide

Subset of Incident Data

The user wants to obtain traffic incident information near Frankfurt am Main, Germany, .

Note: Instead of using the the bounding box area (bbox), you can use proximity (prox) or corridor (corridor)

Request

The negBBox parameter restricts the response to an area outside of the specified bounding box and the maxresults parameter restricts the response to 50 incidents.

https://traffic.api.here.com/traffic/6.3/incidents.xml?bbox=48.8379,8.4375;50.7364,9.84375
&app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&negBBox=37.5000,126.9700;37.4900,126.9800
&status=active
&maxresults=50

Response

The response to the request contains a list of the following:
  • TRAFFIC_ITEM: traffic incident information about one active incident
<TRAFFICML_INCIDENTS TIMESTAMP="05/30/2018 14:56:35 GMT" VERSION="2.4" TIMESTAMP2="2018-05-30T14:56:35Z" EXTENDED_COUNTRY_CODE="E0">
   <TRAFFIC_ITEMS>
    <TRAFFIC_ITEM mid="NAVTEQ/r_NAVTEQ/10970603_TIC/NAVTEQ_reverse|1527688823543" PRODUCT="basic">
     <TRAFFIC_ITEM_ID>999406858448086191</TRAFFIC_ITEM_ID>
     <ORIGINAL_TRAFFIC_ITEM_ID>999406858448086191</ORIGINAL_TRAFFIC_ITEM_ID>
     <TRAFFIC_ITEM_STATUS_SHORT_DESC>ACTIVE</TRAFFIC_ITEM_STATUS_SHORT_DESC>
     <TRAFFIC_ITEM_TYPE_DESC>ROAD HAZARD</TRAFFIC_ITEM_TYPE_DESC>
     <START_TIME>05/30/2018 14:00:59</START_TIME>
     <END_TIME>05/30/2018 20:00:59</END_TIME>
     <ENTRY_TIME>05/30/2018 14:00:59</ENTRY_TIME>
     <CRITICALITY>
      <ID>1</ID>
      <DESCRIPTION>major</DESCRIPTION>
     </CRITICALITY>
     <VERIFIED>true</VERIFIED>
     <ABBREVIATION>
      <SHORT_DESC>HAZRD</SHORT_DESC>
      <DESCRIPTION />
     </ABBREVIATION>
     <LOCATION>
      <INTERSECTION>
         <ORIGIN>
          <ID />
          <STREET1>
           <ADDRESS1>Radmühler Straße</ADDRESS1>
          </STREET1>
          <STREET2>
           <ADDRESS1>In der Ecke</ADDRESS1>
          </STREET2>
          <COUNTY>Freiensteinau</COUNTY>
          <STATE />
          <PROXIMITY>
           <ID>MID</ID>
           <DESCRIPTION>midway between</DESCRIPTION>
          </PROXIMITY>
         </ORIGIN>
         <TO>
          <ID />
          <STREET1>
           <ADDRESS1>An den Eichen</ADDRESS1>
          </STREET1>
          <STREET2>
           <ADDRESS1>Götzenweg</ADDRESS1>
          </STREET2>
          <COUNTY>Freiensteinau</COUNTY>
          <STATE />
          <PROXIMITY>
           <ID>MID</ID>
           <DESCRIPTION>midway between</DESCRIPTION>
          </PROXIMITY>
         </TO>
      </INTERSECTION>
      <GEOLOC>
         <ORIGIN>
          <LATITUDE>50.42707</LATITUDE>
          <LONGITUDE>9.36602</LONGITUDE>
         </ORIGIN>
         <TO>
          <LATITUDE>50.42799</LATITUDE>
          <LONGITUDE>9.36643</LONGITUDE>
         </TO>
         <GEOMETRY>
          <SHAPES>
           <SHP FC="4" LE="72.88919031610381" FW="SD">50.42707,9.36602 50.42742,9.36622 50.42759,9.36631 50.42769,9.36635</SHP>
           <SHP FC="4" LE="33.8870884215311" FW="SD">50.42769,9.36635 50.4278,9.36639 50.42799,9.36643</SHP>
           <SHP FC="5" LE="105.48338684708" FW="SD">50.42799,9.36643 50.42801,9.36618 50.42807,9.36592 50.42822,9.36562 50.42849,9.36523</SHP>
          </SHAPES>
         </GEOMETRY>
      </GEOLOC>
      <TPEGOpenLRBase64>CCkBEAAlJAapCCPb+AAJBQQDAw4ACgUEBIFUAP+xAI4ACQUEBANcADAAAA==</TPEGOpenLRBase64>
      <POLITICAL_BOUNDARY>
         <METRO_AREA ID="218" />
         <COUNTY>Freiensteinau</COUNTY>
      </POLITICAL_BOUNDARY>
      <NAVTECH>
         <EDGE>
          <EDGE_ID>62126383</EDGE_ID>
          <EDGE_ID>62126384</EDGE_ID>
          <EDGE_ID>62126366</EDGE_ID>
         </EDGE>
         <VERSION_ID>201802</VERSION_ID>
      </NAVTECH>
      <LENGTH>0.13048</LENGTH>
     </LOCATION>
     <TRAFFIC_ITEM_DETAIL>
      <ROAD_CLOSED>false</ROAD_CLOSED>
      <INCIDENT>
         <RESPONSE_VEHICLES>false</RESPONSE_VEHICLES>
         <ROAD_HAZARD_INCIDENT>
          <ROAD_HAZARD_TYPE_DESC />
         </ROAD_HAZARD_INCIDENT>
      </INCIDENT>
      <ALERTC>
         <EVENT_CODE>520</EVENT_CODE>
      </ALERTC>
      <ALERTC>
         <EVENT_CODE>214</EVENT_CODE>
      </ALERTC>
      <ALERTC>
         <EVENT_CODE>803</EVENT_CODE>
      </ALERTC>
     </TRAFFIC_ITEM_DETAIL>
     <TRAFFIC_ITEM_DESCRIPTION TYPE="short_desc">Zwischen In der Ecke und Götzenweg - Verkehrsbehinderung. Bauarbeiten auf Abschnitt. Fahrstreifen blockiert.</TRAFFIC_ITEM_DESCRIPTION>
     <TRAFFIC_ITEM_DESCRIPTION TYPE="desc">Zwischen In der Ecke und Götzenweg - Verkehrsbehinderung. Bauarbeiten auf Abschnitt. Fahrstreifen blockiert.</TRAFFIC_ITEM_DESCRIPTION>
     <TRAFFIC_ITEM_DESCRIPTION TYPE="no_exit_description">Verkehrsbehinderung. Bauarbeiten auf Abschnitt. Fahrstreifen blockiert.</TRAFFIC_ITEM_DESCRIPTION>
    </TRAFFIC_ITEM>
    ...
  </TRAFFIC_ITEMS>
</TRAFFICML_INCIDENTS>