Informações de incidente

O Waze aceita dados de feed para incidentes de tráfego em tempo real ou planejados, como perigos na via, obras e outros. Os incidentes não afetam o trajeto em tempo real, apenas alertam os motoristas.

Elementos de incidente

Use os elementos da tabela a seguir para criar um incidente no seu arquivo de feed. A ordem deles não importa para o mecanismo de análise do arquivo.

Elemento Obrigatório? Entrada da tag Descrição
incident Obrigatório Texto livre

Um código exclusivo para um único incidente com pelo menos três caracteres alfanuméricos.


<incident id="AA8824"> ... </incident>
polyline Obrigatório lat lon

Coordenadas de latitude e longitude descrevendo a localização do incidente com pelo menos seis dígitos após o ponto decimal, para que a precisão seja suficiente.

Se o incidente afetar somente uma direção, inclua as coordenadas do local de início e de um ponto que defina a direção; por exemplo: o ponto inicial (y x) e um ponto (y1 x1) 50 metros a sudoeste para designar a direção. Se o incidente afetar as duas direções, forneça as mesmas coordenadas duas vezes. O exemplo a seguir é para uma única direção.


<polyline>
  51.510090 -0.006902 51.509142 -0.006564
</polyline>
street Obrigatório Texto livre

Especifica o nome da via em que o incidente está ocorrendo. Precisa ter pelo menos 2 caracteres alfanuméricos.


<street>SR22</street>
type Obrigatório ACCIDENT, CONSTRUCTION, HAZARD, ROAD_CLOSED

Descreve o alerta. Os tipos possíveis incluem: ACCIDENT, CONSTRUCTION, HAZARD e ROAD_CLOSED. Para ver uma lista completa dos subtipos, consulte Subtipos de incidente.


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

Especifique os valores de data e hora de início do incidente no formato ISO8601, incluindo o deslocamento do fuso horário. É possível adicionar um valor para os segundos, mas não é necessário.


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

Especifique os valores de data e hora de término no formato ISO8601, incluindo o deslocamento do fuso horário. É possível adicionar um valor para os segundos, mas não é necessário.


<endtime>2016-04-07T23:00:00+01:00</endtime>
description Obrigatório Texto livre

Uma descrição do incidente com até 40 caracteres. Se for maior, será aceita, mas não será exibida corretamente no aplicativo Waze.


<description>
  2-car MVA at SR22/US234, debris on road
</description>
direction Obrigatório BOTH_DIRECTIONS ou ONE_DIRECTION

Se você informar dois ou mais pontos, a direção precisará incluir estes valores: ONE_DIRECTION ou BOTH_DIRECTIONS.


<direction>BOTH_DIRECTIONS</direction>
reference Obrigatório Texto livre

Identifica a organização de onde as informações vieram. O nome da referência pode ter no máximo 10 letras maiúsculas ou 12 letras minúsculas.


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

Agrupa todas as datas e horas de início e término do incidente.


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

Consulte Subtipos de incidentes para ver uma lista dos subtipos suportados para cada tipo de incidente. Este elemento não é obrigatório, mas pode ser incluído como um campo em branco.


<subtype>HAZARD_ON_ROAD_OIL</subtype>

Subtipos de incidentes

Os seguintes subtipos são suportados no feed de incidentes e são determinados pelo tipo fornecido.

Tipo Obrigatório? Possíveis subtipos
ACCIDENT Opcional

ACCIDENT_MINOR
ACCIDENT_MAJOR
HAZARD Opcional

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

Exemplos de incidentes

Os exemplos a seguir mostram um único incidente nos formatos XML e JSON.

Incidente em formato XML

Este é um exemplo de um incidente único em 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>

Incidente em formato JSON

Este é um exemplo de um incidente único em 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"
}

Os exemplos a seguir mostram um arquivo inteiro de feed de incidentes nos formatos XML e JSON.

Arquivo de feed em formato XML

Este é um exemplo de um arquivo completo de feed de incidentes em 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>

Arquivo de feed em formato JSON

Este é um exemplo de arquivo completo de feed de incidentes em 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"
    }
  ]
}