Utilisation de data.gouv.fr

Si l’organisation que vous administrez exerce une mission de service public, vous pouvez demander à la faire certifier par notre équipe. Une organisation certifiée obtient un badge « service public certifié ».

Pour demander la certification d’une organisation dont vous êtes administrateur : envoyez une demande de certification, en expliquant :

• pourquoi vous souhaitez certifier votre organisation ;

• une preuve de votre rôle dans celle-ci ;

• l’URL vers votre organisation.

Notre équipe examinera votre demande et prendra une décision sous quelques jours.

Le service de moissonnage mis à votre disposition permet de référencer sur data.gouv.fr les jeux de données publiés sur d’autres catalogues de données en ligne. De cette manière, vous n’avez pas besoin d’importer à la main sur data.gouv.fr les jeux de données que vous avez déjà importés sur votre propre plateforme.

Vous avez retravaillé un jeu de données ou vous avez fait un croisement de données qui vous semble intéressant de partager ?

Vous avez la possibilité d’associer à un jeu de donnée une ressource communautaire.

Ces ressources sont publiées par la communauté et ne sont pas sous la responsabilité du producteur des données.

Sur les jeux de données au format tabulaires vous pouvez utiliser notre explorateur de données pour avoir un aperçu des données, d’en savoir plus sur les différentes colonnes, mais aussi par exemple de réaliser des filtres et des tris.

Les principales fonctionnalités de l'outil sont présentées .

Au moment de l'ajout d'une API, data.gouv.fr vous aide pas à pas pour chacun des contenus demandés.

🎉 L'ajout des API dans data.gouv.fr est une nouvelle fonctionnalité depuis novembre 2024 ! Cette fonctionnalité est accessible dans votre espace .

Si les données que vous souhaitez faire circuler ne sont pas structurées sous la forme d'un jeu de données, il est nécessaire de réaliser une extraction des données depuis le système d'information où elles sont stockées. L'extraction permet d'obtenir un jeu de données structuré, qui ordonne les données selon différentes caractéristiques.

Lorsque vous cherchez à extraire des données d'un système d'information, plusieurs situations peuvent se présenter :

1. Un outil permet d'exporter l'ensemble des données depuis le système d'information --> il est nécessaire de sélectionner les données éligibles à la circulation en aval de l'export ;

2. Un outil permet d'exporter l'ensemble des données ou de sélectionner un sous ensemble des données à exporter depuis le système d'information

Correspondances des métadonnées

Certains champs du modèle de data.gouv.fr possèdent un équivalent qui peut être sous spécifié dans certains protocoles ou sur certaines plateformes, ou bien alors être spécifié différemment, sur plusieurs champs. Dans ce cas, la valeur du champ est récupérée en “best effort’, c’est-à-dire qu’elle va être devinée en fonction des éléments à disposition. Se référer à la page de chaque moissonneur pour savoir lesquels sont dans ce cas pour chaque implémentation.

Suppression à la source et archivage

Lors d'une suppression à la source (un ou plusieurs jeux de données qui ne sont plus présents sur la plateforme moissonnée), data.gouv.fr conserve les jeux de données sur sa plateforme. Le but est d'éviter les suppressions en masse par erreur, ce qui entraînerait une perte des statistiques, des discussions et des ressources communautaires de chaque jeu de données.

Au bout d'une période de 2 jours, ils sont marqués comme archivés. L'archivage des jeux de données implique qu'ils ne soient plus indexés ou visibles dans les statistiques des producteurs, mais bien accessibles par lien direct pour les utilisateurs qui souhaiteraient continuer à y accéder.

Dans le cas d’une suppression ponctuelle, nous vous invitons à supprimer manuellement le jeu de données moissonné qui a perdu sa source.

Dans le cas d’une suppression massive de jeu de données, veuillez nous contacter afin de trouver une solution satisfaisante.

Changement d’identifiant

Les moissonneurs utilisent les identifiants de jeu de données distants pour retrouver leurs données entre deux moissonnages. Il est donc important de veiller à ce qu’un jeu de données conserve son identifiant au fil du temps et des modification successives. Dans le cas contraire, cela donnera lieu à la création d’un doublon.

Il faut donc aussi veiller à ne pas supprimer puis recréer un jeu de données ou une ressource pour faire sa mise à jour.

Différents acteurs sont soumis aux obligations de diffusion de leurs documents administratifs, et donc d'ouverture de leurs données. Vous êtes concerné par la diffusion des documents administratifs, et donc la publication de vos données en open data, si vous êtes :

• une administration centrale de plus de 50 agents ;

• une personne morale de droit privé chargée d'une mission de service public qui emploie plus de 50 agents à temps plein ;

• une collectivité territoriale de plus de 3 500 habitants et de plus de 50 agents.

La première partie de ce guide s'adresse notamment aux organismes publics et privés en charge d'une mission de service public. La seconde partie de ce guide s'adresse aux réutilisateurs de données.

