Specifica CIFS
CIFS (Closure and Incident Feed Specification) è il protocollo standard di Waze per descrivere gli incidenti e le chiusure stradali nei feed dei partner.
La tabella dei parametri riportata di seguito classifica ciascun elemento nel seguente modo:
- Obbligatorio: se non specifichi un valore nel formato corretto per un tag obbligatorio, il feed non è considerato valido.
- Richiesto: sebbene tecnicamente non siano obbligatori, i tag richiesti sono considerati consigliati.
- Facoltativo: tag facoltativi che ti consentono di fornire più dati.
L'ordine degli elementi non è rilevante 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 se pertinenti.
Ecco alcuni esempi di chiusure stradali in un feed
Ecco alcuni esempi di Incidenti in un feed
Ricorda che puoi combinare le chiusure e gli incidenti nello stesso file del feed.
Elementi CIFS
Elemento | Obbligatorio | Inserimento tag | Descrizione |
---|---|---|---|
ID incidente | Obbligatorio | Testo libero | Specifica un identificatore alfanumerico o numerico.
<incident id="LND11DEayKr">...</incident> |
digita | Obbligatorio | Uno dei seguenti:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
Il tipo determinerà la modalità di utilizzo dell'evento da parte dell'app Waze.
Tutti gli altri tipi vengono mostrati nella mappa di Waze e attivano una notifica popup per i Wazer nelle vicinanze, ma non avranno alcun impatto diretto sui percorsi. <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 |
Gradi decimali (DD, proiezione SRID 4326) coordinate di latitudine e longitudine che descrivono il luogo dell'incidente o della chiusura stradale. Idealmente, dovrebbero contenere almeno 6 cifre dopo il separatore decimale per garantire una precisione sufficiente. L'ordine delle coordinate deve riflettere la direzione del traffico interessato. Non possiamo detrarre la direzione del traffico da un singolo punto. La seguente polilinea inciderà 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 |
Indica se l'interruzione o la chiusura interessano una o entrambe le direzioni del traffico sulla strada. Ti consigliamo vivamente di fornire una direzione, anche quando viene fornita una polilinea. Se è possibile fornire un solo insieme di coordinate, il campo della direzione è necessario 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. Deve corrispondere alla mappa di Waze. <street>NW 12th St</street> |
ora di inizio | Obbligatorio | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Specifica la data/ora di inizio per un periodo di interruzione. Puoi ometterlo per gli incidenti che non sono di tipo ROAD_CLOSED e presumeremo che sia attualmente attivo. Il timestamp deve essere nel formato ISO8601 con granularità dei 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/ora di fine utilizzando il formato ISO8601 con la granularità dei secondi e includi l'offset del fuso orario Se ometti questo campo, 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. La descrizione deve contenere meno di 40 caratteri. Una descrizione di oltre 40 caratteri sarà 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 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 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> |
pianificazione | Facoltativo | <dayname>hh:mm-hh:mm</dayname> |
Incapsula tutte le date/ora 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 su incidenti e chiusure
Fornisci ulteriori dettagli sulla natura dell'incidente. I sottotipi accettabili sono determinati dal tipo fornito.
Tipo | Sottotipi possibili |
---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|