Road closure information

You can provide Waze with both planned and real-time closure information using a feed. Planned closures appear in the Waze Map Editor showing both the start and end times, but only appear in the Waze app while the closure is active.

Closure entries with missing or incorrect information for start and end times, street names, or directions are added as closure map problems.

Map problems are indicated in the Waze Map Editor by the following icon:

Entries with these types of issues require a higher-level community map editor to review and approve or reject them. Once these are reviewed and approved, they will appear in the map; however your organization won’t be associated with the closure report.

To ensure that the street names you provide in your listing match the ones in the Waze map, try using the Waze Reverse Geocoding API, as incidents or moving vehicle entries that have incorrect information won't be displayed on the map.

Closure mapping guidelines

To map a road closure, provide the required tags for a closure feed. You must map the closure according to the following guidelines:

  • Waze closures are created between two connecting junctions, road splits, or merges. You cannot map a road closure for only part of a segment.

    The following closure is created correctly:

    The following closure is incorrect because it uses a part of the segment that doesn’t include a junction, split, or merge:

  • The polyline must correctly resemble the geometry of the road. Points cannot be more than 50 meters apart. The polyline doesn’t have to exactly match the road’s alignment, but the general shape should be kept the same.

    The following polyline correctly maintains the general shape of the road:

    The following polyline ignores the shape of the road:

  • Closures can only affect one street name. The closure’s start and end points must have the same street name. Multiple street name segments aren't supported, even if a polyline is provided.
  • Feed closures can only be created on the following road types:
    • Freeways
    • Highways
    • City Streets
    • Ramps

    Unsupported road types include:

    • Private roads
    • Parking lot roads
    • 4x4 and pedestrian roads
  • Closures cannot be less than 35 meters in length.

Closure elements

Use the elements in the following table to create a closure 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 id Required Free text

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

<incident id="LND11DEayKr">...</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.

<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 Required Free text

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

<street>NW 12th St</street>
type Required ROAD_CLOSED

Describes the alert. For closures, ROAD_CLOSED should be the only type used. The subtypes element lists the available closure reasons.

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

Specify the start date and start time for the closure 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

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

<description>I-95 All NB lanes closed btwn
Exits 184 and 186.</description>
direction Required BOTH_DIRECTIONS or ONE_DIRECTION

If you provide 2 or more points, the direction should include one of these two values: 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 <dayname>hh:mm-hh:mm</dayname>

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

<schedule>
  <monday>09:00-11:00,17:00-21:00</monday>
  <thursday>09:00-11:00,17:00-21:00</thursday>
  <friday>09:00-11:00,17:00-21:00</friday>
  <saturday>00:00-05:00</saturday>
  <sunday>09:00-18:00</sunday>
</schedule>
subtype Optional ROAD_CLOSED_HAZARD ROAD_CLOSED_CONSTRUCTION ROAD_CLOSED_EVENT

Identifies the reason for the road closure. The reasons for each closure are as follows:

  • A road closed due to a hazard.
  • A road closed due to construction.
  • A road closed due to an event.
<subtype>ROAD_CLOSED_EVENT</subtype>

Closure examples

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

XML closure

The following is an example of a single road closure in XML.

<incident id="101">
  <type>ROAD_CLOSED</type>
  <subtype>ROAD_CLOSED_CONSTRUCTION</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>2016-04-07T09:00:00+01:00</starttime>
  <endtime>2016-04-07T23:00:00+01:00</endtime>
  <description>Closure on I-95 NB due to construction</description>
  <direction>BOTH_DIRECTIONS</direction>
</incident>

JSON closure

The following is an example of a single road closure in JSON.

{
  "id": "101",
  "type": "ROAD_CLOSED",
  "subtype": "ROAD_CLOSED_CONSTRUCTION",
  "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 road closure feed file in both XML and JSON formats.

XML feed file

The following is an example of a complete road closure 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">
  <incidents>
    <incident id="3f4r45ff233">
      <creationtime>2017-07-04T13:31:17-04:00</creationtime>
      <updatetime>2017-11-17T04:40:41-05:00</updatetime>
      <type>ROAD_CLOSED</type>
      <description>Complete road closure due to road works</description>
      <location>
        <street>N Liberty St</street>
        <direction>BOTH_DIRECTIONS</direction>
        <polyline>42.1601432984533 -119.3525208937842 42.1781676611244
  -119.35679623266</polyline>
      </location>
      <starttime>2017-06-05T00:01:00-04:00</starttime>
      <endtime>2017-11-22T15:30:00-05:00</endtime>
    </incident>
    <incident id="zxf3kvmrpf">
      <creationtime>2017-08-04T13:31:30-04:00</creationtime>
      <updatetime>2017-12-17T04:40:41-05:00</updatetime>
      <type>ROAD_CLOSED</type>
      <subtype>ROAD_CLOSED_CONSTRUCTION</subtype>
      <description>PLANNED ROAD CLOSURE St Johns Sdrd from William Graham to
Woodbine in the Town of Aurora. Closed until Dec 31.</description>
      <location>
        <street>St John's Sideroad</street>
        <direction>BOTH_DIRECTIONS</direction>
        <polyline>44.02712 -99.43131 44.023011 -99.363349 44.02712 -99.43131
44.0343021 -99.399426</polyline>
      </location>
      <starttime>2017-04-18T00:01:00-04:00</starttime>
      <endtime>2017-12-31T23:59:00-05:00</endtime>
    </incident>
</incidents>

JSON feed file

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

{
  "incidents": [{
      "id": "3f4r45ff233",
      "creationtime": "2017-07-04T13:31:17-04:00",
      "updatetime": "2017-11-17T04:40:41-05:00",
      "description": "Complete road closure due to road works",
      "location": {
        "street": "N Liberty St",
        "direction": "BOTH_DIRECTIONS",
        "polyline": "42.1601432984533 -119.3525208937842 42.1781676611244 -119.35679623266"
      },
      "starttime": "2017-06-05T00:01:00-04:00",
      "endtime": "2017-11-22T15:30:00-05:00",
      "type": "ROAD_CLOSED"
    },
    {
      "id": "zxf3kvmrpf",
      "creationtime": "2017-08-04T13:31:30-04:00",
      "updatetime": "2017-12-17T04:40:41-05:00",
      "description": "St Johns Sdrd from William Graham to Woodbine in the Town of Aurora. Closed until Dec 31. ",
      "type": "ROAD_CLOSED",
      "subtype": "ROAD_CLOSED_CONSTRUCTION",
      "location": {
        "street": "St John's Sideroad",
        "direction": "BOTH_DIRECTIONS",
        "polyline": "44.02712 -99.43131 44.023011 -99.363349 44.02712 -99.43131 44.0343021 - 99.399426"
      },
      "starttime": "2017-04-18T00:01:00-04:00",
      "endtime": "2017-12-31T23:59:00-05:00"
    }
  ]
}