Pour être en capacité d'améliorer la qualité des données en continu, il convient d'adapter sa stratégie organisationnelle. Il est notamment conseillé de :

• Identifier une personne coordinatrice de la démarche d'ouverture des données : elle a pour mission de publier les jeux de données, de s'assurer que leurs mises à jour sont effectuées et d'animer la vie des jeux de données sur la plateforme (répondre aux commentaires, etc.). La personne coordinatrice travaille en lien direct avec les équipes métiers afin de comprendre les problématiques techniques.

• Elaborer un processus de rétroaction : lors de l'exploitation des jeux de données, les réutilisateurs peuvent identifier des anomalies ou des problèmes de qualité ou encore proposer des améliorations. Il est nécessaire d'instaurer un canal de rétroaction afin d'intégrer ces remarques dans les processus métiers et ainsi améliorer la qualité des jeux de données.

--> La marché à suivre est détaillée ici.

Grâce à cette section, les réutilisateurs de données pourront répondre aux interrogations suivantes :

• Qu'est-ce que l'open data ?

• Quelles sont les conditions de réutilisation des données ouvertes ?

Dans cette section, vous apprendrez à :

Vous êtes une administration et souhaitez distribuer des données administratives à d'autres administrations dans l'objectif de participer à la simplification des démarches administratives ?

➡️ Exposez et/ou concevez votre API avec API Entreprise et API Particulier !

Comment rejoindre les bouquets API Entreprise / API Particulier ?

Qui peut modifier une page API ?

N'importe quelle personne de l'organisation à laquelle appartient la fiche peut modifier une fiche API. C'est-à-dire autant une personne dont les droits sont admin ou éditeur.

Comment modifier une page API ?

Dans cette section, vous apprendrez à :

Chaque moissonnage donne lieu à un rapport accessible depuis l’interface d’administration de data.gouv.fr. Il vous permet de comprendre ce qu’il se passe et, le cas échéant, de corriger les erreurs existantes et de vérifier le filtrage.

Vue synthétique

Détails d’un jeu de données

En cas d’erreur

• 1 correspond à l’erreur technique formulée de façon compréhensible pour un humain

• 2 contient la “stacktrace” de l’erreur qui servira à ceux qui développent des moissonneurs ou contribuent aux existants.

Une fois votre réutilisation publiée, vous pouvez la gérer depuis l'espace d'administration. Vous pouvez notamment suivre les principales métriques, les discussions ainsi que modifier, transférer ou supprimer votre réutilisation.

La procédure pour gérer une réutilisation est détaillée dans le tutoriel suivant :

Grâce à cette section, les producteurs de données pourront répondre aux interrogations suivantes :

• Qu'est-ce que l'open data ? A quoi cela sert-il ?

• Suis-je concerné par les obligations légales relatives à l'ouverture des données ?

• Quelles sont les obligations légales et les règles à respecter ?

Il est conseillé de proposer votre documentation en ligne et non sous format PDF : une documentation en ligne permet de s’assurer que les réutilisateurs des données disposent toujours de la version la plus à jour.

Des portails de données, tels que data.gouv.fr, proposent des espaces dédiés à la documentation du jeu de données.

Vous pouvez également héberger votre documentation sur des sites web statiques.

Si le jeu de données a pour vocation de circuler en interne de votre organisation, nous vous conseillons a minima de proposer une documentation dans un fichier séparé des données :

• Le fichier contenant les données doit être réservé à la manipulation de ces dernières ;

• Le fichier contenant la documentation a lui pour vocation d’informer sur la nature des données et sur la structure des fichiers.

Exemple : Dans le cadre de la publication , un a été créé afin de présenter la documentation du jeu de données.

Dans cette section, vous apprendrez comment :

Dans ce guide, vous apprendrez comment :

Dans cette section, vous apprendrez comment :

• Publier une API

Pour en savoir plus sur l'API spécifique de de data.gouv, veuillez consulter .

En tant qu'administration :

• Vous souhaitez référencer vos API sur data.gouv.fr ?

• Vous avez besoin d'accompagnement pour documenter précisément vos API ?

• Vous vous interrogez sur les réutilisations possibles de vos API ?

• Vous vous demandez si vos données administratives peuvent être utiles pour simplifier les démarches des citoyens ? et comment concevoir l'API adéquate ?

➡️ Le pôle circulation de la donnée de la DINUM est disponible pour vous aider. Écrivez-nous à .

Dans cette section, vous apprendrez comment :

Vous êtes une administration ? une collectivité ? un opérateur d'État ? et vous souhaitez exposer votre API dans le catalogue data.gouv.fr ? ➡️ Le pôle circulation de la donnée de la DINUM (direction interministérielle du numérique) est là pour vous accompagner !

Pourquoi exposer son API sur data.gouv.fr ?

