/
Comment fonctionnent les identifiants des données de la plateforme data.gouv.fr ?

Comment fonctionnent les identifiants des données de la plateforme data.gouv.fr ?

Sep 25, 2025

Problème

La problématique des "identifiants stables" de données est importante pour le téléchargement de ces données via une API, d'autant plus lorsque le "nom logique" évolue.
C'est par exemple le cas des jeux de données climatologiques sur la plateforme meteo.data.gouv.

Comment disposer d'identifiants stables pour les ressources des jeux de données (JDD) disponibles sur meteo.data.gouv et les utiliser dans des URL de téléchargement ?

Solution

Les ressources des JDD disponibles sur meteo.data.gouv sont issues de la plateforme data.gouv.
Cette plateforme attribue à chaque ressource un identifiant UUID (Universally Unique IDentifier - identifiant unique universel) : lorsqu'une ressource (çàd un fichier de données le plus souvent et dans le cas qui nous intéresse) est référencée sur la plateforme, celle-ci lui octroie cet identifiant unique, qui est un identifiant numérique et qui restera invariable.

L'onglet [Métadonnées] des ressources, visible sur le portail meteo.data.gouv,  affiche 3 informations :

  1. l'URL "réelle" ou "fonctionnelle" de la ressource : construite avec le nom du fichier physique sous-jacent
    (dans la capture d'écran ci-dessous : QUOT_SIM2_latest-20250801-20250923.csv.gz)

  2. l'URL "stable" de la ressource : construite avec l'UUID de la ressource

  3. l'Identifiant de la ressource = son UUID (identifiant numérique unique)

DataGouv_MetadonneesRessource_20250925.png

Cet identifiant numérique unique est donc utilisable pour télécharger la ressource de façon pérenne via son "URL stable" et c'est bien le fichier sous-jacent (avec son nom courant) qui sera téléchargé.

Il est possible de déterminer ces identifiants numériques uniques :

  • soit manuellement en parcourant les JDD, les ressources et leurs métadonnées sur le portail meteo.data.gouv

  • soit programmatiquement en parcourant le catalogue des données et en disposant d'un critère de sélection unique pour une ressource
    Cf : Comment utiliser l'API de catalogue des données de la plateforme data.gouv.fr ?

 

Complément :

Il est possible par la suite de modifier le fichier sous-jacent de la ressource. 
Son URL "réelle" peut changer (si le nom du fichier change), mais pas son identifiant numérique, et donc pas non plus son URL "stable".
Ce changement de fichier peut subvenir pour les données mises à jour régulièrement, comme par exemple la ressource "donnée SIM quotidienne" la plus récente (en date de la rédaction de cette fiche) : 

  • lors de sa création, un identifiant numérique unique lui a été attribué : adcca99a-6db0-495a-869f-40c888174a57

  • son URL stable est donc : https://www.data.gouv.fr/fr/datasets/r/adcca99a-6db0-495a-869f-40c888174a57 et elle ne va pas changer, redirigeant toujours vers l'URL "réelle" et le téléchargement du fichier physique sous-jacent à l'instant t

  • sur la capture d'écran ci-dessus son URL réelle est :
    https://object.files.data.gouv.fr/meteofrance/data/synchro_ftp/REF_CC/SIM/QUOT_SIM2_latest-20250801-20250923.csv.gz

  • mais dès le lendemain son URL "réelle" aura changée et sera :
    https://object.files.data.gouv.fr/meteofrance/data/synchro_ftp/REF_CC/SIM/QUOT_SIM2_latest-20250801-20250924.csv.gz

Comme on peut le voir, le nom du fichier évolue avec sa date de mise à jour, mais en réalité, d'un jour à l'autre, il s'agit bien du même fichier, avec de nouvelles données : les anciennes restent identiques, des lignes sont ajoutées. L'UUID reste donc identique.

Conclusion

Si un fichier est vraiment nouveau, une nouvelle ressource (donc un autre identifiant unique) est alors créée.

Si le fichier est simplement mis à jour, comme vu dans l'exemple précédent, le fichier sous-jacent est remplacé, mais la ressource conserve son UUID (identifiant numérique unique).
Ceci permet de ne pas avoir à modifier les URL dans du code (en utilisant l'URL "stable" qui renvoie toujours vers le fichier).
Au niveau fréquence de changement, cela peut être le cas :

  • quotidiennement, comme dans l'exemple ci-dessus

  • mensuellement, par exemple pour la ressource SIM quotidienne "décennie en cours" (nom de la forme QUOT_SIM2_AAAAdéb-AAAAfinMMencours)

  • annuellement, au passage de la nouvelle année par exemple, pour la ressource SIM mensuelle "décennie en cours" (nom de la forme MENS_SIM2_AAAAdéb-AAAAencours)

  • tous les 10 ans, au passage à la prochaine décennie par exemple, pour les ressources SIM quotidienne et SIM mensuelle, il y aura par exemple création des ressources :

    • QUOT_SIM2_2020-2029 (et un fichier QUOT_SIM2_2020-2029.csv.gz) dans le jeu de données SIM quotidienne

    • MENS_SIM2_2020-2029 (et un fichier MENS_SIM2_2020-2029.csv.gz) dans le jeu de données SIM mensuelle

 

Articles connexes