Incident information

Waze accepts feed data for both real-time or planned traffic incidents, including hazards on the road, construction, and more. Incidents don’t affect real-time navigation, they only alert drivers.

Incident elements

Use the elements in the following table to create an "incident" entry in your feed file. The order of the elements does not matter to the engine parsing the file.

Element Required? Tag input Description
incident Required Free text

A unique ID for a single incident. It must be at least 3 alphanumeric characters in length.

<incident id="AA8824"> ... </incident>
polyline Required lat lon

Latitude and longitude coordinates that describe the location of the incident. These should have at least 6 digits after the decimal point for sufficient accuracy.

If the incident only affects one direction, please include the coordinates for the start location and for a point that defines the direction; for example: the start point (y x) and a point (y1 x1) 50 meters southwest to designate the direction. If the incident affects both directions, provide the exact same coordinates twice. The following example is for a single direction.

<polyline>
  51.510090 -0.006902 51.509142 -0.006564
</polyline>
street Required Free text

Specifies the name of the street on which the incident is occurring. It must be at least 2 alphanumeric characters in length.

<street>SR22</street>
type Required ACCIDENT, CONSTRUCTION, HAZARD, ROAD_CLOSED

Describes the alert. Possible types include: ACCIDENT, CONSTRUCTION, HAZARD, and ROAD_CLOSED. For a complete list of subtypes, refer to Incident subtypes.

<type>ACCIDENT</type>
starttime Required yyyy-MM-dd'T'HH:mm:ss+HH:mm

Specify the start date and start time for the incident in ISO8601 format including the timezone offset. A value for seconds will be accepted but is not required.

<starttime>2016-04-07T09:00:00+01:00</starttime>
endtime Required yyyy-MM-dd'T'HH:mm:ss+HH:mm

Specify end date and end time values using ISO8601 format and include the timezone offset. A value for seconds will be accepted but is not required.

<endtime>2016-04-07T23:00:00+01:00</endtime>
description Required Free text

A description of the incident. The description should be less than 40 characters; text that is more than 40 characters will be accepted, but may not display properly in the Waze app.

<description>
  2-car MVA at SR22/US234, debris on road
</description>
direction Required BOTH_DIRECTIONS or ONE_DIRECTION

If you provide 2 or more points, the direction should include one of these: ONE_DIRECTION or BOTH_DIRECTIONS.

<direction>BOTH_DIRECTIONS</direction>
reference Required Free text

Identifies the organization from which the information was sourced. The reference name must be a maximum of either 10 capital letters or 12 lowercase letters.

<reference>ORGNAME</reference>
schedule Optional hh:mm-hh:mm

Encapsulates all start and end date and times for the incident.

<schedule>
  <saturday>23:00-00:00</saturday>
  <sunday>00:00-08:00</sunday>
</schedule>
subtype Optional string

Refer to Incident subtypes for a list of the supported subtypes for each incident type. This element is not required, but can be included as a blank field.

<subtype>HAZARD_ON_ROAD_OIL</subtype>

Incident subtypes

The following subtypes are supported in the incident feed. Acceptable subtypes are determined by the type provided.

Type Required? Possible subtypes
ACCIDENT Optional
ACCIDENT_MINOR
ACCIDENT_MAJOR
HAZARD Optional
HAZARD_ON_ROAD_CAR_STOPPED
HAZARD_ON_ROAD_CONSTRUCTION
HAZARD_ON_ROAD_ICE
HAZARD_ON_ROAD_LANE_CLOSED
HAZARD_ON_ROAD_OBJECT
HAZARD_ON_ROAD_OIL
HAZARD_ON_ROAD_POT_HOLE
HAZARD_ON_ROAD_ROAD_KILL
HAZARD_ON_ROAD_TRAFFIC_LIGHT_FAULT
HAZARD_ON_SHOULDER
HAZARD_ON_SHOULDER_ANIMALS
HAZARD_ON_SHOULDER_CAR_STOPPED
HAZARD_ON_SHOULDER_MISSING_SIGN
HAZARD_WEATHER
HAZARD_WEATHER_FLOOD
HAZARD_WEATHER_FOG
HAZARD_WEATHER_FREEZING_RAIN
HAZARD_WEATHER_HAIL
HAZARD_WEATHER_HEAT_WAVE
HAZARD_WEATHER_HEAVY_RAIN
HAZARD_WEATHER_HEAVY_SNOW
HAZARD_WEATHER_HURRICANE
HAZARD_WEATHER_MONSOON
HAZARD_WEATHER_TORNADO

Incident examples

The following examples show a single incident in XML and JSON formats.

XML incident

The following is an example of a single incident in XML.