Data.gouv.fr est la plateforme ouverte des données publiques françaises. Depuis fin 2024, elle recense également les . Pour les usagers, ce recensement large de la donnée permet de trouver au même endroit toutes les données disponibles quel que soit leur format. Data.gouv.fr est utilisé par de nombreux agents publics en quête de données pour simplifier les démarches en ligne qu'ils proposent à leurs usagers.

Les activités de votre organisation peuvent être consultées à partir d’un tableau de bord qui centralise les informations suivantes :

• la description de l’organisation et la liste de ses membres ;

• les métriques rattachées à chaque jeu de données, ressource ou réutilisation publiés ;

Dans cette section, vous apprendrez à :

La création d'un schéma de données se décompose en 4 phases :

1. : envisager de créer un schéma de données ;

2. : rassembler plusieurs parties prenantes pour créer un schéma de données ;

En tant qu'administration souhaitant diffuser des données restreintes, vous pouvez avoir besoin de délivrer des habilitations aux usagers. ➡️ L'outil Datapass est fait pour ça !

La marche à suivre est illustrée ci-dessous :

A partir de l’API de data.gouv.fr, vous pouvez réaliser les mêmes actions que sur la plateforme :

La production de données en conformité avec un schéma de données existant présente de nombreux bénéfices :

• Croisement : les données créées peuvent être facilement croisées avec d’autres données conformes au schéma de données utilisé ;

• Intéropérabilité : l’interopérabilité des données et leur croisement est simplifié ;

• Facilité d'agrégation : si le jeu de données créé est une agrégation de plusieurs fichiers produits par différents acteurs, la formalisation et le partage d’un schéma de données facilite le travail d’agrégation des données --> ce schéma devient un standard pour votre communauté ;

• Pérennité : la formalisation d’un schéma de données assure une pérennité des fichiers dans le temps ;

• Documentation : la documentation d’un schéma de données existant est déjà rédigée et accessible ;

• Ouverture : la présence d'un schéma de données existant peut faciliter l'ouverture des données, les producteurs ayant directement une procédure claire à suivre ;

• Qualité : la conformité d'un fichier vis à vis d'un schéma de données, qu'il est possible de vérifier, permet de valider un premier niveau de qualité.

Il est aussi possible de générer des jeux de données d’exemple ou de proposer des formulaires de saisie standardisés.

Marche à suivre

Pour déterminer s’il est nécessaire de créer ou non un schéma de données, il est recommandé de suivre les étapes suivantes :

1. Lire attentivement les différentes sections de ce guide ;

2. Organiser une réunion réunissant des acteurs métiers, techniques et de potentiels réutilisateurs : vous débattrez de la pertinence de la création de votre schéma de données ;

3. Référencez votre schéma pour entrer en contact avec les équipes d'Etalab et leurs partenaires et bénéficier de conseils pour sa création, d'une visibilité accrue et d'une assistance d'experts.

Exemples d'illustration

✅ Situations favorables à la création d’un schéma de données

Exemple 1 : Le ministère chargé des transports souhaite consolider une base nationale des lieux pouvant servir de points de covoiturage. Les collectivités territoriales sont en charge de la création, du recensement et de l'aménagement de ces lieux.

--> Il est pertinent de créer un schéma de données car un grand nombre de producteurs de données doivent produire des données dans un format homogène. Un schéma facilitera la diffusion des prérequis, permettra la validation des données et facilitera l’agrégation nationale.

Exemple 2 : L’INSEE souhaite diffuser le Code Officiel Géographique. Il rassemble des données sur des communes, des cantons, des arrondissements, des départements, des régions et des pays. Ce fichier est actualisé tous les ans.

--> Il est pertinent de créer un schéma car ces données sont des données de référence. Un grand nombre de réutilisateurs est susceptible d’utiliser ces données. Il est primordial que ces réutilisateurs aient accès à une documentation de qualité, que la structure des fichiers des données reste stable dans le temps et que les données publiées soient de bonne qualité.

Le cas des schémas de données en interne Bien qu’il ne paraisse pas nécessaire dans certaines situations de créer et de diffuser un schéma, vous pouvez choisir de le faire. En effet, les schémas de données comportent de nombreux avantages (documentation, montée en qualité, réutilisations, etc.) qui sont bénéfiques, même lorsque les données sont utilisées uniquement en interne.

❌ Situations dans lesquelles la création ou la diffusion d'un schéma de données ne semble pas nécessaire

Une administration centrale diffuse des statistiques d’activité d’un bureau, en open data, de manière annuelle.

--> Avec ces seules informations, il ne semble pas nécessaire de créer un schéma : il n’y a qu’un seul producteur et le potentiel de réutilisation semble limité.

Points de sortie

À l’issue de cette phase, vous devriez :

• Connaître les schémas de données ;

