Informacje o zamknięciu drogi

Dzięki plikowi danych partnerów Waze możesz automatycznie i na dużą skalę podawać planowane i w czasie rzeczywistym informacje o zamknięciu dróg.

Planowane zamknięcia dróg, które wysyłasz do Waze, pojawią się w Edytorze Map Waze i w aplikacji Waze w czasie zamknięcia drogi.

Podawaj zamknięte drogi tylko wtedy, gdy wszystkie pasy są zamknięte. Jeśli zamknięcie wpływa tylko na niektóre pasy, w elemencie „Wpływ na pas” podaj te pasy.

Aby zamknięte drogi wyświetlały się prawidłowo na mapie, musisz przestrzegać poniższych wytycznych i specyfikacji CIFS.

Jeśli Twój plik danych nie jest zgodny ze specyfikacją CIFS, ale zawiera wszystkie wymagane dane, Waze może go przetworzyć. Prześlij plik danych przez Centrum Partnerów, aby go zweryfikować i przekazać opinię.

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

Udostępnianie zamkniętej drogi

1. Określ tag zamknięcia

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

2. Określanie struktury zamknięcia

Aby udostępnić Waze informacje o zamknięciu drogi, podaj polyline (wymagane) i direction (wymagane).

• Linie łamane to sekwencje współrzędnych biegnących wzdłuż geometrii drogi i opisujące odcinek drogi, który powinien zostać zamknięty.
• Kolejność współrzędnych na linii łamanej wskazuje kierunek ruchu, którego to dotyczy.
• direction wskazuje, czy droga jest zamknięta w jednej z nich czy w obu kierunkach.

Zamknięcie drogi jednokierunkowej:

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

Zamknięcia dróg dwukierunkowych:

• Jeśli zamknięcie dotyczy tylko jednego kierunku, kolejność współrzędnych na linii łamanej wskazuje kierunek ruchu, który mamy zamknąć.
• Jeśli zamknięcie drogi dotyczy obu kierunków: udostępnij linię łamaną, a w polu kierunku wskaż BOTH_DIRECTIONS.

W przypadku linii łamanej rozciągającej się od punktu A do punktu B zamknięcie wpłynie na kierunek ruchu w zależności od kierunku i typu drogi, tak jak to pokazano poniżej:

3. Kształtowanie linii łamanej

• Im ściślej linia łamana odzwierciedla geometrię drogi, tym większe prawdopodobieństwo, że Waze będzie w stanie poprawnie ją dopasować i przyjąć informację o zamknięciu drogi.
  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 fragmentów, ale często jest przyczyną błędów przetwarzania.
  Poniższa linia łamana prawidłowo zachowuje ogólny kształt drogi:
  

  
  Poniższa linia łamana nie odzwierciedla wyraźnie geometrii drogi, ponieważ zawiera tylko współrzędne początkowe i końcowe:
  
  

• Waze użyje podanej przez Ciebie linii łamanej, aby zastosować zdarzenie do co najmniej jednego segmentu na mapie Waze. Pamiętaj, że 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 konfiguracją mapy Waze.
• Jeśli wskażesz do zamknięcia tylko część segmentu, zostanie on zamknięty.
• Zaleca się, aby odległość między punktem początkowym a końcowym zamknięciem wynosiła co najmniej 30 metrów.
• Długość zamknięcia nie powinna przekraczać 20 km.

4. Dopilnuj, aby zamknięcie witryny było zgodne z tymi wytycznymi:

