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.

Indica le chiusure stradali solo nel caso in cui tutte le corsie siano chiuse. Se la chiusura interessa solo alcune corsie, descrivile nell'elemento relativo all'impatto sulle corsie.

Affinché le chiusure stradali vengano visualizzate sulla mappa in modo accurato, 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. Struttura la tua chiusura

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

  • Le 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 del traffico interessata.
  • direction indica se la chiusura si applica a una o a entrambe le direzioni di traffico.

Per 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:

  • 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 della polilinea e della direzione.

3. Dai forma alla polilinea

  • Più la polilinea assomiglia alla geometria della strada, più è probabile che Waze riesca ad abbinarla correttamente e a elaborare la chiusura.
    Ti consigliamo vivamente di indicare più punti per ogni tratto, 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 segmento per la chiusura, l'intero segmento verrà chiuso.
  • È consigliabile che i punti di partenza e di arrivo di una chiusura siano a una distanza di almeno 30 metri.
  • La lunghezza della polilinea fornita non deve superare i 20 km.

4. Assicurati che la chiusura rispetti queste linee guida:

  • Nomi delle vie
    • Le chiusure possono interessare una sola strada o una strada sulla mappa di Waze. Le coordinate di inizio e fine della chiusura devono avere lo stesso nome della strada. L'elaborazione di una chiusura segnalata che si estende su nomi di vie diversi non riuscirà, anche se viene fornita una polilinea esatta.
    • Waze tenterà di abbinare il nome della via da te fornito con i nomi delle strade principali o alternative sulla mappa di Waze nella posizione segnalata. Una corrispondenza completa o parziale ci aiuterà a identificare correttamente la strada da chiudere, in particolare quando sono presenti più candidati.
      • Esempio: I-95S, I-95 Southbound e JFK Memorial Highway verrebbero associate correttamente alla stessa strada.
    • Per assicurarti che i nomi di vie e strade forniti nella scheda corrispondano a quelli nella mappa di Waze, utilizza l'opzione Inverti di Waze. API Geocoding 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 indicare un'ora di inizio per una chiusura.
    • Se hai dubbi sull'ora di inizio, puoi utilizzare il timestamp del report iniziale.
    • Modifiche dell'ora di inizio:
      • Chiusure attive: una volta trascorsa l'ora di inizio di una chiusura (ovvero 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 CIFS (closure and Incident Feed Specification), consulta la specifica CIFS.

Esempi di chiusure

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 di 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"
      }
    }
  ]
}

I seguenti esempi mostrano un intero file di feed relativo alle chiusure stradali sia in XML che formati JSON.

File del feed XML

Di seguito è riportato un esempio di file di 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 di feed completo per le 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"
    }
  ]
}