• Être en mesure de décider si votre projet requiert la création d’un schéma de données ;

• Savoir si votre schéma de données devra être référencé à terme sur schema.data.gouv.fr.

Marche à suivre

Deux méthodes de publication d'une Base Adresse Locale pour intégration dans la sont possibles sur data.gouv.fr :

Autres méthodes de publication

D'autres méthodes permettent de publier une Base Adresse Locale pour intégration dans la .

Il est notamment recommandé d'utiliser . "Mes Adresses" permet de gérer en ligne (gratuitement), sur un simple navigateur web, une Base Adresse Locale communale et de transmettre des modifications en temps réel à la Base Adresse Nationale.

Elle ne requiert :

• Aucune gestion de fichier

• Aucune compétence technique

Si vous utilisez votre propre outil, il est également possible de publier via :

• Un sur adresse.data.gouv.fr ;

• .

Pour en savoir plus, nous vous invitons à consulter proposée par adresse.data.gouv.fr.

Comment faire une recherche SPARQL ?

Il n’existe actuellement pas de point d’accès SPARQL directement sur . Pour répondre à vos besoins en matière de recherche et d’interrogation des données ouvertes françaises, nous vous recommandons d’utiliser . Cette plateforme européenne moissonne régulièrement le catalogue de , ce qui vous permet d’accéder aux données françaises et toutes les autres données européennes via leur endpoint SPARQL.

Pour effectuer une recherche SPARQL sur , en particulier sur le catalogue français (appelé Plateforme ouverte des données publiques françaises sur ), suivez ces étapes :

Étape 1 : Accéder à l'interface de requête SPARQL

• Rendez-vous sur l'interface SPARQL de à l'adresse suivante : .

• Vous accéderez à une interface graphique où vous pouvez saisir vos requêtes SPARQL.

Étape 2 : Comprendre les éléments de base d'une requête SPARQL

Les principaux éléments d'une requête SPARQL sont :

• PREFIX : Déclare les préfixes utilisés pour éviter de répéter les URI complètes dans la requête. Par exemple :

• SELECT : Indique les variables que vous souhaitez récupérer dans les résultats. Par exemple :

• WHERE : Spécifie les motifs de correspondance pour restreindre les informations à extraire. Par exemple :

• LIMIT : Limite le nombre de résultats retournés. Par exemple :

Étape 3 : Exemple de requête SPARQL pour interroger le catalogue

Pour interroger les jeux de données du catalogue français , utilisez la requête suivante :

Cette requête sélectionne les jeux de données publiés par la "Plateforme ouverte des données publiques françaises" en récupérant leur titre et leur description.

Étape 4 : Exécuter la requête

• Collez la requête dans l'éditeur SPARQL sur la page de .

• Exécuter la requête.

• Les résultats s'afficheront sous forme de tableau, listant les jeux de données avec leurs titres et descriptions.

Étape 5 : Exporter et utiliser les résultats

Vous pouvez exporter les résultats obtenus dans différents formats (CSV, JSON, XML) pour les analyser ou les intégrer dans d'autres systèmes.

En savoir plus

Pour en savoir plus vous pouvez vous référer à la .

Respecter le schéma de données

Les Bases Adresses Locales correspondent à un . Il est conseillé de le suivre au plus près. Le respect de ce schéma garantit une intégration réussie des Bases Adresses Locales dans la Base Adresse Nationale.

Une seule Base Adresse Locale est publiée par commune.

Suivre les bonnes pratiques

• voie_nom, numero, suffixe : le nom de la voie et de son complément sont rédigés en toutes lettres, en minuscules accentuées, la première lettre de la voie et du nom seulement étant écrites en majuscules. Le complément est réservé aux hameaux et lieux-dits historiques. Il est conseillé de limiter le champ suffixe aux indices de répétition du type bis, ter.

• cad_parcelles : la commune délivrant un certificat de numérotage associe une numérotation à une parcelle. Le registre de filiation parcellaire de DGFiP, disponible en open data, permet de connaître les parcelles associées à une adresse.

• Voies sans adresse : le numéro attendu pour les voies sans adresse est 99999.

Pour aller plus loin, ("Comment constituer et établir une adresse ?") est disponible. Il détaille les règles et les normes en vigueur.

Un score de qualité des métadonnées a été mis en place sur data.gouv.fr pour répondre principalement à deux problématiques :

• Les réutilisateurs de données peinent à identifier les jeux de données de qualité et à évaluer si tel ou tel jeu de donnée est digne d’intérêt ;

• Les producteurs de données ne sont pas suffisamment incités et accompagnés à améliorer la qualité de leurs données.

Grâce à ce score de qualité des métadonnées, il est possible d'identifier les axes sur lesquels travailler pour améliorer la qualité de vos données.

🧭 Les critères sont les suivants :

Ce score est encore en phase d’expérimentation :

• Le poids de chaque critère sera ajusté en fonction de ;

