Especificação CIFS
A especificação do feed de interdições e incidentes (CIFS) é o protocolo padrão do Waze que descreve incidentes e vias interditadas nos feeds dos parceiros.
A tabela de parâmetros abaixo classifica cada elemento da seguinte maneira:
- Obrigatório: os feeds em que o valor de uma tag obrigatória não está formatado corretamente são considerados inválidos.
- Solicitado: embora tecnicamente não sejam obrigatórias, é recomendável usar as tags solicitadas.
- Opcional: tags opcionais que permitem fornecer mais dados.
A ordem dos elementos não importa para o mecanismo de análise do arquivo.
Essas tags podem descrever um incidente ou uma via interditada, dependendo do valor da tag type.
As pequenas diferenças são explicadas quando relevantes.
Veja alguns exemplos de vias interditadas em um feed
Veja alguns exemplos de incidentes em um feed
É possível combinar interdições e incidentes no mesmo arquivo de feed.
Elementos da CIFS
| Elemento | Obrigatório | Entrada da tag | Descrição |
|---|---|---|---|
| incident id | Obrigatório | Texto livre | Especifica um identificador alfanumérico ou numérico.
<incident id="LND11DEayKr">...</incident> |
| type | Obrigatório | Uma destas opções:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
O tipo determina como seu evento é consumido pelo app Waze.
Todos os outros tipos são exibidos no mapa do Waze e acionam uma notificação pop-up para os Wazers próximos sem afetar diretamente o trajeto. <type>ROAD_CLOSED</type> |
| subtype | Solicitado | Ver lista de subtipos permitidos | Uma descrição mais precisa do tipo de incidente informado.
|
| polyline | Obrigatório | Lista de pares lat lon separados por espaços em branco. |
Coordenadas de latitude e longitude em graus decimais (projeção SRID 4326) que descrevam o local do incidente ou da via interditada. Elas devem ter pelo menos seis dígitos após o marcador decimal, para que a precisão seja suficiente. A ordem das coordenadas precisa seguir a direção do trânsito que foi afetada. Não é possível deduzir a direção do trânsito usando um único ponto. A polilinha a seguir afetará uma direção de tráfego (adicione um elemento <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> |
| direction | Solicitado | BOTH_DIRECTIONS ou ONE_DIRECTION |
Especifica se a interrupção ou a interdição afeta uma ou as duas direções de tráfego na pista. É altamente recomendável indicar uma rota, ainda que uma polilinha seja fornecida. Se for possível fornecer apenas um conjunto de coordenadas, será necessário inserir o campo de direção para garantir que o evento seja exibido na direção correta. <direction>BOTH_DIRECTIONS</direction> |
| street | Obrigatório | Texto livre | Especifica o nome da via em que o evento está ocorrendo. <street>NW 12th St</street> |
| starttime | Obrigatório | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Especifica a data e hora de início de um período de interrupção. É possível omiti-las em incidentes que não são do tipo ROAD_CLOSED, que vamos considerar como ativos no momento. A data e hora precisam estar no formato ISO8601, em granularidade de segundos, e incluir a diferença de fuso horário. <starttime>2023-04-07T09:00:00+01:00</starttime> |
| endtime | Solicitado | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Especifique a data e hora de término no formato ISO8601, em granularidade de segundos, e inclua a diferença de fuso horário. Em caso de omissão, é usado o padrão de 14 dias após o horário de início. <endtime>2023-04-07T23:00:00+01:00</endtime> |
| description | Solicitado | Texto livre | A causa da interrupção do trânsito em até 40 caracteres. Uma descrição de mais de 40 caracteres será aceita, mas não será exibida corretamente no aplicativo Waze. <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> |
| impacto na faixa | opcional | informações de impacto na faixa estruturada | Forneça apenas se o incidente não incluir uma interdição completa da via.
Forneça informações sobre todas as faixas especificando uma matriz de faixas usando o formato de faixa WZDx ou semelhante.
Exemplo em formato completo: <lanes>
<lane>
<order>1</order>
<type>LANE</type>
<status>CLOSED</status>
</lane>
<lane>
<order>2</order>
<type>LANE</type>
<status>OPEN</status>
</lane>
</lanes>
Exemplo em formato parcial: <lane_impact> <total_closed_lanes>2</total_closed_lanes> <roadside>RIGHT</roadside> </lane_impact> |
| schedule | Opcional | <dayname>hh:mm-hh:mm</dayname> |
Agrupa todas as datas e horas de início e término do incidente. <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> |
Subtipos de incidentes e interdições
Forneça mais detalhes sobre a natureza do incidente. Os subtipos aceitáveis são determinados pelo tipo fornecido.
| Tipo | Possíveis subtipos |
|---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|