Specifica CIFS
CIFS (Closure and Incident Feed Specification) è il protocollo standard di Waze per descrivere incidenti e chiusure stradali nei feed dei partner.
La tabella dei parametri riportata di seguito classifica ogni elemento nel seguente modo:
- Obbligatorio:senza un valore formattato correttamente per un tag obbligatorio, il feed viene considerato non valido.
- Richiesti:anche se tecnicamente non obbligatori, i tag richiesti sono considerati consigliati.
- (Facoltativo) Tag facoltativi che ti 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.
Le differenze minori vengono spiegate laddove pertinente.
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 di 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 valori:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
Il tipo determinerà il modo in cui l'evento verrà utilizzato dall'app Waze.
Tutti gli altri tipi verranno visualizzati nella mappa di Waze e attiveranno una notifica popup per i Wazer nelle vicinanze, ma non avranno alcun impatto diretto sul calcolo del percorso. <type>ROAD_CLOSED</type> |
| sottotipo | Richiesta | Consulta l'elenco dei sottotipi consentiti | Una descrizione più precisa del tipo di incidente segnalato.
|
| polilinea | Obbligatorio | Elenco di coppie lat lon separate da spazi vuoti |
Coordinate di latitudine e longitudine in gradi decimali (DD, SRID proiezione 4326) che descrivono la posizione dell'incidente o della chiusura stradale. Idealmente, dovrebbero avere almeno 6 cifre dopo la virgola per una precisione sufficiente. L'ordine delle coordinate deve riflettere la direzione del traffico interessato. Non possiamo dedurre la direzione del traffico da un singolo punto. La seguente polilinea influirà 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 interessa una o entrambe le direzioni di marcia sulla strada. È fortemente consigliato fornire 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> |
| starttime | Obbligatorio | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Specifica la data e l'ora di inizio di un periodo di interruzione. Puoi ometterlo per gli 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à di secondi e includere l'offset del fuso orario. <starttime>2023-04-07T09:00:00+01:00</starttime> |
| endtime | Richiesta | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Specifica la data e l'ora di fine utilizzando il formato ISO8601 con granularità di secondi e includi l'offset del fuso orario Se ometti questo valore, attualmente il valore predefinito è 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 contenere meno di 40 caratteri. Una descrizione con più di 40 caratteri verrà accettata, ma potrebbe non essere visualizzata correttamente nell'app Waze. <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> |
| impatto sulla corsia | facoltativo | informazioni strutturate sull'impatto della corsia | Fornisci i dati sull'impatto sulla corsia solo se l'incidente non comporta la chiusura completa della strada e interessa una sola direzione di traffico.
Fornisci informazioni su tutte le corsie specificando un array di corsie utilizzando il
formato corsia WZDx o un 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> |
Contiene tutte le date e ore di inizio e 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 di incidenti e chiusure
Fornisci maggiori dettagli sulla natura dell'incidente. I sottotipi accettabili sono determinati dal tipo fornito.
| Tipo | Sottotipi possibili |
|---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|