• De nouveaux critères seront ajoutés progressivement notamment pour intégrer la notion de schéma de données.

La formalisation de l’ouverture des données publiques a été progressive, au niveau national et européen :

En France

• 1978 - Loi n°78-753 du 17 juillet 1978, dite “loi CADA” : création du droit d’accès aux documents administratifs

• 2005 - (transposition de la directive européenne de 2003) : création du droit de réutiliser l’information publique

• 2011 - chargée de la création d'un portail unique interministériel des données publiques

• 2015 - : création du droit de réutiliser librement les données publiques

• 2016 - : consécration du principe de l’open data par défaut.

Ce cadre général s’est étoffé de législations sectorielles ou territoriales, notamment en matière de transport, santé et énergie :

• 2015 - : ouverture en open data des données de transport

• 2015 - : publication en open data des données des collectivités publiques de plus de 3500 habitants

• 2016 - : publication en open data des données de santé.

En Europe

• 2003 - : ensemble de règles concernant la réutilisation des données et documents détenus par les organismes des Etats membres de l’Union européenne

• 2007 - : obligation de publier en open data les données environnementales et géographiques

• 2013 - : encadrement du droit de redevance accordé aux administrations

La réutilisation des données ouvertes est libre et gratuite. S’il est permis une grande liberté d’utilisation, les réutilisateurs de données ont néanmoins des droits et des obligations.

Les conditions d'utilisation des données ouvertes sont détaillées ici :

De façon générale, les droits et obligations des réutilisateurs de données sont à retrouver dans la licence qui est associée au jeu de données en open data.

Sur data.gouv.fr, la licence est indiquée et disponible sur la page du jeu de données :

Les licences les plus courantes sont et la Licence ODbL.

Ressources externes pour aller plus loin

Une fois qu'un schéma est finalisé et référencé sur schema.data.gouv.fr, il est temps de produire des données conformes à ce schéma.

data.gouv.fr propose de multiples intégrations avec schema.data.gouv.fr permettant de spécifier qu'une ressource présente sur data.gouv.fr est censée être conforme à un schéma.

Il est ensuite possible de procéder à la validation de la ressource par rapport au schéma ou de consulter la documentation du schéma à partir de la page d'un jeu de données.

Il est possible d'indiquer qu'une ressource d'un jeu de données correspond à un schéma depuis l'interface d'administration de data.gouv.fr.

• Lorsque vous déposez ou éditez une ressource, vous pouvez sélectionner le schéma correspondant à vos données depuis une liste déroulante.

• Le fait d'indiquer que votre ressource est censée respecter un schéma permet de bénéficier de vérifications de la qualité des données et d'indiquer aux réutilisateurs que vos données respectent un référentiel.

L’ensemble des jeux de données publiés sur data.gouv.fr constitue un jeu de données à part entière qui peut être téléchargé lui aussi, sous la forme d’un catalogue. Vous y trouverez :

• La liste des jeux de données publiés sur data.gouv.fr

• La liste des ressources publiées sur data.gouv.fr

• La liste des réutilisations publiées sur data.gouv.fr

Qu'est-ce qu'une réutilisation ?

La réutilisation des informations publiques désigne l’utilisation des données publiques par des tiers à d’autres fins que celle de la mission de service public pour laquelle les documents ont été produits ou reçus.

La réutilisation des données doit être libre, c'est-à-dire :

• Elle est gratuite

Open data public : la mise à disposition libre et gratuite des documents administratifs

Bien souvent, la qualité de données que vous proposez, bien qu'adaptée aux utilisations internes à votre structure, peut être améliorée pour les usages nouveaux engendrés par l'ouverture, qu'il s'agit alors de mieux connaître.

Définir la qualité d'un jeu de données

Pour une donnée, la notion de qualité dépend grandement de l'usage qui en est fait.

Les jeux de données publiés sont généralement produits dans un contexte propre à un processus métier et pour un usage particulier. Cet environnement métier n'est pas toujours familier aux tiers, qu'ils soient internes ou externes à l'organisation.

Exemple : est historiquement produite par la Direction générale des finances publiques pour tenir un fichier immobilier et collecter l'impôt.

Le point d'entrée pour accéder à des données en open data est la plateforme .

Qu'est-ce que data.gouv.fr ?

est la plateforme ouverte et communautaire qui vise à centraliser et structurer les données ouvertes en France. Elle favorise la transparence et l’efficacité de l’action publique tout en facilitant la création de nouveaux services.

La plateforme est par le département Opérateur des Produits Interministériels de .

Comprendre les droits des membres d'une organisation

Une organisation se compose d’administrateurs et d’éditeurs qui ont des permissions différentes.

Ajouter un membre à une organisation

La procédure est illustrée ci-dessous :

Retirer un membre d’une organisation

La marche à suivre est illustrée ci-dessous :

