Ta strona została przetłumaczona przez Cloud Translation API.

Informacje o zamknięciu drogi

Możesz używać pliku danych partnera Waze, aby automatycznie i na dużą skalę udostępniać informacje o planowanych i aktualnych zamknięciach dróg.

Planowane zamknięcia dróg, które wyślesz do Waze, pojawią się w Edytorze Map Waze i w aplikacji Waze w okresie zamknięcia.

Podawaj informacje o zamknięciach dróg tylko w przypadku, gdy zamknięte są wszystkie pasy na drodze. Jeśli zamknięcie dotyczy tylko niektórych pasów, opisz te pasy w elemencie dotyczącym wpływu na pasy.

Aby zamknięcia dróg wyświetlały się prawidłowo na mapie, postępuj zgodnie z poniższymi wskazówkami i specyfikacją CIFS.

Jeśli plik danych nie jest zgodny ze specyfikacją CIFS, ale zawiera wszystkie wymagane dane, Waze może go nadal przetwarzać. Prześlij plik danych za pomocą Centrum Partnera w celu weryfikacji i uzyskania opinii.

Jeśli dane będą niekompletne lub niezgodne, informacje o zamknięciach nie pojawią się automatycznie na mapie, ale zostaną wysłane do naszej Społeczności wydawców jako „problem z mapą” do ręcznego sprawdzenia, zatwierdzenia lub odrzucenia.

Udostępnianie informacji o zamknięciu

1. Określanie tagu zamknięcia

Aby zmapować zamknięcie drogi, jako dane wejściowe tagu elementu type podaj ROAD_CLOSED.

2. Struktura zakończenia

Aby udostępnić Waze informacje o zamknięciu, określ polyline (wymagany) i direction (żądany).

Polilinie to ciągi współrzędnych, które naśladują geometrię drogi i określają odcinek drogi, który powinien zostać zamknięty.
Kolejność współrzędnych na linii łamanej mówi nam, w którym kierunku zmienia się ruch.
direction wskazuje, czy zamknięcie dotyczy jednego czy obu kierunków ruchu.

W przypadku zamknięcia dróg jednokierunkowych:

Kolejność punktów na linii łamanej musi odpowiadać kierunkowi ruchu.
Aby uniknąć niejasności i pokonać różnice w mapowaniu, zalecamy określenie wartości ONE_DIRECTION nawet w przypadku dróg jednokierunkowych.

Zamknięcia na drogach dwukierunkowych:

Jeśli zamknięcie dotyczy tylko jednego kierunku: kolejność współrzędnych w linii łamanej wskazuje, który kierunek ruchu ma zostać zamknięty.
Jeśli zamknięcie występuje w obu kierunkach: udostępnij linię łamaną oraz w polu kierunku podaj BOTH_DIRECTIONS.

W przypadku ścieżki wielokąta z punktu A do punktu B zamknięcie będzie miało wpływ na kierunek ruchu w zależności od kierunku i rodzaju drogi, jak pokazano poniżej:

Ilustracja pokazująca działanie linii łamanych i kierunków.

3. Kształtowanie linii łamanej

Im bardziej linia łamana przypomina geometrię drogi, tym większe prawdopodobieństwo, że Waze dopasuje ją prawidłowo i przetworzy zamknięcie drogi.
Zdecydowanie zalecamy podanie większej liczby punktów dla każdego fragmentu pomiędzy współrzędnymi początkowymi i końcowymi. Podanie tylko 2 współrzędnych może wystarczą w przypadku krótkich lub prostych odcinków, ale często jest przyczyną problemów z przetwarzaniem.
Poniższa polilinia prawidłowo zachowuje ogólny kształt drogi:

