Specyfikacja CIFS
CIFS (Closure and Incident Feed Specification) to standardowy protokół Waze do opisywania incydentów i zamknięć dróg w plikach danych partnerów.
W tabeli parametrów poniżej każdy element jest sklasyfikowany w ten sposób:
- Wymagane: jeśli w wymaganym tagu nie ma prawidłowo sformatowanej wartości, plik danych jest uznawany za nieprawidłowy.
- Wymagane: tagi wymagane nie są technicznie niezbędne, ale są zalecane.
- Opcjonalnie: tagi opcjonalne, które umożliwiają podanie większej ilości danych.
Kolejność elementów nie ma znaczenia dla silnika analizującego plik.
Tagi te mogą opisywać incydent lub zamknięcie drogi w zależności od wartości tagu type.
W odpowiednich miejscach wyjaśniamy drobne różnice.
Oto przykłady zamknięć dróg w pliku danych:
Oto przykłady zdarzeń w pliku danych:
Pamiętaj, że w tym samym pliku danych możesz łączyć zamknięcia dróg i zdarzenia.
Elementy CIFS
| Element | Wymagane | Wpisywanie tagów | Opis |
|---|---|---|---|
| identyfikator zdarzenia | Wymagane | Dowolny tekst | Określa identyfikator alfanumeryczny lub numeryczny.
<incident id="LND11DEayKr">...</incident> |
| typ | Wymagane | Jedna z tych wartości:ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
Typ określa sposób, w jaki aplikacja Waze będzie interpretować Twoje zdarzenie.
Wszystkie inne typy będą wyświetlane na mapie Waze i będą wywoływać wyskakujące powiadomienia dla użytkowników Waze w pobliżu, ale nie będą miały bezpośredniego wpływu na wyznaczanie trasy. <type>ROAD_CLOSED</type> |
| podtyp | Wysłano prośbę | Zobacz listę dozwolonych podtypów | Dokładniejszy opis rodzaju zgłoszonego incydentu.
|
| linia łamana | Wymagane | Lista par lat lon rozdzielonych spacjami |
Współrzędne geograficzne (DD, projekcja SRID 4326) opisujące lokalizację incydentu lub zamknięcia drogi. Aby zapewnić wystarczającą dokładność, powinny one mieć co najmniej 6 cyfr po przecinku. Kolejność współrzędnych musi odzwierciedlać kierunek ruchu, którego dotyczy problem. Nie możemy określić kierunku ruchu na podstawie jednego punktu. Ta linia łamana będzie miała wpływ na jeden kierunek ruchu (aby wpłynąć na oba kierunki, dodaj element <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 | Wysłano prośbę | BOTH_DIRECTIONS lub ONE_DIRECTION |
Określa, czy utrudnienie lub zamknięcie dotyczy jednego czy obu kierunków ruchu na drodze. Zdecydowanie zalecamy podanie kierunku, nawet jeśli podana jest linia łamana. Jeśli można podać tylko jeden zestaw współrzędnych, pole kierunku jest wymagane, aby zdarzenie było wyświetlane we właściwym kierunku jazdy. <direction>BOTH_DIRECTIONS</direction> |
| ulica | Wymagane | Dowolny tekst | Określa nazwę ulicy lub drogi, na której występuje zdarzenie. <street>NW 12th St</street> |
| starttime | Wymagane | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Określa datę i godzinę rozpoczęcia jednego okresu zakłóceń. W przypadku zdarzeń, które nie są typu ROAD_CLOSED, możesz pominąć ten element. Założymy wtedy, że zdarzenie jest obecnie aktywne. Sygnatura czasowa musi być w formacie ISO 8601 z dokładnością do sekundy i zawierać przesunięcie strefy czasowej. <starttime>2023-04-07T09:00:00+01:00</starttime> |
| endtime | Wysłano prośbę | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Określ datę i godzinę zakończenia w formacie ISO 8601 z dokładnością do sekundy i uwzględnij przesunięcie strefy czasowej. Jeśli pominiesz ten parametr, domyślnie będzie on wynosić 14 dni od czasu rozpoczęcia. <endtime>2023-04-07T23:00:00+01:00</endtime> |
| opis | Wysłano prośbę | Dowolny tekst | Przyczyna utrudnień w ruchu. Opis powinien mieć mniej niż 40 znaków. Opis dłuższy niż 40 znaków zostanie zaakceptowany, ale może nie wyświetlać się prawidłowo w aplikacji Waze. <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> |
| wpływ na pas ruchu, | opcjonalnie | uporządkowane informacje o wpływie na pas ruchu, | Podawaj dane o wpływie na pas ruchu tylko wtedy, gdy incydent nie powoduje całkowitego zamknięcia drogi i dotyczy tylko jednego kierunku ruchu.
Podaj informacje o wszystkich pasach ruchu, określając tablicę pasów ruchu w formacie WZDx lub podobnym.
Przykład pełnego formatu: <lanes>
<lane>
<order>1</order>
<type>LANE</type>
<status>CLOSED</status>
</lane>
<lane>
<order>2</order>
<type>LANE</type>
<status>OPEN</status>
</lane>
</lanes>
Przykład formatowania częściowego: <lane_impact> <total_closed_lanes>2</total_closed_lanes> <roadside>RIGHT</roadside> </lane_impact> |
| harmonogram | Opcjonalny | <dayname>hh:mm-hh:mm</dayname> |
Zawiera wszystkie daty i godziny rozpoczęcia i zakończenia incydentu. <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> |
Podtypy zdarzeń i zamknięć
Podaj więcej szczegółów dotyczących charakteru incydentu. Dopuszczalne podtypy są określane przez podany typ.
| Typ | Możliwe podtypy |
|---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|