Il est possible de faire moissonner les données de sa plateforme géographique par data.gouv.fr.

1. La plateforme a vocation à accueillir l’ensemble des données géographiques en open data.

2. Le moissonnage direct des plateformes géographiques par est maintenant possible et n’oblige plus à passer par une plateforme intermédiaire.

3. Des travaux sont en cours pour moissonner automatiquement les fiches de métadonnées mises à disposition par au nom des différentes organisations productrices.

4. Le rôle de la plateforme Geocatalogue gérée par le BRGM (Service Géologique National) est concentré sur le périmètre des données

Mettre en place un moissonneur géographique

Le moissonnage des plateformes géographiques se fait avec transformation des fiches ISO-19139 en , l'un des vocabulaires de moissonnage supportés par data.gouv.fr.

Les fiches moissonnées étant associées à l'organisation qui a configuré le moissonneur sur , il est important de préparer les points de moissonnage pour que les fiches retournées correspondent à celles de l'organisation cible.

Dans le cas d'une plateforme référençant des données de différentes organisations, il est donc nécessaire de créer des CSW virtuels (filtrés par organisation cible).

pour configurer des sous-portails.

Une documentation est disponible sur les étapes générales de configuration d'un point de moissonnage dans . Il faut choisir le moissonneur csw-iso-19139 au niveau de l'implémentation.

Configurer un portail GeoNetwork

data.gouv.fr peut moissonner un endpoint CSW avec sortie ISO-19139 en appliquant par la suite . Ce moissonnage est fonctionnel sur les différentes versions de GeoNetwork.

Une requête POST est effectuée par le moissonneur sur le endpoint CSW renseigné (ex ) avec le contenu suivant :

Moissonnage historique

En version 2 ou 3, il existait un endpoint DCAT alternatif au endpoint CSW habituellement utilisé comme .

Ainsi devenait par exemple. Le moissonneur utilisé était donc l'implémentation dcat simple.

En version 4, il est possible de récupérer le contenu . La conversion des fiches par GeoNetwork est cependant moins satisfaisante que par récupération du contenu en ISO-19139 et conversion à posteriori.

Comment mettre en place un moissonneur ?

Le principe du moissonnage sur data.gouv.fr se décompose en plusieurs étapes :

1. Vous créez un moissonneur sur data.gouv.fr afin que data.gouv.fr suive l’activité de votre plateforme ;

2. Vous publiez des données sur votre plateforme open data ;

3. Vous demandez la validation de votre moissonneur sur ;

4. La configuration du moissonneur est validée par l’équipe en charge de data.gouv.fr ;

5. Le moissonneur de data.gouv.fr vient automatiquement récupérer les données de votre plateforme ;

6. Les données de votre plateforme sont référencées et visibles sur data.gouv.fr. 🎉

Créer un moissonneur

La création d’un moissonneur sur data.gouv.fr nécessite la création d’un compte gratuit.

Pour créer un nouveau moissonneur :

1. ;

2. Rendez-vous sur , en cliquant sur Administration en haut à droite de votre écran ;

3. Cliquez sur l’icône en forme de plus (+) qui se trouve à gauche de votre avatar ;

À partir de là, la création du moissonneur se déroule en 3 étapes.

1. Définir qui publie les données moissonnées

Une fois moissonnées, c’est-à-dire récupérées sur votre plateforme, vos données sont publiées sur data.gouv.fr. L’étape 1 vous permet de choisir le compte qui sera associé à la publication sur data.gouv.fr des données moissonnées sur votre site.

Il peut s’agir de :

• votre propre compte, pour une publication à titre individuel, sous votre propre nom ;

• le compte d’une organisation dont vous êtes membre, pour une publication à titre collectif.

Si vous êtes membre d’une organisation, nous vous conseillons de publier vos jeux de données en son nom. Une fois votre choix effectué, cliquez sur le bouton Suivant pour accéder à l’étape 2.

2. Configurer le moissonneur

L’étape 2 vous permet de configurer votre moissonneur. Cette étape est importante pour que les données récupérées par data.gouv.fr soient aussi complètes que celles publiées sur votre plateforme à l’origine.

Nom

Donnez un nom à votre moissonneur. Il s’agit d’une référence interne, qui vous permet de vous y retrouver si vous créez plusieurs moissonneurs. Le nom de votre moissonneur ne sera pas public.

• Mauvais nom : Moissonneur de mon portail

• Bon nom : Plateforme open data Grand Lyon

Le nom du moissonneur est obligatoire.

Description

Vous pouvez ajouter des précisions sur votre moissonneur dans le champ description. Là encore, il s’agit d’une référence interne qui n’a de valeur que pour vous.

La description est facultative.

URL

Saisissez ici l’URL du portail à moissonner. Il s’agit généralement de l’URL de la page d’accueil de votre portail d’open data. L’URL permet au moissonneur de parcourir et récupérer tous vos jeux de données.

