Rechercher
Saisissez au moins deux caractères, sans donnée personnelle.

    BibliothèqueArticles et FAQ Votre projetDemander un devis
    LangueFR
    Guides pratiques

    Publier des données ouvertes compréhensibles et documentées

    Une donnée téléchargeable n’est pas encore une donnée comprise. Le réutilisateur doit pouvoir savoir qui l’a produite, ce qu’elle couvre, ce qu’elle ne couvre pas et comment interpréter ses champs.

    Voir la méthode

    Carnets, tableau imprimé et ordinateur sur une table
    Illustration générée par IA

    Établir provenance et périmètre

    Décrivez le producteur, le mode de collecte, la période et la couverture géographique ou thématique. Distinguez date d’extraction, date de mise à jour et période mesurée. Un fichier publié aujourd’hui peut contenir une mesure plus ancienne ; sa date de publication ne transforme pas l’année de référence.

    Indiquez les parties manquantes et les valeurs approximatives lorsque la source les identifie. Ne corrigez pas une lacune avec une estimation non signalée. Le guide de documentation de data.gouv.fr insiste sur le contexte de production, la structure et les incohérences possibles.

    Fournir un dictionnaire et un exemple

    Expliquez chaque champ, son unité, son type, les valeurs absentes et les codes de référence. Prévoyez un petit exemple lisible cohérent avec le fichier complet. Si des identifiants relient plusieurs tables, décrivez la relation et les lignes qui peuvent rester sans correspondance.

    Distinguez l’objet de son libellé. Une commune peut avoir plusieurs codes postaux ; un produit peut avoir plusieurs variantes. La documentation doit aider le réutilisateur à éviter une agrégation trompeuse ou une déduplication qui efface une relation utile.

    Pour un jeu géographique, documentez le référentiel et l’ordre des coordonnées, pas seulement le nom du format. La RFC 7946 définit GeoJSON avec WGS 84 et des degrés décimaux ; les deux premières valeurs d’une position sont longitude puis latitude. Dans un exercice fictif, le Point de coordonnées [2.35,48.86] ne doit donc pas devenir [48.86,2.35]. Les deux tableaux sont lisibles en JSON et les valeurs restent plausibles : la seule validation syntaxique ne détecte pas cette inversion.

    Distinguez une entité non localisée d’un point connu. Dans une Feature GeoJSON non localisée, geometry peut valoir null ; cela ne revient pas à écrire un Point avec des coordonnées nulles, ni à remplacer l’inconnu par [0,0], qui désigne une position réelle. Décrivez aussi ce que le point représente : entrée observée, adresse géocodée ou centre calculé, avec provenance et date. Ajouter des décimales ne rend pas une estimation plus certaine.

    Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.

    Exercice fictif : contrôler le sens au-delà du JSON lisible
    CasInterprétationContrôle utile
    Point · coordinates: [2.35,48.86]Longitude 2.35 ; latitude 48.86Comparer avec les champs nommés de la source
    Point · coordinates: [48.86,2.35]Deux nombres plausibles, ordre inversé dans cet exerciceContrôler le sens ; la syntaxe seule ne suffit pas
    Feature · geometry: nullEntité non localisée ; fragment de structureDocumenter la valeur absente sans inventer un point
    Position [0,0]Coordonnées existantes, pas une absenceNe pas utiliser comme remplacement automatique de l’inconnu

    Vérifier la publication et la réutilisation

    Identifiez les conditions de réutilisation associées à la source et les informations d’attribution à conserver. Faites vérifier les droits de publication et les données personnelles éventuelles par les personnes compétentes avant de mettre un fichier en accès public. Une adresse déjà visible ailleurs ne rend pas automatiquement toute copie publiable.

    Testez le téléchargement sans outil interne ni compte particulier lorsque l’accès annoncé est public. Contrôlez le format, l’encodage et l’intégrité du fichier. Préparez une référence de version ou une empreinte pour pouvoir rapprocher un signalement du fichier effectivement consulté.

    Maintenir versions et corrections

    Définissez une fréquence de révision réaliste et un contact pour signaler une anomalie. Lorsque le schéma change, décrivez les champs ajoutés, retirés ou redéfinis. Une correction de valeur doit être distinguée d’une nouvelle mesure, afin de ne pas créer une fausse évolution dans une série.

    Conservez les versions utiles et leurs notes, avec une politique claire pour les fichiers remplacés. Le dossier de publication devrait permettre à une autre personne de reproduire l’extraction ou, à défaut, de comprendre ses limites. Un compteur de téléchargements ne remplace pas cette qualité documentaire.

    Documentation primaire : data.gouv.fr : Bien documenter un jeu de données.

    Distinguez le jeu de données de ses distributions. Un CSV et un JSON peuvent représenter le même jeu dans deux formats ; ne les comptez pas automatiquement comme deux mesures indépendantes. DCAT décrit une distribution comme une représentation particulière d’un jeu. Comparez toutefois couverture, précision, champs et version : deux distributions ne sont pas nécessairement équivalentes sans perte d’information.

    Ajoutez un identifiant de version et un historique expliquant la correction. Une adresse « dernière version » peut rester stable, mais il faut pouvoir identifier la version effectivement utilisée. Distinguez aussi correction et nouvelle observation : une mesure portant sur un nouveau mois ne corrige pas, par sa seule existence, la mesure du mois précédent. Décrivez ce rapport entre versions et séries avant de comparer les chiffres.

    Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.

    Publication de données : identifier l’objet, le format et la révision
    Repère documentaireCe qu’il distingueVérification utile
    Jeu de donnéesLe sujet, le périmètre et les observations décrites.L’identité reste compréhensible indépendamment du format de fichier.
    Distribution CSV ou JSONUne représentation particulière du jeu.Comparer champs, précision et couverture avant de supposer leur équivalence.
    Version identifiéeUn état précis et son historique de changements.Retrouver la version citée, même si une adresse courante a été actualisée.
    Correction ou nouvelle périodeRévision d’une donnée ou observation différente.Ne pas présenter un nouveau mois comme la correction automatique du précédent.
    • W3C DCAT 3 : Distributions

      Consulté le 22 octobre 2026 ; distinction entre jeu de données et représentations, avec d’éventuelles différences de fidélité.

    • W3C : Données sur le Web et versions

      Consulté le 22 octobre 2026 ; identifiant de version, historique et distinction avec des observations de périodes différentes.

    Documents de référence

    Contenu mis à jour le

    Repères documentaires pour ce sujet

    Repères documentaires pour ce sujet
    RéférenceValeur ou syntaxePortée du repère
    RFC 4180 · CSV
    text/csv · "a,b"Les champs avec virgule, guillemet ou saut de ligne sont protégés ; les guillemets internes sont doublés.
    RFC 8259 · JSON
    application/json · UTF-8JSON standard n’autorise ni commentaires ni virgule finale ; les chaînes utilisent des guillemets doubles.

    Les dates indiquent la consultation des références. Ces repères ne constituent ni un audit du site ni une déclaration globale de conformité.

    Matrice de recette à adapter au projet

    Ces contrôles proposés utilisent des cas fictifs. Décidez du comportement attendu avec l’équipe, notez le résultat et attribuez les écarts non résolus avant publication.

    Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.

    Cas de test, résultats attendus et preuves utiles
    CasRésultat attenduPreuve à conserver
    Téléchargement public annoncéUne personne extérieure récupère un fichier lisible sans outil interne.URL publique, licence applicable, format, version et contrôle de lecture d’un échantillon représentatif.
    Champ et unité contrôlésL’exemple et le fichier complet utilisent la même définition.Dictionnaire, échantillon et comparaison de valeurs.
    Valeur inconnue et identifiant sans correspondanceLes limites sont visibles sans substitution de valeur plausible.Lignes concernées et règles de représentation de l’inconnu.
    Correction publiéeUn utilisateur peut distinguer correction et nouvelle mesure.Version, description du changement et dates de référence.

    Questions fréquentes

    Quelle date afficher près du fichier ?

    Selon le besoin, affichez date d’extraction, dernière modification et période couverte, en les nommant séparément. Ne présentez pas automatiquement la date de téléchargement comme l’année d’une population ou d’une autre mesure.

    Une licence suffit-elle à rendre le jeu exploitable ?

    Elle définit des conditions de réutilisation, mais il faut également expliquer champs, unités, identifiants, couverture, qualité et versions. L’usage doit pouvoir être reproduit ou au moins compris par une autre personne.