Spécification CIFS
CIFS (Closure and Incident Feed Specification) est le protocole standard de Waze pour décrire les incidents et les routes fermées dans les flux des partenaires.
Le tableau des paramètres ci-dessous classe chaque élément comme suit :
- Obligatoire : pour que votre flux soit considéré comme valide, chaque balise obligatoire doit être associée à une valeur correctement mise en forme.
- Recommandé : ces balises ne sont pas techniquement obligatoires, mais recommandées.
- Facultatif : balises facultatives qui vous permettent de fournir des données supplémentaires.
L'ordre des éléments n'a pas d'importance pour le moteur qui analyse le fichier.
Ces tags peuvent décrire un incident ou une route fermée en fonction de la valeur du tag type.
Les différences mineures sont expliquées le cas échéant.
Voici quelques exemples de routes fermées dans un flux :
Voici quelques exemples d'incidents dans un flux :
N'oubliez pas que vous pouvez combiner les fermetures et les incidents dans le même fichier de flux.
Éléments du CIFS
| Élément | Obligatoire | Saisie de balise | Description |
|---|---|---|---|
| ID de l'incident | Obligatoire | Texte libre | Spécifie un identifiant alphanumérique ou numérique.
<incident id="LND11DEayKr">...</incident> |
| type | Obligatoire | Au choix :
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
Le type détermine la façon dont votre événement sera utilisé par l'application Waze.
Tous les autres types s'affichent sur la carte Waze et déclenchent une notification pop-up pour les Wazers à proximité, mais n'ont aucun impact direct sur le calcul d'itinéraire. <type>ROAD_CLOSED</type> |
| sous-type | Demandée | Consultez la liste des sous-types autorisés. | Description plus précise du type d'incident signalé.
|
| polyline | Obligatoire | Liste de paires lat lon séparées par des espaces |
Coordonnées de latitude et de longitude en degrés décimaux (DD, projection SRID 4326) qui décrivent l'emplacement de l'incident ou de la route fermée. Idéalement, elles doivent comporter au moins six chiffres après la virgule pour être suffisamment précises. L'ordre des coordonnées doit refléter le sens du trafic concerné. Nous ne pouvons pas déduire le sens du trafic à partir d'un seul point. La polyligne suivante aura un impact sur un sens de circulation (ajoutez un élément <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 | Demandée | BOTH_DIRECTIONS ou ONE_DIRECTION |
Indique si la perturbation ou la fermeture affecte un ou les deux sens de circulation sur la route. Nous vous recommandons vivement de fournir une direction, même si une polyligne est fournie. Si vous ne pouvez fournir qu'un seul ensemble de coordonnées, le champ de direction est obligatoire pour que l'événement s'affiche dans la bonne direction. <direction>BOTH_DIRECTIONS</direction> |
| rue | Obligatoire | Texte libre | Indique le nom de la rue ou de la route sur laquelle l'événement se produit. <street>NW 12th St</street> |
| starttime | Obligatoire | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Spécifie la date et l'heure de début d'une période d'indisponibilité. Vous pouvez l'omettre pour les incidents qui ne sont pas de type ROAD_CLOSED. Nous considérerons alors que l'incident est actuellement actif. Le code temporel doit être au format ISO8601, avec une précision à la seconde, et inclure le décalage du fuseau horaire. <starttime>2023-04-07T09:00:00+01:00</starttime> |
| endtime | Demandée | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Spécifiez la date et l'heure de fin au format ISO8601, en précisant les secondes et en incluant le décalage du fuseau horaire. Si vous ne la spécifiez pas, la valeur par défaut est actuellement de 14 jours après l'heure de début. <endtime>2023-04-07T23:00:00+01:00</endtime> |
| description | Demandée | Texte libre | Cause de la perturbation du trafic. Cette description doit comporter moins de 40 caractères. Les descriptions de plus de 40 caractères seront acceptées, mais il est possible qu'elles ne s'affichent pas correctement dans l'application Waze. <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> |
| impact sur la voie | facultatif | informations structurées sur l'impact des voies ; | Ne fournissez des données sur l'impact sur les voies que si l'incident n'entraîne pas la fermeture complète de la route et n'affecte qu'un seul sens de circulation.
Fournissez des informations sur toutes les voies en spécifiant un tableau de voies, en utilisant le format de voie WZDx ou un format similaire.
Exemple de format complet : <lanes>
<lane>
<order>1</order>
<type>LANE</type>
<status>CLOSED</status>
</lane>
<lane>
<order>2</order>
<type>LANE</type>
<status>OPEN</status>
</lane>
</lanes>
Exemple de format partiel : <lane_impact> <total_closed_lanes>2</total_closed_lanes> <roadside>RIGHT</roadside> </lane_impact> |
| calendrier | Facultatif | <dayname>hh:mm-hh:mm</dayname> |
Encapsule toutes les dates et heures de début et de fin de l'incident. <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> |
Sous-types d'incidents et de fermetures
Fournissez plus de détails sur la nature de l'incident. Les sous-types acceptables sont déterminés par le type fourni.
| Type | Sous-types possibles |
|---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|