• Mauvaise source : data.angers.fr

• Bonne source : https://data.angers.fr

L’URL est obligatoire.

Implémentation

Choisissez ici le format des métadonnées associées aux jeux de données publiés sur votre plateforme. Ce format permet au moissonneur de savoir comment lire et interpréter vos métadonnées, pour bien les retranscrire sur data.gouv.fr.

Certaines implémentations permettent d’ajouter des filtres, dans le but d’inclure ou d’exclure certains jeux de données du moissonnage. Consultez .

Le type d’implémentation est obligatoire.

Actif

Cochez la case pour que votre moissonneur se mette au travail dès qu’il aura été validé par l’équipe en charge de data.gouv.fr. Laissez-la décochée pour activer votre moissonneur à la main.

Ce champ est obligatoire.

Une fois tous les champs obligatoires remplis, cliquez sur le bouton Suivant pour terminer la création de votre moissonneur.

3. Demander la validation du moissonneur

Une fois votre moissonneur configuré, demandez validation de votre moissonneur sur . Il va être examiné par l’équipe en charge de data.gouv.fr, pour vérifier qu’il est bien réglé. Si c’est le cas, le moissonneur sera validé et vous recevrez une notification.

De votre côté, vous pouvez vérifier que votre moissonneur moissonne correctement votre site. Pour ce faire :

1. Cliquez sur le bouton Voir dans l’administration une fois votre moissonneur créé ;

2. Cliquez sur le bouton Prévisualiser ;

3. Vérifiez que le moissonneur récupère bien des jeux de données.

Tant que votre moissonneur n’est pas validé, il ne référence aucun jeu de données sur data.gouv.fr.

Qu'est-ce que l'open data ?

Les données ouvertes (en open data) sont des données en accès libre et gratuit, réutilisables par toutes et tous. Autrement dit, vous pouvez librement :

• y accéder ;

• les utiliser ;

• les partager.

Il est possible de trouver des données ouvertes sur tout type de sujet :

• (comme les ) ;

• (comme la ) ;

• (comme la ) ;

• (comme le ) ;

Il existe par exemple des données sur , , , les , , sur (Météo-France), etc.

Ces données sont produites et mises à disposition par des administrations (ministères, collectivités territoriales), des entreprises (SNCF, Enedis, etc.), des acteurs de la société civile ou encore des citoyens.

Beaucoup de données ouvertes sont à retrouver sur , la plateforme nationale des données publiques françaises. Celle-ci vise à centraliser et structurer les données ouvertes en France et permet à toutes les organisations tenues de publier en open data de respecter leurs obligations. .

Comment utiliser l'open data ?

Les données en open data peuvent être exploitées pour tout type d’usage :

• trouver une information ;

• développer des analyses ;

• créer de nouveaux services (publics ou privés) ou d’en améliorer ;

• alimenter des travaux de recherche ;

Ces usages peuvent prendre des formes variées : visualisations, applications, articles de presse, papiers de recherche, etc.

Elles ont par exemple été utilisées pour élaborer des solutions permettant de :

• ;

• ;

• ;

• ;

De nombreux autres usages existent, et il est possible d’en découvrir davantage .

Ressources externes pour aller plus loin

Ce guide a pour vocation de vous fournir les éléments essentiels vous permettant d'exploiter des données ouvertes et de vous orienter sur la plateforme data.gouv.fr, afin que vous puissiez rapidement réaliser ce que vous souhaitez faire. Il propose des méthodes, des recommandations, des ressources et des outils autour du traitement de données brutes.

Ce guide :

• inventorie, structure et renvoie vers de nombreuses ressources externes ouvertes, non produites par l'équipe de data.gouv.fr, qui sont systématiquement rapportées à leurs concepteurs, que nous remercions pour leur précieux travail ;

• les complète avec des contenus produits par l'équipe de data.gouv.fr.

De nombreux acteurs publient en open data les données qu’ils produisent : administrations centrales (ministères, opérateurs de l’Etat, etc.), collectivités territoriales, entreprises, associations, acteurs de la société civile, think tanks, citoyens, etc.

Les producteurs ouvrent leurs données :

• soit en les publiant sur la plateforme data.gouv.fr, la plateforme nationale des données ouvertes : les données sont alors hébergées directement sur data.gouv.fr (exemples : ministère de la transition écologique, Haute Autorité de Santé, Centre national du cinéma et de l’image animée, etc.) ;

• soit en les publiant sur leur propre portail open data ou un autre portail open data mutualisé : les données, hébergées sur le portail en question, peuvent aussi être référencées sur, exposées et directement accessibles depuis data.gouv.fr, grâce à un système de (exemples : , , , , etc.).

a vocation à centraliser et structurer les données ouvertes en France. Elle permet à toutes les structures en charge d’une mission de service public, notamment les administrations, de répondre à leur obligation de publication par défaut de leurs données.

