CIFS-Spezifikation
CIFS (Closure and Incident Feed Specification) ist das Standardprotokoll von Waze, mit dem Vorfälle und Straßensperrungen in den Feeds der Partner beschrieben werden.
In der Parametertabelle unten werden die einzelnen Elemente so klassifiziert:
- Erforderlich: Ohne einen korrekt formatierten Wert für ein erforderliches Tag wird Ihr Feed als ungültig angesehen.
- Angefordert:Angeforderte Tags sind aus technischer Sicht nicht erforderlich, werden aber empfohlen.
- Optional:Optionale Tags, mit denen Sie mehr Daten angeben können.
Die Reihenfolge der Elemente spielt keine Rolle für die Suchmaschine, die die Datei parst.
Diese Tags können gemäß dem Wert des Tags type entweder einen Unfall oder eine Straßensperrung beschreiben.
Kleinere Unterschiede werden, sofern relevant, erläutert.
Beispiele für Straßensperrungen in einem Feed
Hier einige Beispiele für Vorfälle in einem Feed
Denken Sie daran, dass Sie Straßensperrungen und Vorfälle in derselben Feeddatei mischen können.
CIFS-Elemente
| Element | Erforderlich | Tag-Eingabe | Beschreibung |
|---|---|---|---|
| Vorfall-ID | Erforderlich | Freier Text | Gibt eine alphanumerische oder numerische Kennung an.
<incident id="LND11DEayKr">...</incident> |
| eingeben | Erforderlich | Eine der folgenden Optionen:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
Der Typ bestimmt, wie Ihr Ereignis von der Waze App verarbeitet wird.
Alle anderen Typen werden auf der Waze-Karte angezeigt und lösen eine Pop-up-Benachrichtigung für Wazer in der Nähe aus. Sie haben jedoch keine direkten Auswirkungen auf die Routenplanung. <type>ROAD_CLOSED</type> |
| Untertyp | Angefordert | Liste der zulässigen Untertypen | Eine genauere Beschreibung der Art des gemeldeten Vorfalls.
|
| Polylinie | Erforderlich | Liste der leeren, getrennten lat lon-Paare |
Koordinaten für Breiten- und Längengrad in Dezimalgraden (DD, Projektion SRID 4326), die den Ort des Vorfalls oder der Straßensperrung beschreiben. Für eine ausreichende Genauigkeit sollten idealerweise mindestens sechs Nachkommastellen sein. Die Reihenfolge der Koordinaten muss der Richtung des betroffenen Verkehrs entsprechen. Die Richtung kann nicht von einem einzigen Punkt abgezogen werden. Die folgende Polylinie wirkt sich auf eine Fahrtrichtung aus. Fügen Sie ein <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 | Angefordert | BOTH_DIRECTIONS oder ONE_DIRECTION |
Gibt an, ob sich die Störung oder Sperrung in eine oder beide Richtungen auf der Straße auswirkt. Es wird dringend empfohlen, auch dann eine Richtung anzugeben, wenn eine Polylinie zur Verfügung gestellt wird. Wenn nur ein Satz von Koordinaten angegeben werden kann, ist das Feld für die Richtung erforderlich, damit das Ereignis in der richtigen Fahrtrichtung angezeigt wird. <direction>BOTH_DIRECTIONS</direction> |
| Straße | Erforderlich | Freier Text | Gibt den Namen der Straße an, auf der das Ereignis auftritt. Sollte mit der Waze-Karte übereinstimmen. <street>NW 12th St</street> |
| Startzeit | Erforderlich | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Gibt das Start-Datum für einen Zeitraum der Unterbrechung an. Sie können ihn für Vorfälle auslassen, die nicht vom Typ ROAD_CLOSED sind. Wir gehen davon aus, dass der Vorfall derzeit aktiv ist. Der Zeitstempel muss im ISO8601-Format (in Sekunden) vorliegen und den Zeitzonenversatz enthalten. <starttime>2023-04-07T09:00:00+01:00</starttime> |
| Endzeit | Angefordert | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Geben Sie das Datum für das Ende im ISO8601-Format in Sekunden an und fügen Sie den Zeitzonenversatz hinzu. Wenn Sie diesen Wert weglassen, wird standardmäßig 14 Tage nach dem Beginn verwendet. <endtime>2023-04-07T23:00:00+01:00</endtime> |
| Beschreibung | Angefordert | Freier Text | Die Ursache der Verkehrsstörung. Die Beschreibung sollte kürzer als 40 Zeichen sein. Beschreibungen mit mehr als 40 Zeichen werden zwar akzeptiert, aber in der Waze App möglicherweise nicht richtig angezeigt. <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> |
| Spurausschlag | optional | strukturierte Informationen zu Auswirkungen von Fahrstreifen | Machen Sie dies nur, wenn der Vorfall nicht mit einer vollständigen Straßensperrung verbunden ist.
Geben Sie Informationen zu allen Fahrspuren an, indem Sie ein Fahrspur-Array im WZDx-Spurformat oder einem ähnlichen Format angeben.
Beispiel für vollständiges Format: <lanes>
<lane>
<order>1</order>
<type>LANE</type>
<status>CLOSED</status>
</lane>
<lane>
<order>2</order>
<type>LANE</type>
<status>OPEN</status>
</lane>
</lanes>
Beispiel für Teilformat: <lane_impact> <total_closed_lanes>2</total_closed_lanes> <roadside>RIGHT</roadside> </lane_impact> |
| Spielplan | Optional | <dayname>hh:mm-hh:mm</dayname> |
Kapselt alle Start- und Endzeiten für den Vorfall ein. <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> |
Untertypen von Vorfällen und Schließungen
Geben Sie weitere Details zur Art des Vorfalls an. Die zulässigen Untertypen hängen vom angegebenen Typ ab.
| Typ | Mögliche Untertypen |
|---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|