Especificação CIFS
A especificação do feed de interdições e incidentes (CIFS, na sigla em inglês) é o protocolo padrão do Waze para descrever incidentes e vias interditadas nos feeds dos parceiros.
A tabela de parâmetros abaixo classifica cada elemento da seguinte maneira:
- Obrigatório:sem um valor formatado corretamente para uma tag obrigatória, seu feed é considerado inválido.
- Solicitado:embora não seja tecnicamente necessária, as tags solicitadas são consideradas recomendadas.
- Opcional:tags opcionais que permitem fornecer mais dados.
A ordem deles não importa para o mecanismo de análise do arquivo.
Essas tags podem descrever um incidente ou uma via interditada de acordo com o valor da tag type
.
As pequenas diferenças são explicadas quando relevante.
Confira alguns exemplos de interdições de vias 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 |
---|---|---|---|
ID do incidente | Obrigatório | Texto livre | Especifica um identificador alfanumérico ou numérico.
<incident id="LND11DEayKr">...</incident> |
digitar | 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 serão mostrados no mapa do Waze e acionarão uma notificação pop-up para os Wazers próximos, mas não terão impacto direto no trajeto. <type>ROAD_CLOSED</type> |
subtipo | Solicitado | Consulte a lista de subtipos permitidos | Uma descrição mais precisa do tipo de incidente informado.
|
polilinha | Obrigatório | Lista de pares de lat lon separados por espaços em branco |
Coordenadas de latitude e longitude com graus decimais (DD, projeção SRID 4326) que descrevem o local do incidente ou da via interditada. O ideal é que tenham pelo menos seis dígitos após o ponto decimal para que a precisão seja suficiente. A ordem das coordenadas precisa refletir a direção do trânsito afetado. Não é possível deduzir a direção do trânsito usando um único ponto. A seguinte polilinha afetará uma direção de trânsito (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 via. É altamente recomendável indicar uma rota, mesmo 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> |
rua | Obrigatório | Texto livre | Especifica o nome da rua ou via em que o evento está ocorrendo. Precisa corresponder ao mapa do Waze. <street>NW 12th St</street> |
hora de início | 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 BY_CLOSED, que vamos considerar como ativos no momento. O carimbo de data/hora precisa 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> |
hora de término | Solicitado | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Especifique a data e hora de término usando o formato ISO8601 em granularidade de segundos e inclua o deslocamento do fuso horário Se essa informação for omitida, o padrão será de 14 dias após o horário de início. <endtime>2023-04-07T23:00:00+01:00</endtime> |
descrição | Solicitado | Texto livre | A causa da interrupção do trânsito. Essa descrição precisa ter menos de 40 caracteres. Uma descrição de mais de 40 caracteres será aceita, mas não será exibida corretamente no app 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 de 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 de formato parcial: <lane_impact> <total_closed_lanes>2</total_closed_lanes> <roadside>RIGHT</roadside> </lane_impact> |
programação | 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
Dê 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 |
|