5 - Mise à jour des données
Dernière mise à jour
Dernière mise à jour
Les données périmées ont un impact direct sur les usagers des transports. C'est une personne qui attend un bus qui ne passera pas par exemple. Pour cette raison, il est indispensable que vos données publiées soient toujours à jour.
Le référencement d'une URL distante est vivement recommandée afin d'automatiser et ainsi faciliter les mises à jour des ressources.
Un jeu de données se compose d'une ou plusieurs ressources (sous la forme de fichiers, par exemple le fichier GTFS .zip, ou les fichiers .json du GBFS sont des ressources).
Pour mettre à jour des données, il est important de ne pas créer un nouveau jeu de données, mais plutôt de remplacer les ressources concernées à l'intérieur du jeu de données.
Connectez-vous sur transport.data.gouv.fr (en haut à droite de la page) pour accéder à votre espace producteur avec votre identifiant et mot de passe utilisés sur data.gouv.fr.
Facultatif : si vous n'avez pas encore vérifié la qualité de vos données, évaluez la qualité de votre ressource.
L'encart "Mettre à jour un jeu de données" liste les jeux de données déjà publiés. Sélectionnez "Éditer" sous le titre du jeu à mettre à jour.
Sur la page du jeu de données, sélectionnez "Modifier la ressource" pour remplacer le fichier ou le flux de données.
Afin de garantir une continuité dans l’utilisation de vos données, nous vous encourageons à anticiper les mises à jour au moins 7 jours avant la date d’expiration.
Pour procéder à la mise à jour, nous vous invitons à remplacer l'ancienne ressource par la nouvelle afin de maintenir la même URL de téléchargement pour les réutilisateurs. En effet, si vous publiez une 2ème ressource et que vous supprimez l'ancienne, l'URL de téléchargement va changer et les réutilisateurs ayant enregistré l'URL n'auront alors plus accès aux données.
Cas nominal : Ce cas est possible dès lors que les nouvelles données publiées commencent (a minima) à la date du jour de publication pour ne pas faire de rupture de service.
Exemple : nous sommes le 15 mai, les données périment le 30 juin. Je souhaite publier mes horaires d'été. Je publie alors un GTFS ou un NeTEx débutant le 15 mai (ou avant) et périmant le 31 août. Je peux donc remplacer l'ancienne ressource périmant le 30 juin par la nouvelle sans générer d'interruption de service.
Cas exceptionnel : En revanche, si je ne suis pas en mesure de publier un GTFS couvrant la période actuelle et la période future, nous vous invitons à publier exceptionnellement une 2ème ressource.
Exemple : nous sommes le 15 mai, les données périment le 30 juin. Je souhaite publier mes horaires d'été. Le GTFS/NeTEx que je souhaite publier couvre la période été du 1er juillet au 31 août. Je le publie en tant que nouvelle ressource pour ne pas qu'il y ait de rupture de service entre le 15 mai et le 1er juillet. J'ai donc 2 ressources sur mon jeu de données : une couvrant les horaires de mai à fin juin et l'autre couvrant les horaires de juillet à août.
Attention, ce cas n'est pas recommandé car il va générer des actions côté réutilisateurs pour intégrer les nouvelles données (nouvelle URL) sans générer de rupture. Nous vous invitons donc à les prévenir le plus rapidement possible à travers l'espace de discussion de votre jeu de données pour qu'ils puissent anticiper la transition.
En synthèse :
Cas nominal (si votre ressource débute a minima à la date du jour de publication) : Remplacez l'ancienne ressource par la nouvelle.
Cas exceptionnel (si votre ressource débute à une date future) : Ajoutez une nouvelle ressource et prévenez les réutilisateurs à travers l'espace de discussion.
Vous pouvez activer des notifications pour vous prévenir lorsqu'une de vos ressources va expirer.
La plupart des SAEIV et autres logiciels qui fournissent du GTFS sont capables de fournir une URL, qui pointe vers leurs serveurs où le fichier GTFS est toujours à jour (par exemple Cityway, Kisio, Mecatran...).
Si votre prestataire peut vous fournir cette URL, ce sera plus pratique pour vous : vous indiquez cette adresse une fois pour toutes et n'avez plus à vous occuper des mises à jour tant que le fichier est à jour sur les serveurs du prestataire.
Si ce n'est pas le cas, vous devrez publier manuellement votre fichier - et penser à le mettre à jour avant qu'il n'expire.