A partir des données disponibles sur :

• Des portails thématiques de données peuvent être créés : ils visent à recenser l’intégralité de l’offre de données ouvertes dans un domaine particulier pour en faciliter la diffusion auprès des réutilisateurs (, , ). Il ne s’agit pas de nouveaux portails open data, mais d’expositions thématiques du catalogue de . Les données qui y sont exposées sont disponibles dans les mêmes conditions que sur .

• Des projets et services sont développés par des réutilisateurs (ex : ) qui contribuent en retour à la communauté open data et à la plateforme en :

  • partageant leurs travaux, notamment en les référençant sur la plateforme

L’écosystème de l’open data se présente ainsi de la façon suivante :

Ressources externes pour aller plus loin

Racine

Le point d’entrée racine de l’API est .

Si vous souhaitez faire des tests sur la plateforme , le point d’entrée racine de l’API est .

Dans la suite de cette documentation, il y sera fait référence par $API.

Les données mises à disposition sur data.gouv.fr peuvent être réutilisées . Si vous êtes à l’origine d’une réutilisation, vous pouvez la référencer sur la page du jeu de données sur lequel vous vous êtes appuyés.

Ceci est la documentation de référence de l’API de data.gouv.fr. Elle est auto-générée et reflète exactement ce qui est effectivement en production.

Il est recommandé d’avoir lu l'introduction et la page prise en main de l'API avant de consulter cette page.

Choisir un standard technique pour la description d'un schéma de données

Il existe plusieurs standards techniques pour les schémas de données.

Le standard est à choisir en fonction :

• de la nature des données concernées ;

• des habitudes de l’écosystème produisant ou réutilisant les données liées au schéma.

Les principaux standards techniques sont les suivants :

• : adapté pour la description de données tabulaires (sous forme de tableurs ou de CSV). Ce standard technique utilise le format JSON. NB : il est possible de contraindre les colonnes avec ;

• : adapté pour la description de données avec une notion de hiérarchie. Ce standard utilise le format JSON ,

• : adapté pour la description de données avec une notion de hiérarchie. Ce standard utilise le format XML.

Tous ces standards techniques sont supportés par .

Créer un schéma de données

Une fois un standard technique choisi, il faudra créer les fichiers requis pour modéliser les données.

La documentation de chaque standard technique décrit le contenu des fichiers à renseigner. Reportez-vous aux documentations respectives pour tirer parti des fonctionnalités avancées offertes : types de données et contraintes sur les valeurs en particulier.

Il est possible de vérifier qu’un fichier correspond à un standard à l’aide d’outils en ligne ou en ligne de commande. Utilisez ces outils pour vérifier que vos productions correspondent au standard.

Documenter un schéma de données

En complément du fichier du schéma de données, il est recommandé de rédiger a minima deux documents complémentaires :

• Une documentation générale qui indique le contexte, les modalités de production des données, le cadre juridique, la finalité, les cas d’usage etc. Ce fichier est traditionnellement rédigé en Markdown et nommé README.md ;

• Un fichier répertoriant les changements permettant de suivre les modifications, d’une version à une autre. Ce fichier est traditionnellement rédigé en Markdown et nommé CHANGELOG.md.

La présence de ces fichiers représente un package complet (documentation, liste des changements et schéma de données décrit dans un standard technique), apprécié des réutilisateurs. se repose sur ces éléments pour intégrer votre documentation et votre liste de changements sur une page web.

Exemple : et du schéma des lieux de stationnement.

Publier et diffuser un schéma de données

Une fois votre schéma de données créé, il est nécessaire de le publier et de le diffuser pour que d’autres personnes puissent en bénéficier.

Il est recommandé de publier vos schémas de données en tant que logiciels libres, sur votre forge de développement ou par le biais de ou .

Vous bénéficierez alors des avantages habituels des dépôts de code Git en ligne :

• Historique des modifications

• Fonctionnalités de tickets

• Demandes de modifications.

• etc.

Il est conseillé d'utiliser un compte d’organisation (dédié à votre entreprise, direction, service, ministère) et non un compte personnel afin d’assurer une URL stable dans le temps.

Exemples à votre disposition : Plusieurs dépôts Git de schémas sont disponibles sur (exemple : à l’aide d’un schéma TableSchema sur GitHub).

Pour faciliter la découverte de votre schéma de données et des données sous-jacentes, il est recommandé de le faire référencer sur . La marche à suivre est détaillée .

Points de sortie

À l’issue de cette phase, vous devriez :

• Avoir implémenté votre schéma de données dans un des standards reconnus ;

• Avoir publié votre travail en ligne, dans un répertoire Git dédié ;

• Avoir pris contact avec les équipes de dans le but de référencer votre schéma de données si nécessaire.

Comment accéder aux statistiques sur data.gouv.fr ?