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 | Opcional | 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> O padrão é o horário atual. |
| endtime | Opcional | 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> O padrão é 14 dias após o horário de início. |
| 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 | |
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 |
|
HAZARD |
Opcional |
|
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"
}
]
}