Specyfikacja CIFS
CIFS (Closure and Incident Feed Specification) to standardowy protokół Waze służący do opisywania incydentów i zamknięcia dróg w plikach danych partnerów.
Tabela parametrów poniżej klasyfikuje poszczególne elementy w ten sposób:
- Wymagane: jeśli tag wymagany nie ma prawidłowo sformatowanej wartości, plik danych jest uznawany za nieprawidłowy.
- Wymagane: tagi wymagane nie są technicznie wymagane, ale zalecamy ich używanie.
- Opcjonalnie: tagi opcjonalne, które umożliwiają podanie dodatkowych danych.
Kolejność elementów nie ma znaczenia dla mechanizmu analizującego plik.
Te tagi mogą opisywać incydent lub zamknięcie drogi w zależności od wartości tagu type.
W razie potrzeby wyjaśniliśmy drobne różnice.
Oto przykłady zamknięcia dróg w pliku danych
Oto przykłady wypadków w pliku danych
Pamiętaj, że w tym samym pliku danych możesz łączyć informacje o zamknięciu dróg i wypadkach.
Elementy CIFS
| Element | Wymagane | Dane wejściowe tagu | Opis |
|---|---|---|---|
| identyfikator zdarzenia | Wymagane | Dowolny tekst | Określa identyfikator alfanumeryczny lub liczbowy.
<incident id="LND11DEayKr">...</incident> |
| typ | Wymagane | Jeden z tych elementów:ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
Typ określa sposób, w jaki aplikacja Waze będzie używać Twojego zdarzenia.
Wszystkie inne typy będą wyświetlane na mapie Waze i wywoływać wyskakujące powiadomienie dla znajdujących się w pobliżu użytkowników Waze, 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 typu zgłoszonego incydentu.
|
| linia łamana | Wymagane | Lista par lat lon rozdzielonych spacjami |
współrzędne szerokości i długości geograficznej w stopniach dziesiętnych (DD, projekcja SRID 4326), które opisują lokalizację zdarzenia lub zamknięcia drogi; W idealnej sytuacji powinny zawierać co najmniej 6 cyfr po przecinku, aby zapewnić wystarczającą dokładność. Kolejność współrzędnych musi odzwierciedlać kierunek ruchu, którego dotyczy zmiana. Nie możemy określić kierunku ruchu na podstawie jednego punktu. Podana poniżej linia łamana będzie miała wpływ na jeden kierunek ruchu (dodanie elementu <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 przerwa lub zamknięcie drogi dotyczy jednego czy obu kierunków ruchu. Zdecydowanie zalecamy podanie wskazówek, nawet jeśli została podana linia łamana. Jeśli można podać tylko 1 zbiór współrzędnych, pole kierunek jest wymagane, aby zdarzenie było wyświetlane w prawidłowym 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 czas rozpoczęcia jednego okresu przerwy. W przypadku zdarzeń innych niż typu ROAD_CLOSED możesz go pominąć. Zdarzenie zostanie uznane za aktywne. Sygnatura czasowa musi być w formacie ISO 8601 z dokładnością do sekundy i uwzględniać 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 |
Podaj datę i godzinę zakończenia w formacie ISO 8601 z dokładnością do sekundy. Pamiętaj o podaniu przesunięcia strefy czasowej. Jeśli pominiesz to pole, domyślnie zostanie ustawiony okres 14 dni od daty rozpoczęcia. <endtime>2023-04-07T23:00:00+01:00</endtime> |
| opis | Wysłano prośbę | Dowolny tekst | Przyczyna zakłócenia ruchu. Opis powinien mieć mniej niż 40 znaków. Opis zawierający więcej 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 | Podaj tę informację tylko wtedy, gdy zdarzenie nie wiąże się z całkowitym zamknięciem drogi.
Podaj informacje o wszystkich pasach, określając tablicę pasów 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 formatu częściowego: <lane_impact> <total_closed_lanes>2</total_closed_lanes> <roadside>RIGHT</roadside> </lane_impact> |
| harmonogram | Opcjonalnie | <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 incydentów i zamknięć
Podaj więcej szczegółów dotyczących charakteru incydentu. Akceptowane podtypy są określane na podstawie podanego typu.
| Typ | Możliwe podtypy |
|---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|