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 de paramètres ci-dessous classe chaque élément comme suit:
- Obligatoire:en l'absence d'une valeur correctement formatée pour une balise obligatoire, votre flux est considéré comme non valide.
- Demandée:bien que cela ne soit pas obligatoire d'un point de vue technique, les tags demandés sont considérés comme recommandés.
- Facultatif:balises facultatives vous permettant de fournir davantage de données.
L'ordre des éléments n'a pas d'importance pour le moteur qui analyse le fichier.
Ces balises peuvent décrire un incident ou une route fermée en fonction de la valeur de la balise 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 mélanger les routes fermées et les incidents dans le même fichier de flux.
Éléments CIFS
Élément | Obligatoire | Entrée de tag | Description |
---|---|---|---|
ID de l'incident | Obligatoire | Texte libre | Spécifie un identifiant alphanumérique ou numérique.
<incident id="LND11DEayKr">...</incident> |
type | Obligatoire | L'un des éléments suivants :
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
Le type déterminera la façon dont votre événement sera utilisé par l'application Waze.
Tous les autres types s'afficheront sur la carte Waze et déclencheront une notification pop-up pour les Wazers à proximité, mais n'auront aucun impact direct sur l'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é.
|
polyligne | Obligatoire | Liste de paires lat lon vides séparées |
Degrés décimaux (DD, projection SRID 4326) des coordonnées de latitude et de longitude décrivant l'emplacement de l'incident ou de la route fermée. Idéalement, ils doivent comporter au moins six chiffres après la virgule pour une précision suffisante. L'ordre des coordonnées doit refléter le sens du trafic. Nous ne pouvons pas déduire le sens du trafic à partir d'un seul point. La polyligne suivante a un impact dans 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 l'un des sens de circulation ou les deux. Il est vivement recommandé de fournir une direction, même lorsqu'une polyligne est fournie. Si vous ne pouvez fournir qu'un seul ensemble de coordonnées, le champ "Direction" est obligatoire pour que l'événement s'affiche dans le bon sens de circulation. <direction>BOTH_DIRECTIONS</direction> |
rue | Obligatoire | Texte libre | Indique le nom de la rue ou de la route où l'événement a lieu. Il doit correspondre à la carte Waze. <street>NW 12th St</street> |
heure de début | Obligatoire | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Spécifie la date et l'heure de début pour une période de perturbation. Vous pouvez l'omettre pour les incidents qui ne sont pas de type "Route_CLOSED", car nous partirons du principe qu'ils sont actifs. Le code temporel doit être au format ISO8601, exprimé en secondes et inclure le décalage de fuseau horaire. <starttime>2023-04-07T09:00:00+01:00</starttime> |
heure de fin | Demandée | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Spécifiez la date et l'heure de fin au format ISO8601 avec une précision en secondes et incluez le décalage horaire. Si vous omettez cette valeur, elle sera actuellement définie par défaut sur 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 sont acceptées, mais risquent de ne pas s'afficher correctement dans l'application Waze. <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> |
impact sur la voie | facultative | informations structurées sur l'impact sur la voie | Ne fournissez cette information que si l'incident n'entraîne pas la fermeture totale d'une route.
Fournissez des informations sur toutes les voies en spécifiant un tableau de voies, en utilisant le format de voies 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> |
programmation | 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 "Incidents et 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 |
|