Configurer le flux

Les informations suivantes vous aideront à configurer vos flux et à les exécuter correctement.

Hébergement du fichier de flux

Le système d'acquisition de contenu Waze récupère automatiquement vos données de flux à intervalles réguliers. Pour vous assurer que Waze récupère le bon fichier de flux :

  • Rendez-le accessible : utilisez des protocoles réseau standards (HTTP, HTTPS, FTP ou SFTP) ou Google Cloud Storage (GCS).
  • Sécurisez vos données (facultatif)
    • Vous pouvez sécuriser votre flux avec un nom d'utilisateur et un mot de passe à l'aide de l'authentification BASIC via HTTPS. Vous fournissez la combinaison d'identifiant et de mot de passe via le Partner Hub.
    • Nous acceptons également les intégrations d'API qui utilisent l'authentification basée sur les en-têtes via un en-tête KeyID ou Ocp-Apim-Subscription-Key.
    • Pour les fichiers GCS, vous pouvez limiter l'accès à un compte de service que nous vous fournirons.
  • Assurez-vous de l'accessibilité : assurez-vous que le fichier hébergé est accessible dans le monde entier.
    • Pour éviter toute interruption de la récupération des données, veuillez vous assurer que votre pare-feu ne bloque pas l'accès en fonction du pays, de l'adresse IP ou de la zone géographique. Ces restrictions peuvent nous empêcher de récupérer les données de votre flux.
    • Nous utilisons un système dynamique pour extraire les informations sur les fermetures et les incidents. Cela signifie que nous n'utilisons pas d'adresses IP statiques et que nous n'acceptons pas les URL/domaines/caractères génériques préautorisés ni l'autorisation d'entrée DNS.

Fréquence d'importation du flux

Le système d'acquisition de contenu récupère les données toutes les quelques minutes. Si vous avez des exigences particulières concernant la fréquence d'importation du flux, ajoutez une note indiquant cette demande lorsque vous envoyez le flux ou contactez l'équipe Waze afin que nous puissions ajuster nos périodes d'interrogation pour refléter votre cycle de mise à jour du flux.

Validation XML

Waze utilise le schéma XML suivant pour définir la structure acceptable d'un flux de spécifications de fermetures et d'incidents (CIFS) : https://www.gstatic.com/road-incidents/cifsv2.xsd.

De nombreux outils sont disponibles sur Internet pour vous aider à valider la structure de vos flux XML. En voici quelques exemples :

Modifications critiques du flux

Avant d'apporter l'une des modifications suivantes, informez l'équipe Waze en remplissant ce formulaire et en modifiant votre demande dans le portail pour identifier le flux mis à jour.

  • Modification, ajout ou suppression de régions ou de pays dans votre flux.
  • Mise à jour de l'URL du flux ou des identifiants requis pour accéder aux informations.
  • Modification de la structure du flux ou des noms de balises.

Spécifications du flux

Un seul fichier de flux peut fournir des informations sur plusieurs fermetures et incidents. Si vous fournissez des informations sur plusieurs événements, chaque fermeture ou incident doit être détaillé dans un élément distinct et doit avoir un ID unique. Ces sections doivent utiliser l'heure et la date locales. La spécification CIFS détaille toutes les balises disponibles pour décrire vos incidents et fermetures.