Informazioni sulle chiusure stradali

Puoi utilizzare il feed Waze Partner per fornire chiusure stradali pianificate e in tempo reale in modo automatico e su larga scala.

Le chiusure pianificate che invii a Waze verranno visualizzate in Waze Map Editor e nell'app Waze durante l'orario effettivo della chiusura.

Fornisci le chiusure stradali solo nel caso in cui tutte le corsie della strada siano chiuse. Se la chiusura interessa solo alcune corsie, descrivi le corsie interessate nell'elemento relativo all'impatto sulle corsie.

Affinché le chiusure stradali vengano visualizzate con precisione sulla mappa, devi seguire le linee guida riportate di seguito e le specifiche CIFS.

Se il tuo feed non è conforme alle specifiche CIFS, ma include tutti i dati richiesti, Waze potrebbe comunque essere in grado di elaborarlo. Invia il tuo feed tramite Partner Hub per la convalida e il feedback.

In caso di dati incompleti o incompatibili, le chiusure non verranno visualizzate automaticamente sulla mappa, ma verranno inviate alla nostra community di editor come "problema con la mappa" per la revisione, l'approvazione o il rifiuto manuale.

Condivisione di una chiusura

1. Specifica il tag di chiusura

Per mappare una chiusura stradale, specifica ROAD_CLOSED come input del tag dell'elemento type.

2. Strutturare la chiusura

Per condividere una chiusura con Waze, specifica un polyline (obbligatorio) e un direction (richiesto).

  • I polilinee sono sequenze di coordinate che seguono la geometria della strada e descrivono il tratto di strada che deve essere chiuso.
  • L'ordine delle coordinate nella polilinea indica la direzione di traffico interessata.
  • direction indica se la chiusura si applica a una o a entrambe le direzioni di marcia.

Per le chiusure su strade a senso unico:

  • L'ordine dei punti nella polilinea deve corrispondere alla direzione di marcia.
  • Per evitare ambiguità e superare le differenze di mappatura, ti consigliamo di specificare ONE_DIRECTION anche per le strade a senso unico.

Per le chiusure su strade a doppio senso di marcia:

  • Se la chiusura interessa una sola direzione: l'ordine delle coordinate nella polilinea ci indica la direzione di traffico da chiudere.
  • Se la chiusura interessa entrambe le direzioni: condividi il polilinea e nel campo direzione indica BOTH_DIRECTIONS.

Per un polilinea che si estende dal punto A al punto B, la chiusura influirà sulla direzione del traffico in base alla direzione e al tipo di strada, come mostrato di seguito:

Un'immagine che spiega il comportamento delle polilinee e delle indicazioni stradali.

3. Dai forma alla polilinea

  • Più la polilinea assomiglia alla geometria della strada, più è probabile che Waze possa associarla correttamente ed elaborare la chiusura.
    È vivamente consigliato fornire più punti per ogni segmento tra le coordinate di inizio e di fine. Fornire solo due coordinate può essere sufficiente per segmenti brevi o dritti, ma spesso è causa di errori di elaborazione.
    Il seguente polilinea mantiene correttamente la forma generale della strada:

    Immagine polilinea utilizzata nel contesto.
    Il seguente polilinea non riflette chiaramente la geometria della strada in quanto fornisce solo le coordinate di inizio e di fine:

    Immagine polilinea utilizzata nel contesto.

  • Waze utilizzerà il polilinea che hai fornito per applicare l'evento a uno o più segmenti sulla mappa di Waze. Tieni presente che la chiusura applicata potrebbe essere più lunga o leggermente più corta del polilinea, poiché Waze può chiudere solo interi segmenti come configurato sulla mappa di Waze.
  • Se specifichi solo una parte del tratto da chiudere, verrà chiuso l'intero tratto.
  • È consigliabile che i punti di inizio e di fine di una chiusura siano distanti almeno 30 metri.
  • La lunghezza del polilinea fornito non deve superare i 20 km.

4. Assicurati che la chiusura rispetti queste linee guida:

  • Nomi delle strade
    • Le chiusure possono interessare una sola strada sulla mappa di Waze. Le coordinate di inizio e fine della chiusura devono avere lo stesso nome di via. È probabile che l'elaborazione di una chiusura segnalata che si estende su diversi nomi di strade non vada a buon fine, anche se viene fornito un polilinea esatto.
    • Waze tenterà di associare il nome della strada che fornisci ai nomi delle strade principali o alternative sulla mappa di Waze nella località segnalata. Una corrispondenza completa o parziale ci aiuterà a identificare correttamente la strada da chiudere, in particolare quando sono presenti più strade idonee.
      • Esempio: I-95S, I-95 Southbound e JFK Memorial Highway verrebbero associate correttamente alla stessa strada.
    • Per assicurarti che i nomi delle strade e delle vie che fornisci nella tua scheda corrispondano a quelli nella mappa di Waze, utilizza l'API di geocodifica inversa di Waze o controlla Waze Map Editor.
  • Le chiusure del feed possono essere effettuate solo sui seguenti tipi di strade di Waze:
    • Autostrade
    • Autostrade
    • Strade urbane
    • Rampe
    • Strade private
  • Non è possibile segnalare chiusure stradali su strade pedonali.
  • Ora di inizio:
    • ​Devi fornire un'ora di inizio per una chiusura.
    • Se hai dubbi sull'ora di inizio, puoi utilizzare il timestamp del report iniziale.
    • Modifiche all'ora di inizio:
      • Chiusure attive: una volta trascorsa l'ora di inizio di una chiusura (ovvero quando la chiusura è attiva), l'ora di inizio non deve essere modificata.
      • Chiusure future: per le chiusure che non sono ancora iniziate, puoi modificare l'ora di inizio, se necessario. Tuttavia, assicurati che event_id rimanga invariato per mantenere la coerenza.
  • Ora di fine:
    • Se non conosci l'ora di fine, lascia il campo vuoto. Alle chiusure senza ora di fine verrà assegnata una durata predefinita (attualmente 2 settimane), dopodiché scadranno, a meno che non vengano estese esplicitamente specificando una nuova ora di fine. Puoi modificare l'ora di fine dopo la pubblicazione dell'evento, ma evita di impostare le ore di fine in modo dinamico in base all'ora corrente.

Per specifiche più dettagliate dei tag della specifica del feed di chiusure e incidenti (CIFS), consulta la specifica CIFS.

Esempi di chiusura

Gli esempi riportati di seguito mostrano una singola chiusura stradale nei formati XML e JSON.

Chiusura XML

Di seguito è riportato un esempio di feed contenente una singola chiusura stradale in formato 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>

Chiusura JSON

Di seguito è riportato un esempio di file del feed contenente una singola chiusura stradale in formato 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"
      }
    }
  ]
}

Gli esempi riportati di seguito mostrano un intero file del feed di chiusure stradali sia in formato XML sia in formato JSON.

File del feed XML

Di seguito è riportato un esempio di file del feed completo relativo alle chiusure stradali in 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>

File del feed JSON

Di seguito è riportato un esempio di file del feed completo delle chiusure stradali in 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"
    }
  ]
}