<incidents>
  <incident id="101">
    <type>HAZARD</type>
    <subtype>HAZARD_ON_ROAD_OBJECT</subtype>
    <polyline>51.510090 -0.006902 51.509142 -0.006564 51.506291 -0.003640
    51.503796 0.001051 51.499218 0.001687 51.497365 0.002020</polyline>
    <street>NW 12th St</street>
    <starttime>2017-12-07T09:00:00+01:00</starttime>
    <endtime>2017-12-07T23:00:00+01:00</endtime>
    <description>Closure on I-95 NB due to construction</description>
    <direction>BOTH_DIRECTIONS</direction>
  </incident>
</incidents>

JSON incident

The following is an example of a single incident in JSON.

{
  "id": "101",
  "type": "HAZARD",
  "subtype": "HAZARD_ON_ROAD",
  "polyline": "51.510090 -0.006902 51.509142 -0.006564 51.506291 -0.003640 51.503796 0.001051 51.499218 0.001687 51.497365 0.002020",
  "street": "NW 12th St",
  "starttime": "2016-04-07T09:00:00+01:00",
  "endtime": "2016-04-07T23:00:00+01:00",
  "description": " Closure on I-95 NB due to construction",
  "direction": "BOTH_DIRECTIONS"
}

The following examples show an entire incident feed file in both XML and JSON formats.

XML feed file

The following is an example of a complete incident feed file in XML.

<?xml version="1.0" ?>
<incidents xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/road-incidents/incidents_feed.xsd">
   <incident id="1234">
      <creationtime>2017-07-12T00:00:00-05:00</creationtime>
      <description>Major Bridge Bridge Replacement</description>
      <location>
         <street>I-71</street>
         <direction>BOTH_DIRECTIONS</direction>
         <polyline>39.4147140554 -84.0911348964 39.4236465485 -84.0910722875
         39.4236695805 -84.1239525079</polyline>
      </location>
      <starttime>2017-07-12T00:00:00-05:00</starttime>
      <endtime>2018-12-31T00:00:00-05:00</endtime>
      <type>CONSTRUCTION</type>
   </incident>
   <incident id="1235">
      <creationtime>2017-04-25T00:00:00-05:00</creationtime>
      <updatetime>2017-11-02T00:00:00-05:00</updatetime>
      <description>Furniture fallen from a vehicle on the road</description>
      <location>
         <street>BALES RD</street>
         <polyline>-84.6517482702 39.1562047924 -84.6515950347 39.1563610529
         -84.6505661241 39.1572514708 -84.6502381133 39.1575875208</polyline>
      </location>
      <starttime>2017-04-25T00:00:00-05:00</starttime>
      <endtime>2017-05-25T00:00-05:00</endtime>
      <type>HAZARD</type>
   </incident>
   <incident id="1236">
      <creationtime>2018-07-01T00:10:12-05:00</creationtime>
      <description>Accident involving tractor</description>
      <location>
         <street>BRIDGETOWN RD</street>
          <direction>ONE_DIRECTION</direction>
         <polyline>39.1562047924 -84.6517482702 39.1562047924
         -84.6517482702</polyline>
      </location>
      <starttime>2018-07-30-T00:10:10-05:00</starttime>
      <endtime>2018-09-01T00:10:12-05:00</endtime>
      <type>ACCIDENT</type>
   </incident>
</incidents>

JSON feed file

The following is an example of a complete incident feed file in JSON.

{
  "incidents": [{
      "id": "1234",
      "type": "CONSTRUCTION",
      "description": "Major Bridge Bridge Replacement",
      "location": {
        "street": "I-71",
        "direction": "BOTH_DIRECTIONS",
        "polyline": "39.4147140554 -84.0911348964 39.4236465485 -84.0910722875 39.4236695805 - 84.1239525079"
      },
      "creationtime": "2017-07-12T00:00:00-05:00",
      "starttime": "2017-07-12T00:00:00-05:00",
      "endtime": "2018-12-31T00:00:00-05:00"
    },
    {
      "id": "1235",
      "type": "HAZARD",
      "description": "Furniture fallen from a vehicle on the road",
      "location": {
        "street": "BALES RD",
        "polyline": "-84.6517482702 39.1562047924 -84.6515950347 39.1563610529 - 84.6505661241 39.1572514708 - 84.6502381133 39.1575875208 "
      },
      "starttime": "2017-04-25T00:00:00-05:00",
      "creationtime": "2017-04-25T00:00:00-05:00",
      "updatetime": "2017-11-02T00:00:00-05:00"
    },
    {
      "id": "1236",
      "type": "ACCIDENT",
      "description": "Accident involving tractor",
      "location": {
        "street": "BRIDGETOWN RD",
        "direction": "ONE_DIRECTION",
        "polyline": "39.1562047924 -84.6517482702 39.1562047924 -84.6517482702"
      },
      "creationtime": "2018-07-01T00:10:12-05:00"
    }
  ]
}