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.

Informacje o zamknięciach dróg podawaj 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 były wyświetlane na mapie, postępuj zgodnie z podawanymi niżej wskazówkami i specyfikacjami 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.

W przypadku niekompletnych lub niezgodnych danych zamknięcia nie będą automatycznie wyświetlane na mapie, ale zostaną wysłane do naszej społeczności edytorów jako „problem z mapą” do ręcznego sprawdzenia, zatwierdzenia lub odrzucenia.

Udostępnianie zamknięcia

1. Określanie tagu zamknięcia

Aby zmapować zamknięcie drogi, jako dane wejściowe tagu elementu type podaj wartość 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 w linii łamanej wskazuje, który kierunek ruchu jest dotknięty.
direction wskazuje, czy zamknięcie dotyczy jednego czy obu kierunków ruchu.

W przypadku zamknięcia dróg jednokierunkowych:

Kolejność punktów w linii łamanej musi odpowiadać kierunkowi ruchu.
Aby uniknąć niejednoznaczności i różnic w mapowaniu, zalecamy podanie ONE_DIRECTION nawet w przypadku dróg jednokierunkowych.

W przypadku zamknięcia dróg 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 dotyczy obu kierunków: udostępnij polilinię i w polu kierunek wskaż 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 będzie w stanie ją poprawnie dopasować i przetworzyć.
Zdecydowanie zalecamy podanie wielu punktów dla każdego segmentu między współrzędnymi początkowymi i końcowymi. Podanie tylko 2 współrzędnych może wystarczyć w przypadku krótkich lub prostych odcinków, ale często powoduje błędy przetwarzania.
Poniższa polilinia prawidłowo zachowuje ogólny kształt drogi:

Poniższa linia wielokąta nie odzwierciedla wyraźnie 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 zastosowana blokada może być dłuższa lub nieco krótsza niż polilinia, ponieważ Waze może zamykać tylko całe segmenty skonfigurowane 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 były od siebie oddalone o co najmniej 30 metrów.
Długość dostarczonego wielokąta 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 zostanie podana dokładna linia poliliniowa.
- 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: I-95S, I-95 Southbound i JFK Memorial Highway zostaną dopasowane 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 miasta
- Rampy
- drogi prywatne.
Nie można zgłaszać zamknięcia dróg dla pieszych.
Czas rozpoczęcia:
- Musisz podać czas rozpoczęcia zamknięcia.
- Jeśli nie masz pewności co do godziny rozpoczęcia, możesz użyć sygnatury czasowej raportu początkowego.
- Modyfikacje godziny rozpoczęcia:
Czas zakończenia:
- Jeśli nie znasz godziny zakończenia, pozostaw to pole puste. Zamknięcia bez godziny zakończenia będą miały domyślny czas trwania (obecnie 2 tygodnie), a następnie wygasną, chyba że zostaną rozszerzone przez podanie nowej godziny zakończenia. Po opublikowaniu wydarzenia możesz zmienić czas zakończenia, ale nie ustawiaj go dynamicznie 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 jednej drogi w formacie XML i JSON.

Zamknięcie XML

Oto 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 jedno zamknięcie 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 dróg w formacie XML i JSON.

Plik danych 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ładowy plik 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"
    }
  ]
}