Especificación de CIFS
CIFS (especificación del feed de incidentes y cortes viales) es el protocolo estándar de Waze para describir incidentes y cortes viales en los feeds de los socios.
En la siguiente tabla de parámetros, se clasifica cada elemento de la siguiente manera:
- Obligatorio: Si una etiqueta obligatoria no tiene un valor con el formato adecuado, tu feed se considerará no válido.
- Solicitadas: Si bien técnicamente no son obligatorias, las etiquetas solicitadas se consideran recomendadas.
- Opcional: Son etiquetas opcionales que te permiten proporcionar más datos.
El orden de los elementos no es importante para el motor que analiza el archivo.
Estas etiquetas pueden describir un incidente o un cierre de ruta según el valor de la etiqueta type.
Las diferencias menores se explican cuando corresponde.
A continuación, se incluyen algunos ejemplos de cortes de ruta en un feed.
A continuación, se incluyen algunos ejemplos de incidentes en un feed.
Recuerda que puedes combinar cortes e incidentes en el mismo archivo de feed.
Elementos de CIFS
| Elemento | Obligatorio | Entrada de etiqueta | Descripción |
|---|---|---|---|
| ID del incidente | Obligatorio | Texto libre | Especifica un identificador alfanumérico o numérico.
<incident id="LND11DEayKr">...</incident> |
| tipo | Obligatorio | Uno de los siguientes:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
El tipo determinará la forma en que la app de Waze consumirá tu evento.
Todos los demás tipos se mostrarán en el mapa de Waze y activarán una notificación emergente para los Wazers que se encuentren cerca, pero no tendrán un impacto directo en la planificación de rutas. <type>ROAD_CLOSED</type> |
| subtipo | Solicitada | Consulta la lista de subtipos permitidos. | Es una descripción más precisa del tipo de incidente denunciado.
|
| polyline | Obligatorio | Lista de pares lat lon separados por espacios en blanco |
Coordenadas de latitud y longitud en grados decimales (DD, proyección SRID 4326) que describen la ubicación del incidente o el cierre de ruta. Idealmente, deben tener al menos 6 dígitos después del punto decimal para una precisión suficiente. El orden de las coordenadas debe reflejar la dirección del tráfico afectado. No podemos deducir la dirección del tráfico a partir de un solo punto. La siguiente polilínea afectará una dirección del tráfico (agrega un 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> |
| dirección | Solicitada | BOTH_DIRECTIONS o ONE_DIRECTION |
Especifica si la interrupción o el cierre afectan uno o ambos sentidos de circulación en la ruta. Se recomienda proporcionar una dirección, incluso cuando se proporciona una polilínea. Si solo se puede proporcionar un conjunto de coordenadas, se requiere el campo de dirección para garantizar que el evento se muestre en la dirección de conducción correcta. <direction>BOTH_DIRECTIONS</direction> |
| Calle | Obligatorio | Texto libre | Especifica el nombre de la calle o ruta en la que ocurre el evento. <street>NW 12th St</street> |
| horadeinicio | Obligatorio | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Especifica la fecha y hora de inicio de un período de interrupción. Puedes omitirlo para los incidentes que no son del tipo ROAD_CLOSED, y supondremos que el incidente está activo. La marca de tiempo debe estar en formato ISO8601 con una granularidad de segundos y debe incluir el desfase de zona horaria. <starttime>2023-04-07T09:00:00+01:00</starttime> |
| hora de finalización | Solicitada | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Especifica la fecha y hora de finalización con el formato ISO8601 en una granularidad de segundos y, además, incluye el desfase de zona horaria. Si omites este parámetro, actualmente se establecerá de forma predeterminada 14 días después de la hora de inicio. <endtime>2023-04-07T23:00:00+01:00</endtime> |
| descripción | Solicitada | Texto libre | Es la causa de la interrupción del tráfico. Esta descripción debe tener menos de 40 caracteres. Se aceptará una descripción de más de 40 caracteres, pero es posible que no se muestre correctamente en la app de Waze. <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> |
| Impacto en el carril | opcional | información estructurada sobre el impacto en el carril | Solo proporciona datos sobre el impacto en los carriles si el incidente no es un cierre de ruta completo y afecta un solo sentido del tráfico.
Proporciona información sobre todos los carriles especificando un array de carriles con el formato de carril de WZDx o un formato similar.
Ejemplo 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>
Ejemplo de formato parcial: <lane_impact> <total_closed_lanes>2</total_closed_lanes> <roadside>RIGHT</roadside> </lane_impact> |
| programar | Opcional | <dayname>hh:mm-hh:mm</dayname> |
Encapsula todas las fechas y horas de inicio y finalización del 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 y cortes viales
Proporciona más detalles sobre la naturaleza del incidente. Los subtipos aceptables se determinan según el tipo proporcionado.
| Tipo | Subtipos posibles |
|---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|