Configurer le flux

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

Hébergement de fichiers de flux

Le système d'acquisition de contenu Waze récupère automatiquement les données de votre flux de manière périodique. 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 de base via HTTPS. Vous fournissez la combinaison de nom d'utilisateur et de mot de passe dans 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é : vérifiez 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 région 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 du flux, ajoutez une note indiquant cette demande lorsque vous l'envoyez ou contactez l'équipe Waze afin que nous puissions ajuster nos périodes d'interrogation pour refléter le cycle de mise à jour de votre flux.

Validation XML

Waze utilise le schéma XML suivant pour définir la structure acceptable d'un flux CIFS (Closure and Incidents Feed Specifications) : https://www.gstatic.com/road-incidents/cifsv2.xsd.

Il existe de nombreux outils sur Internet qui peuvent vous aider à valider la structure de vos flux XML. Voici quelques exemples :

Modifications critiques des 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.

  • Modifier, ajouter ou supprimer des régions ou des pays de votre flux
  • Mettez à jour l'URL du flux ou les identifiants requis pour accéder aux informations.
  • Modifier la structure du flux ou les noms des 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 la date et l'heure locales. La spécification CIFS détaille tous les tags disponibles pour décrire vos incidents et vos fermetures.