• Nazwy ulic
  • Zamknięcia mogą mieć wpływ tylko na jedną ulicę lub drogę na mapie Waze. Współrzędne początkowego i końcowego zamknięcia muszą mieć taką samą nazwę ulicy. Zgłoszone zamknięcie, które obejmuje różne nazwy ulic, prawdopodobnie nie zostanie przetworzone, nawet jeśli podasz dokładną linię łamaną.
  • Waze spróbuje dopasować podaną przez Ciebie nazwę ulicy do nazw dróg głównych lub alternatywnych na mapie w zgłoszonej lokalizacji. Pełne lub częściowe dopasowanie pomoże nam poprawnie określić, którą drogę należy zamknąć, zwłaszcza w przypadku wielu kandydatów.
    • Przykład: drogi I-95S, I-95 Southbound i JFK Memorial Road zostałyby dopasowane do tej samej drogi.
  • Aby mieć pewność, że nazwy ulic i dróg podane w informacjach o aplikacji są zgodne z nazwami na mapie Waze, użyj interfejsu Reverse Geocoding API lub użyj Edytora Map Waze.
• Zamknięte pliki danych można zamknąć tylko w przypadku tych typów dróg w Waze:
  • Autostrady
  • Drogi ekspresowe
  • Ulice miasta
  • Rampy
  • Drogi prywatne
• Typy dróg w Waze, których nie można zamknąć za pomocą pliku danych:
  • Drogi na parkingach
  • Drogi w terenie (4 x 4) i drogi dla pieszych
• Czas rozpoczęcia i zakończenia:
  • Godzina 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 początkowego raportu, ale NIE zmieniaj go po opublikowaniu zdarzenia.
  • Czas zakończenia: jeśli nie znasz godziny zakończenia, pozostaw to pole puste. Zamknięcia bez podanej godziny zakończenia będą miały ustawiony domyślny czas trwania (obecnie 2 tygodnie), który wygasną, chyba że zostanie wyraźnie przedłużony przez określenie nowego czasu zakończenia. Po opublikowaniu wydarzenia możesz zmienić godzinę zakończenia, ale nie ustawiaj jej dynamicznie na podstawie bieżącej godziny.

  Bardziej szczegółowe specyfikacje tagów Closure and Incident Feed Specification (CIFS) znajdziesz w specyfikacji CIFS.

  Przykłady zamknięcia

  W podanych niżej przykładach pokazano zamknięcie pojedynczej drogi w formatach XML i JSON.

  Zakończenie kodu XML

  Poniżej znajduje się przykład pliku danych zawierającego zamknięcie pojedynczej drogi 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>2016-04-07T09:00:00+01:00</starttime>
      <endtime>2016-04-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 znajduje się przykład pliku danych w formacie JSON zawierającego informacje o pojedynczej zamknięciu drogi:

  {
    "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": "2016-04-07T09:00:00+01:00",
          "endtime": "2016-04-07T23:00:00+01:00",
          "description": "Closure on I-95 NB due to construction",
          "direction": "BOTH_DIRECTIONS"
        }
      }
    ]
  }

  W przykładach poniżej pokazujemy cały plik danych o zamknięciu drogi, zarówno w formacie XML, jak i JSON.

  Plik danych w formacie XML

  Poniżej znajduje się przykład pliku danych o pełnym zamknięciu drogi 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>2017-07-04T13:31:17-04:00</creationtime>
        <updatetime>2017-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>2017-06-05T00:01:00-04:00</starttime>
        <endtime>2017-11-22T15:30:00-05:00</endtime>
      </incident>
      <incident id="zxf3kvmrpf">
        <creationtime>2017-08-04T13:31:30-04:00</creationtime>
        <updatetime>2017-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>2017-04-18T00:01:00-04:00</starttime>
        <endtime>2017-12-31T23:59:00-05:00</endtime>
      </incident>
  </incidents>

  Plik danych JSON

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

  {
    "incidents": [
      {
        "id": "3f4r45ff233",
        "creationtime": "2017-07-04T13:31:17-04:00",
        "updatetime": "2017-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": "2017-06-05T00:01:00-04:00",
        "endtime": "2017-11-22T15:30:00-05:00",
        "type": "ROAD_CLOSED"
      },
      {
        "id": "zxf3kvmrpf",
        "creationtime": "2017-08-04T13:31:30-04:00",
        "updatetime": "2017-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": "2017-04-18T00:01:00-04:00",
        "endtime": "2017-12-31T23:59:00-05:00"
      }
    ]
  }