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

Informations sur les routes fermées

Vous pouvez utiliser le flux Waze Partner pour fournir des fermetures de routes planifiées et en temps réel, de façon automatique et à grande échelle.

Les routes fermées planifiées que vous envoyez à Waze s'afficheront dans l'éditeur de carte Waze et dans l'application Waze pendant le temps réel de la route fermée.

Indiquez des routes fermées uniquement si toutes les voies de la route sont fermées. Si la fermeture ne s'applique qu'à certaines voies, décrivez celles-ci dans l'élément "Impact sur la voie".

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 pourra peut-être quand même le traiter. Envoyez votre flux via le Partner Hub pour validation et commentaires.

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

Partager une route fermée

1. Spécifier une balise de fermeture

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

2. Structurez votre route fermée

Pour partager une route fermée avec Waze, indiquez les valeurs polyline (obligatoire) et direction (obligatoire).

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 nous indique le sens du trafic concerné.
direction indique si la route fermée s'applique à un sens de circulation ou aux deux.

Pour les routes fermées à sens unique :

L'ordre des points dans la polyligne doit correspondre au sens du trafic.
Pour éviter toute ambiguïté et atténuer 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 sur des routes à double sens:

Si la route fermée ne concerne qu'un seul sens, l'ordre des coordonnées dans la polyligne nous 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 de direction.

Dans le cas d'une polyligne allant du point A au point B, la fermeture aura un impact sur le sens de circulation en fonction du sens de circulation et du type de route, comme illustré 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 il y a de chances que Waze puisse la faire correspondre et 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. Pour les sections courtes ou droites, il peut suffire de fournir deux coordonnées, mais cela provoque souvent des échecs 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 fermeture appliquée peut être plus longue ou légèrement plus courte que la polyligne, car Waze ne peut fermer que des sections entières telles qu'elles sont configurées sur la carte Waze.
Si vous ne spécifiez qu'une partie de la section à fermer, l'intégralité de la section sera fermée.
Les points de départ et d'arrivée d'une route fermée doivent être à au moins 30 mètres l'un de l'autre.
La longueur d'une route fermée ne doit pas dépasser 20 km.

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

Noms des rues
- Les routes fermées ne peuvent affecter 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 être associées au même nom de rue. Une route fermée qui s'étend sur plusieurs noms de rue signalée échouera probablement, même si une polyligne exacte est fournie.
- Waze tentera d'associer le nom de rue que vous fournissez aux noms de route principal ou alternatif sur la carte Waze à l'emplacement signalé. Une correspondance complète ou partielle nous aide à identifier correctement la route à fermer, en particulier lorsqu'il existe plusieurs candidats.
  - Par exemple, l'I-95S, l'I-95 Southbound et la JFK Memorial Highway sont tous associés à la même route.
- Pour vous assurer que les noms de rue et de route que vous indiquez dans votre fiche correspondent à ceux de la carte Waze, utilisez l'API Waze Reverse Geocoding ou consultez l'éditeur de carte Waze.
Les fermetures de flux ne peuvent être effectuées que pour les types de routes Waze suivants :
- Autoroutes
- Voies rapides
- Rues de la ville
- Bretelles
- Routes privées
Voici les types de routes Waze qui ne peuvent pas être fermés à l'aide d'un flux :
- Routes de parking
- Tout-terrain (4x4) et routes piétonnes

Heures de début et de fin :

Heure de début: vous devez fournir une heure de début pour la fermeture. Si vous n'êtes pas sûr de l'heure de début, vous pouvez utiliser l'horodatage du rapport initial, mais NE modifiez PAS l'heure de début après la publication de l'événement.
Heure de fin: si vous ne connaissez pas l'heure de fin, laissez le champ vide. Les fermetures sans heure de fin seront associées à une durée par défaut (actuellement deux semaines). Elles expireront ensuite, sauf si vous les prolongez explicitement en spécifiant 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 balises CIFS (Routes fermées et incidents), consultez l'article Spécification CIFS.

Exemples de routes fermées

Les exemples suivants présentent une seule route fermée aux formats XML et JSON.

Fermeture du fichier 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>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>

Fermeture du fichier JSON

Voici 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": "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"
      }
    }
  ]
}

Les exemples suivants illustrent l'intégralité d'un fichier de flux sur les routes fermées, aux formats XML et JSON.

Fichier de flux XML

Voici un exemple de fichier de flux de fermeture de route 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>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>

Fichier de flux JSON

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