Poniższa linia wielokąta nie odzwierciedla dokładnie geometrii drogi, ponieważ zawiera tylko współrzędne początkowe i końcowe:
Waze użyje przekazanej przez Ciebie ścieżki wielokąta, aby zastosować zdarzenie w jednym lub większej liczbie segmentów na mapie Waze. Pamiętaj, że zastosowane zamknięcie może być dłuższe lub nieco krótsze niż linia łamana, ponieważ Waze może zamykać tylko całe segmenty zgodnie z ustawieniami na mapie Waze.
Jeśli określisz tylko część segmentu do zamknięcia, cały segment zostanie zamknięty.
Zalecamy, aby punkt początkowy i końcowy zamknięcia znajdował się w odległości co najmniej 30 metrów.
Długość linii łamanej nie powinna przekraczać 20 km.

4. Upewnij się, że zamknięcie jest zgodne z tymi wytycznymi:

Nazwy ulic
- Zamknięcia mogą dotyczyć tylko jednej ulicy lub drogi na mapie Waze. współrzędne początku i końca zamknięcia muszą mieć tę samą nazwę ulicy. Zgłoszone zamknięcie, które obejmuje różne nazwy ulic, prawdopodobnie nie zostanie przetworzone, nawet jeśli podana jest dokładna linia łamana.
- Waze spróbuje dopasować podany przez Ciebie adres ulicy do nazwy głównej lub alternatywnej na mapie Waze w zgłoszonej lokalizacji. Zgodność pełna lub częściowa pomoże nam poprawnie określić, którą drogę zamknąć, zwłaszcza gdy jest ich kilka.
  - Przykład: droga I-95S, I-95 w kierunku południowym oraz JFK Memorial Trail zostanie prawidłowo dopasowana do tej samej drogi.
- Aby mieć pewność, że nazwy ulic i dróg podane w Twoim profilu są zgodne z tymi na mapie Waze, użyj interfejsu API do odwrotnego geokodowania lub otwórz Edytor Map Waze.
Zamknięcia dróg można wprowadzać tylko w przypadku tych typów dróg w Waze:
- autostrady,
- Drogi ekspresowe
- Ulice miejskie
- Rampy
- drogi prywatne;
Nie można zgłaszać zamknięcia dróg dla pieszych.
Czas rozpoczęcia:
- Musisz podać godzinę rozpoczęcia zamknięcia.
- Jeśli nie masz pewności co do godziny rozpoczęcia, możesz użyć sygnatury czasowej pierwotnego raportu.
- Modyfikacje czasu rozpoczęcia:
Czas zakończenia:
- Jeśli nie znasz godziny zakończenia, pozostaw to pole puste. Zamknięcia bez czasu zakończenia będą miały domyślny czas trwania (obecnie 2 tygodnie), a następnie wygasną, chyba że zostaną rozszerzone przez podanie nowego czasu zakończenia. Po opublikowaniu wydarzenia możesz zmienić godzinę zakończenia, ale unikaj dynamicznego ustawiania czasu zakończenia na podstawie bieżącej godziny.

Więcej informacji o tagach w specyfikacji pliku danych o zamknięciach i incydentach (CIFS) znajdziesz w specyfikacji CIFS.

Przykłady zamknięć

Poniższe przykłady pokazują zamknięcie pojedynczej drogi w formatach XML i JSON.

Zamknięcie XML

Poniżej znajduje się przykład pliku danych zawierającego jedną zamkniętą drogę w formacie XML:

<incidents>
  <incident id="101">
    <type>ROAD_CLOSED</type>
    <subtype>ROAD_CLOSED_CONSTRUCTION</subtype>
    <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>
    <street>NW 12th St</street>
    <starttime>2024-06-07T09:00:00+01:00</starttime>
    <endtime>2024-06-07T23:00:00+01:00</endtime>
    <description>Closure on I-95 NB due to construction</description>
    <direction>BOTH_DIRECTIONS</direction>
  </incident>
</incidents>

Zamknięcie JSON

Poniżej znajdziesz przykład pliku danych zawierającego zamknięcie jednej drogi w formacie JSON:

{
  "incidents": [
    {
      "incident": {
        "id": "101",
        "type": "ROAD_CLOSED",
        "subtype": "ROAD_CLOSED_CONSTRUCTION",
        "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",
        "street": "NW 12th St",
        "starttime": "2024-06-07T09:00:00+01:00",
        "endtime": "2024-06-07T23:00:00+01:00",
        "description": "Closure on I-95 NB due to construction",
        "direction": "BOTH_DIRECTIONS"
      }
    }
  ]
}

Poniższe przykłady pokazują cały plik danych o zamknięciu drogi w formacie XML oraz Formaty JSON.

Plik danych w formacie XML

Poniżej znajdziesz przykład pełnego pliku danych o zamkniętych drogach w formacie XML:

<?xml version="1.0" ?>
<incidents xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://www.gstatic.com/road-incidents/cifsv2.xsd">
    <incident id="3f4r45ff233">
      <creationtime>2024-07-04T13:31:17-04:00</creationtime>
      <updatetime>2024-11-17T04:40:41-05:00</updatetime>
      <type>ROAD_CLOSED</type>
      <description>Complete road closure due to road works</description>
      <street>N Liberty St</street>
      <direction>BOTH_DIRECTIONS</direction>
      <polyline>42.1601432984533 -119.3525208937842 42.1781676611244 -119.35679623266</polyline>
      <starttime>2024-06-05T00:01:00-04:00</starttime>
      <endtime>2024-11-22T15:30:00-05:00</endtime>
    </incident>
    <incident id="zxf3kvmrpf">
      <creationtime>2024-08-04T13:31:30-04:00</creationtime>
      <updatetime>2024-12-17T04:40:41-05:00</updatetime>
      <type>ROAD_CLOSED</type>
      <subtype>ROAD_CLOSED_CONSTRUCTION</subtype>
      <description>PLANNED ROAD CLOSURE St Johns Sdrd from William Graham to Woodbine in the Town of Aurora. Closed until Dec 31.</description>
        <street>St John's Sideroad</street>
        <direction>BOTH_DIRECTIONS</direction>
        <polyline>44.02712 -99.43131 44.023011 -99.363349 44.02712 -99.43131 44.0343021 -99.399426</polyline>
      <starttime>2024-04-18T00:01:00-04:00</starttime>
      <endtime>2024-12-31T23:59:00-05:00</endtime>
    </incident>
</incidents>

Plik danych w formacie JSON

Poniżej znajdziesz przykład kompletnego pliku danych o zamknięciu drogi w formacie JSON:

{
  "incidents": [
    {
      "id": "3f4r45ff233",
      "creationtime": "2024-07-04T13:31:17-04:00",
      "updatetime": "2024-11-17T04:40:41-05:00",
      "description": "Complete road closure due to road works",
      "street": "N Liberty St",
      "direction": "BOTH_DIRECTIONS",
      "polyline": "42.1601432984533 -119.3525208937842 42.1781676611244 -119.35679623266",
      "starttime": "2024-06-05T00:01:00-04:00",
      "endtime": "2024-11-22T15:30:00-05:00",
      "type": "ROAD_CLOSED"
    },
    {
      "id": "zxf3kvmrpf",
      "creationtime": "2024-08-04T13:31:30-04:00",
      "updatetime": "2024-12-17T04:40:41-05:00",
      "description": "St Johns Sdrd from William Graham to Woodbine in the Town of Aurora. Closed until Dec 31. ",
      "type": "ROAD_CLOSED",
      "subtype": "ROAD_CLOSED_CONSTRUCTION",
      "street": "St John's Sideroad",
      "direction": "BOTH_DIRECTIONS",
      "polyline": "44.02712 -99.43131 44.023011 -99.363349 44.02712 -99.43131 44.0343021 -99.399426",
      "starttime": "2024-04-18T00:01:00-04:00",
      "endtime": "2024-12-31T23:59:00-05:00"
    }
  ]
}