Questa pagina è stata tradotta dall'API Cloud Translation.

Informazioni su chiusure stradali

Puoi utilizzare il feed dei partner di Waze per fornire automaticamente e su larga scala chiusure stradali pianificate e in tempo reale.

Le chiusure pianificate che invii a Waze verranno visualizzate nell'editor di mappa di Waze e nell'app Waze al momento della chiusura.

Consenti chiusure stradali solo nel caso in cui tutte le corsie sulla strada siano chiuse. Se la chiusura interessa solo alcune corsie, descrivi quelle interessate nell'elemento di impatto sulle corsie.

Affinché le chiusure stradali vengano visualizzate correttamente sulla mappa, devi seguire le linee guida riportate di seguito e le specifiche di 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 l'hub dei partner 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 della mappa" per la revisione, l'approvazione o il rifiuto manuale.

Condivisione di una chiusura

1. Specifica tag di chiusura

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

2. Organizza la chiusura

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

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 influenzata.
direction indica se la chiusura riguarda una o entrambe le direzioni di traffico.

Per chiusura su strade a senso unico:

L'ordine dei punti nella polilinea deve corrispondere alla direzione del traffico.
Per evitare ambiguità e superare differenze nella mappatura, è consigliabile 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 indica la direzione del traffico da chiudere.
Se la chiusura interessa entrambe le direzioni: condividi la polilinea e nel campo della direzione, indica BOTH_DIRECTIONS.

Per una 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 possa abbinarla correttamente ed elaborare la chiusura.
Si consiglia vivamente di fornire più punti per ogni segmento tra le coordinate di inizio e fine. Fornire solo due coordinate può essere sufficiente per segmenti brevi o diritti, ma spesso causa errori di elaborazione.
La seguente polilinea mantiene correttamente la forma generale della strada:

La seguente polilinea non riflette chiaramente la geometria della strada in quanto fornisce solo le coordinate di inizio e fine:
Waze utilizzerà la polilinea fornita 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 della polilinea, poiché Waze può chiudere interi segmenti solo come configurato sulla mappa di Waze.
Se specifichi solo una parte del segmento da chiudere, l'intero segmento verrà chiuso.
È consigliabile che i punti di partenza e di arrivo di una chiusura siano ad almeno 30 metri di distanza l'uno dall'altro.
La lunghezza di una chiusura non deve superare i 20 km.

4. Assicurati che la chiusura rispetti queste linee guida:

Nomi delle vie
- Le chiusure possono interessare solo una strada o una strada sulla mappa di Waze. Le coordinate di inizio e fine della chiusura devono avere lo stesso nome della via. È probabile che l'elaborazione di una chiusura segnalata che si estende su diversi nomi di strade non riesca a essere elaborata, anche se viene fornita una polilinea esatta.
- Waze tenterà di abbinare il nome della strada da te fornito al nome della strada principale o alternativa sulla mappa di Waze per la località segnalata. Una corrispondenza completa o parziale ci aiuterà a identificare correttamente la strada da chiudere, in particolare se ci sono più candidati.
  - Esempio: I-95S, I-95 Southbound e JFK Memorial Highway vengono tutti abbinati correttamente alla stessa strada.
- Per assicurarti che i nomi delle vie forniti nella tua scheda corrispondano a quelli presenti nella mappa di Waze, utilizza l'API Reverse Geocoding di Waze o controlla l'editor di mappa di Waze.
Le chiusure dei feed possono essere effettuate solo per i seguenti tipi di strade Waze:
- Autostrade
- Autostrade
- Strade urbane
- Rampe
- Strade private
I tipi di strada di Waze che non possono essere chiusi utilizzando un feed includono:
- Strade di parcheggi
- Fuoristrada (4x4) e strade pedonali

Ora di inizio e di fine:

Ora di inizio: devi fornire un'ora di inizio per la chiusura. Se hai dubbi sull'ora di inizio, puoi utilizzare il timestamp del report iniziale, ma NON modificare l'ora di inizio dopo la pubblicazione dell'evento.
Ora di fine: se non conosci l'ora di fine, lascia il campo vuoto. Alle chiusure senza un'ora di fine verrà assegnata una durata predefinita (attualmente di 2 settimane), dopodiché scadranno, a meno che non vengano esplicitamente prolungate, 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 informazioni più dettagliate sui tag Closure and Incident Feed Specification (CIFS), consulta la specifica di CIFS.

Esempi di chiusura

I seguenti esempi mostrano una singola chiusura stradale in formato XML e JSON.

Chiusura XML

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

Chiusura JSON

Di seguito è riportato un esempio di file del feed contenente un'unica 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": "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"
      }
    }
  ]
}

Gli esempi seguenti mostrano un intero file del feed di chiusura stradale in formato XML e JSON.

File del feed XML

Di seguito è riportato un esempio di file XML completo del feed chiusura stradale:

<?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>

File del feed JSON

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