Especificación CIFS
La CIFS (Especificación de feed de incidentes y cierres) es el protocolo estándar de Waze para describir incidentes y cierres viales en los feeds de los socios.
En la siguiente tabla de parámetros, se clasifica cada elemento de la siguiente manera:
- Obligatorio: Si no hay un valor con el formato correcto para una etiqueta obligatoria, el feed se considerará no válido.
- Solicitado: Si bien técnicamente no es obligatoria, 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.
Esas etiquetas pueden describir un incidente o un cierre de ruta según el valor de la etiqueta type
.
Las diferencias menores se explican cuando es relevante.
Estos son algunos ejemplos de cierres de rutas en un feed
Estos son algunos ejemplos de incidentes en un feed
Recuerda que puedes combinar incidentes y cierres en el mismo archivo de feed.
Elementos CIFS
Elemento | Obligatorias | Entrada de la etiqueta | Descripción |
---|---|---|---|
ID del incidente | Obligatorias | Texto libre | Especifica un identificador alfanumérico o numérico.
<incident id="LND11DEayKr">...</incident> |
tipo | Obligatorias | 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 cercanos, pero no tendrán un impacto directo en el enrutamiento. <type>ROAD_CLOSED</type> |
subtipo | Solicitado | Consulte la lista de subtipos permitidos. | Una descripción más precisa del tipo de incidente informado.
|
polilínea | Obligatorias | Lista de pares de lat lon separados en blanco |
Las coordenadas de latitud y longitud de grados decimales (DD, proyección SRID 4326) que describen la ubicación del incidente o el cierre de una ruta. Idealmente, estos deben tener al menos 6 dígitos después del punto decimal para obtener una exactitud suficiente. El orden de las coordenadas debe reflejar la dirección del tráfico afectado. No podemos deducir la dirección del tráfico 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> |
direction | Solicitado | BOTH_DIRECTIONS o ONE_DIRECTION |
Especifica si la interrupción o el cierre afectan una o ambas direcciones de tráfico 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, el campo de dirección es obligatorio para garantizar que el evento se muestre en la dirección de conducción correcta. <direction>BOTH_DIRECTIONS</direction> |
Calle | Obligatorias | Texto libre | Especifica el nombre de la calle o ruta en la que se lleva a cabo el evento. Debe coincidir con el mapa de Waze. <street>NW 12th St</street> |
horadeinicio | Obligatorias | 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 en este momento. La marca de tiempo debe estar en formato ISO8601 con un nivel de detalle de segundos y debe incluir el desplazamiento de la zona horaria. <starttime>2023-04-07T09:00:00+01:00</starttime> |
hora de finalización | Solicitado | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Especifica la fecha y hora de finalización con el formato ISO8601 en un nivel de detalle de segundos y, luego, incluye el desplazamiento de la zona horaria Si omites este paso, se establecerá de forma predeterminada 14 días después de la hora de inicio. <endtime>2023-04-07T23:00:00+01:00</endtime> |
description | Solicitado | Texto libre | La causa de la interrupción del tráfico. La 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 de carril | opcional | información estructurada sobre el impacto de carril | Proporciona esta información solo si el incidente no implica una ruta cerrada por completo.
Proporciona información sobre todos los carriles especificando un array de carriles mediante el formato de carril WZDx o uno 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> |
agenda | 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 cierres
Proporcionar más detalles sobre la naturaleza del incidente. Los subtipos aceptables se determinan según el tipo proporcionado.
Tipo | Posibles subtipos |
---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|