Specifica CIFS
CIFS (Closure and Incident Feed Specification) è il protocollo standard di Waze per descrivere gli incidenti e le chiusure stradali nei partner feed.
La tabella di parametri riportata di seguito classifica ogni elemento nel seguente modo:
- Obbligatorio:senza un valore formattato correttamente per un tag obbligatorio, il feed è considerato non valido.
- Richiesta: sebbene non sia tecnicamente non obbligatoria, i tag richiesti sono considerati consigliati.
- Facoltativo:tag facoltativi che consentono di fornire più dati.
L'ordine degli elementi non è importante per il motore che analizza il file.
Questi tag possono descrivere un incidente o una chiusura stradale in base al valore del tag type.
Eventuali differenze di minore entità vengono spiegate, se pertinenti.
Ecco alcuni esempi di chiusure stradali in un feed.
Ecco alcuni esempi di Incidenti in un feed
Ricorda che puoi combinare chiusure e incidenti nello stesso file del feed.
Elementi CIFS
| Elemento | Obbligatorio | Input tag | Descrizione |
|---|---|---|---|
| ID incidente | Obbligatorio | Testo libero | Specifica un identificatore alfanumerico o numerico.
<incident id="LND11DEayKr">...</incident> |
| tipo | Obbligatorio | Uno dei seguenti:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
Il tipo determinerà il modo in cui il tuo evento verrà consumato dall'app Waze.
Tutti gli altri tipi verranno mostrati nella mappa di Waze e attiveranno una notifica popup per i Wazer nelle vicinanze. ma non avranno un impatto diretto sul calcolo del percorso. <type>ROAD_CLOSED</type> |
| sottotipo | Richiesta | Consulta l'elenco di sottotipi consentiti | Una descrizione più precisa del tipo di incidente segnalato.
|
| polilinea | Obbligatorio | Elenco di coppie lat lon separate, vuote |
Coordinate di latitudine e longitudine in gradi decimali (DD, proiezione SRID 4326) che descrivono la posizione del incidente o chiusura stradale. Idealmente, queste ultime dovrebbero avere almeno sei cifre dopo il separatore decimale per una precisione sufficiente. L'ordine delle coordinate deve riflettere la direzione del traffico interessato. Non è possibile detrarre la direzione del traffico da un singolo punto. La seguente polilinea avrà impatto su una direzione del traffico (aggiungi 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 | Richiesta | BOTH_DIRECTIONS o ONE_DIRECTION |
Specifica se l'interruzione o la chiusura influiscono su una o entrambe le direzioni di traffico sulla strada. Ti consigliamo vivamente di indicare una direzione, anche quando viene fornita una polilinea. Se è possibile fornire un solo insieme di coordinate, il campo della direzione è obbligatorio per garantire che l'evento venga visualizzato nella direzione di guida corretta. <direction>BOTH_DIRECTIONS</direction> |
| strada | Obbligatorio | Testo libero | Specifica il nome della via o della strada in cui si verifica l'evento. <street>NW 12th St</street> |
| ora di inizio | Obbligatorio | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Specifica la data e l'ora di inizio di un periodo di interruzione. Puoi omettere per incidenti che non sono di tipo ROAD_CLOSED e supporremo che l'incidente sia attualmente attivo. Il timestamp deve essere nel formato ISO8601 con granularità in secondi e includere l'offset del fuso orario. <starttime>2023-04-07T09:00:00+01:00</starttime> |
| ora di fine | Richiesta | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Specifica la data di fine utilizzando il formato ISO8601 con granularità di secondi e includi lo scarto con il fuso orario Se lo ometti, l'impostazione predefinita sarà 14 giorni dopo l'ora di inizio. <endtime>2023-04-07T23:00:00+01:00</endtime> |
| descrizione | Richiesta | Testo libero | La causa dell'interruzione del traffico. Questa descrizione deve essere inferiore a 40 caratteri. Una descrizione che supera i 40 caratteri verrà accettati, ma potrebbero non essere visualizzati correttamente nell'app Waze. <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> |
| impatto sulle corsie | facoltativo | informazioni strutturate sull'impatto delle corsie | Fornisci queste informazioni solo se l'incidente non comporta una chiusura stradale completa.
Fornisci informazioni su tutte le corsie specificando un array di corsie, utilizzando
Formato corsia WZDx o formato simile.
Esempio di 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>
Esempio di formato parziale: <lane_impact> <total_closed_lanes>2</total_closed_lanes> <roadside>RIGHT</roadside> </lane_impact> |
| programmazione | Facoltativo | <dayname>hh:mm-hh:mm</dayname> |
Incapsula tutte le date di inizio e di fine dell'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> |
Sottotipi incidenti e chiusure
Fornisci maggiori dettagli sulla natura dell'incidente. Accettabile sono determinati dal tipo fornito.
| Tipo | Possibili sottotipi |
|---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|