Cette page a été traduite par l'API Cloud Translation.

Informations sur les routes fermées

Vous pouvez utiliser le flux des partenaires Waze pour fournir automatiquement et à grande échelle des informations sur les routes fermées planifiées et en temps réel.

Les routes fermées que vous envoyez à Waze s'affichent dans l'éditeur de carte Waze et dans l'application Waze pendant la période de fermeture.

Indiquez des fermetures de route uniquement si toutes les voies de la route sont fermées. Si la route fermée ne concerne que certaines voies, décrivez-les dans l'élément d'impact sur les voies.

Pour que les routes fermées s'affichent correctement sur la carte, vous devez suivre les consignes ci-dessous et les spécifications CIFS.

Si votre flux ne respecte pas les spécifications CIFS, mais qu'il inclut toutes les données requises, Waze peut quand même être en mesure de le traiter. Envoyez votre flux via le Partner Hub pour qu'il soit validé et que vous puissiez recevoir des commentaires.

En cas de données incomplètes ou incompatibles, les routes fermées n'apparaissent pas automatiquement sur la carte, mais sont envoyées à notre communauté d'éditeurs en tant que "problème de carte" pour examen manuel, approbation ou refus.

Partager une route fermée

1. Spécifier une balise de fermeture

Pour cartographier une route fermée, spécifiez ROAD_CLOSED comme entrée de balise de l'élément type.

2. Structurer votre route fermée

Pour partager une route fermée avec Waze, spécifiez polyline (obligatoire) et direction (recommandé).

Les polylignes sont des séquences de coordonnées qui suivent la géométrie de la route et décrivent le tronçon de route à fermer.
L'ordre des coordonnées dans la polyligne indique le sens de circulation concerné.
direction indique si la route est fermée dans un ou dans les deux sens de circulation.

Pour les routes à sens unique:

L'ordre des points de la polyligne doit correspondre au sens de circulation.
Pour éviter toute ambiguïté et surmonter les différences de cartographie, nous vous recommandons de spécifier ONE_DIRECTION même pour les routes à sens unique.

Pour les routes fermées à double sens:

Si la route est fermée dans un seul sens: l'ordre des coordonnées dans la polyligne indique le sens de circulation à fermer.
Si la route est fermée dans les deux sens: partagez la polyligne et indiquez BOTH_DIRECTIONS dans le champ "Sens".

Pour une polyligne allant du point A au point B, la route fermée affectera le sens de circulation en fonction du sens et du type de route, comme indiqué ci-dessous:

Image expliquant le comportement des polylignes et des directions.

3. Façonner votre polyligne

Plus la polyligne ressemble à la géométrie de la route, plus Waze a de chances de la mettre en correspondance correctement et de traiter la route fermée.
Nous vous recommandons vivement de fournir plusieurs points pour chaque segment entre les coordonnées de début et de fin. Fournir seulement deux coordonnées peut suffire pour les segments courts ou droits, mais cela entraîne souvent des erreurs de traitement.
La polyligne suivante conserve correctement la forme générale de la route:

La polyligne suivante ne reflète pas clairement la géométrie de la route, car elle ne fournit que les coordonnées de début et de fin:
Waze utilisera la polyligne que vous avez fournie pour appliquer l'événement à un ou plusieurs segments de la carte Waze. Notez que la route fermée appliquée peut être plus longue ou légèrement plus courte que la polyligne, car Waze ne peut fermer que des segments entiers tels que configurés sur la carte Waze.
Si vous ne spécifiez qu'une partie du segment à fermer, l'ensemble du segment sera fermé.
Nous vous recommandons de placer les points de début et de fin d'une route fermée à au moins 30 mètres de distance.
La longueur de la polyligne fournie ne doit pas dépasser 20 km.

4. Assurez-vous que votre route fermée respecte ces consignes:

Noms de rues
- Les routes fermées ne peuvent concerner qu'une seule rue ou route sur la carte Waze. Les coordonnées de début et de fin de la route fermée doivent porter le même nom de rue. Le traitement d'une route fermée qui s'étend sur plusieurs noms de rue échouera probablement, même si une polyligne exacte est fournie.
- Waze tentera de faire correspondre le nom de la rue que vous indiquez avec les noms de routes principales ou secondaires sur la carte Waze à l'emplacement signalé. Une correspondance complète ou partielle nous aidera à identifier correctement la route à fermer, en particulier lorsqu'il y a plusieurs candidats.
  - Exemple: I-95S, I-95 Southbound et JFK Memorial Highway seront tous mis en correspondance avec la même route.
- Pour vous assurer que les noms de rue que vous indiquez dans votre fiche correspondent à ceux de la carte Waze, utilisez l'API Reverse Geocoding de Waze ou consultez l'éditeur de carte Waze.
Les routes fermées ne peuvent être ajoutées que pour les types de routes Waze suivants :
- Autoroutes
- Voies rapides
- Rues de la ville
- Bretelles
- Routes privées
Vous ne pouvez pas signaler de routes fermées sur des routes piétonnes.
Heure de début :
- Vous devez indiquer une heure de début pour une route fermée.
- Si vous ne connaissez pas l'heure de début, vous pouvez utiliser l'horodatage du rapport initial.
- Modifications de l'heure de début:
Heure de fin :
- Si vous ne connaissez pas l'heure de fin, laissez ce champ vide. Les routes fermées sans heure de fin se verront attribuer une durée par défaut (actuellement deux semaines), puis expireront, sauf si vous spécifiez explicitement une nouvelle heure de fin. Vous pouvez modifier l'heure de fin après avoir publié l'événement, mais évitez de définir des heures de fin de manière dynamique en fonction de l'heure actuelle.

Pour en savoir plus sur les spécifications des balises CIFS (Closure and Incident Feed Specification), consultez la spécification CIFS.

Exemples de routes fermées

Les exemples suivants montrent une seule route fermée au format XML et JSON.

Clôture XML

Voici un exemple de flux contenant une seule route fermée au format 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>

Clôture JSON

Vous trouverez ci-dessous un exemple de fichier de flux contenant une seule route fermée au format 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"
      }
    }
  ]
}

Les exemples suivants montrent un fichier de flux de fermetures de routes complet aux formats XML et JSON.

Fichier de flux XML

Voici un exemple de fichier de flux de fermetures de routes complet au format 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>

Fichier de flux JSON

Voici un exemple de fichier de flux de fermetures de routes complet au format 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"
    }
  ]
}