En amont de la publication de données sur data.gouv.fr, il est important de bien préparer le jeu de données. Pour ce faire, nous vous invitons à consulter guide qualité.
Plusieurs modes de mises en ligne sont possibles sur la plateforme data.gouv.fr :
Publication manuelle sur data.gouv.fr
Par API
Par moissonnage
Certains jeux de données font l'objet de spécificités pour leur publication, comme les Bases Adresses Locales. La procédure de publication d'une Base Adresse Locale est détaillée dans cette page.
Pour mettre à disposition vos données directement sur data.gouv.fr, la procédure à suivre est la suivante :
Un jeu de données peut être publié sous le nom de votre compte utilisateur ou sous la bannière d’une organisation.
Nous vous conseillons de publier un jeu de données sous le nom de votre compte utilisateur seulement s’il n’a pas été produit dans le cadre des activités d’une organisation à laquelle vous êtes rattaché.
L'étape de description est cruciale pour que vos jeux de données soient bien référencés et faciliter la réutilisation.
| Information | Description de l'information |
|---|---|
*Les champs identifiés par un astérisque sont obligatoires.
Un jeu de données peut contenir plusieurs types de fichiers (données mises à jour, données historisées, documentation, code source, API, lien, etc.).
Vous avez la possibilité d’importer vos fichiers sur data.gouv.fr selon différents modes de mise à disposition.
Lors de l’étape “Ajoutez vos ressources”, deux options vous sont proposées :
Vous pouvez télécharger vos ressources depuis votre ordinateur vers le serveur de data.gouv.fr. Vos ressources seront alors hébergées sur les serveurs de data.gouv.fr.
Vous pouvez créer un lien vers une ressource distante existante. Les informations contenues dans le fichier resteront hébergées sur le serveur distant fléché.
Qu’est-ce qu’une API ?
Une API est une interface, un contrat passé entre deux systèmes informatiques pour leur permettre de communiquer. Cette solution informatique permet d’automatiser des tâches depuis votre ordinateur ou vos serveurs.
A partir de l’API de data.gouv.fr, vous pouvez réaliser les mêmes actions que sur la plateforme :
Créer un jeu de données au nom de votre compte utilisateur ou au nom de votre organisation ;
Décrire votre jeu de données et les ressources associées ;
Ajouter ou supprimer une ressource ou un jeu de données.
L’API de data.gouv.fr propose également des fonctionnalité complémentaires à la publication de jeux de données comme la possibilité de récupérer les métadonnées des jeux de données ou de fichiers ou encore d'accéder au contenu des fichiers d’un jeu de données.
À la différence du mode de mise à disposition directe des données sur data.gouv.fr, l’utilisation de l’API permet de réaliser des actions de manière automatisée depuis votre ordinateur ou vos serveurs. Il est par conséquent conseillé d’utiliser une API lorsque la fréquence de publication d’un jeu de données est régulière.
L’utilisation de l’API de data.gouv.fr se fait par le point d’entrée racine de l’API. Afin de pouvoir exécuter des opérations d’écriture, il est nécessaire d’obtenir une clé API. Cette clé est accessible depuis les paramètres de votre profil administrateur.
Les appels à l’API sont soumis aux mêmes permissions que l’interface web. Par exemple, si vous souhaitez publier ou modifier un jeu de données au nom d’une organisation, vous devez appartenir à cette organisation.
La procédure pour publier des données sur data.gouv.fr par API est détaillée dans cette sous-section.
Qu’est-ce que le moissonnage ?
Le moissonnage est un mécanisme permettant de collecter les métadonnées sur un catalogue distant et de les stocker sur une autre plateforme afin de proposer un second point d’accès aux données.
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.
Si vous mettez en ligne des données publiques sur une plateforme ouverte, dans un format dont les métadonnées correspondent à la syntaxe ODS, CKAN, ou DCAT vous pouvez les référencer automatiquement sur data.gouv.fr en utilisant notre service de moissonnage.
Pour utiliser le service de moissonnage, il est possible de demander au moissonneur d’importer l’ensemble des données ou de ne sélectionner que certains jeux de données au moyen de filtres. Il n’est pas nécessaire de créer un moissonneur par jeu de données à importer, un seul moissonneur par portail suffit.
Le principe du moissonnage sur data.gouv.fr se décompose en plusieurs étapes :
Vous créez un moissonneur sur data.gouv.fr afin que data.gouv.fr suive l’activité de votre plateforme ;
Vous publiez des données sur votre plateforme open data ;
Vous demandez la validation de votre moissonneur sur le support data.gouv.fr ;
La configuration du moissonneur est validée par l’équipe en charge de data.gouv.fr ;
Le moissonneur de data.gouv.fr vient automatiquement récupérer les données de votre plateforme ;
La procédure de moissonnage est détaillée dans cette sous-section.
Lexique : Base Adresse Locale Fichier géré par une collectivité locale (habituellement une commune ou un EPCI) et contenant toutes ses adresses géolocalisées. Une Base Adresse Locale publiée et à jour garantit une meilleure prise en compte des adresses dans les différents systèmes d’information des acteurs, qu’ils soient privés ou publics. Depuis 2019, les Bases Adresses Locales sont prioritaires dans la Base Adresse Nationale : une commune qui publie sa Base Adresse Locale devient la seule source d'adresses sur son territoire.
Deux méthodes de publication d'une Base Adresse Locale pour intégration dans la Base Adresse Nationale sont possibles sur data.gouv.fr :
Pour publier manuellement une Base Adresse Locale sur data.gouv.fr :
Vérifiez vos fichiers .csv dans le validateur pour vous assurer qu'ils sont conformes et qu'ils pourront être intégrés à la Base Adresse Nationale ;
Suivez ensuite la procédure standard de publication de données sur data.gouv.fr, en veillant à ajouter le mot clé "base-adresse-locale".
N'oubliez pas de mettre à jour vos données !
Pour publier une Base Adresse Locale sur data.gouv.fr par moissonnage, les étapes à suivre sont les suivantes :
Demandez à data.gouv.fr de moissonner votre site, en veillant à ajouter le mot clé "base-adresse-locale" ;
Avant d'automatiser, vérifiez votre fichier .csv dans le validateur pour vous assurer qu'il est conforme et qu'il pourra être intégré à la Base Adresse Nationale.
N'oubliez pas de mettre à jour vos données !
La documentation en ligne précise toutes les spécificités de cette méthode de publication.
D'autres méthodes permettent de publier une Base Adresse Locale pour intégration dans la Base Adresse Nationale.
Il est notamment recommandé d'utiliser l'éditeur "Mes Adresses". "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 formulaire de dépôt sur adresse.data.gouv.fr ;
Pour en savoir plus, nous vous invitons à consulter la documentation proposée par adresse.data.gouv.fr.
Les données de votre plateforme sont référencées et visibles sur data.gouv.fr.
Titre*
Le titre de votre jeu de données doit être le plus précis et spécifique possible. Il doit également correspondre au vocabulaire employé par les utilisateurs. Ces derniers recherchent les données le plus souvent dans un moteur de recherche.
Sigle
Vous avez la possibilité d’apposer un sigle à votre jeu de données. Les lettres qui composent ce sigle n’ont pas besoin d’être séparées par des points.
Description*
La description de votre jeu de données permet aux personnes qui le consultent d’obtenir des informations sur le contenu et la structure des ressources publiées, le contexte de production des données, les contacts producteurs etc.
Licence
Les licences définissent les règles de réutilisation des jeux de données publiés. En choisissant une licence de réutilisation, vous vous assurez que le jeu de données publié sera réutilisé selon les conditions d’usage que vous avez définies. Afin d’éviter la multiplication des licences, la loi pour une République numérique a prévu la création d’une liste de licences qui peuvent être utilisées par les administrations. Le site data.gouv.fr a référencé la liste des licences applicables aux informations publiques (données, documents…).
Fréquence de mise à jour*
La fréquence de mise à jour correspond à la fréquence à laquelle vous prévoyez de mettre à jour les données publiées. Cette fréquence de mise à jour reste indicative.
Mots clés
Les mots clés caractérisent votre jeu de données. Ils apparaissent sur la page de présentation et apportent un meilleur référencement du jeu de données lors d’une recherche utilisateur.
Couverture temporelle
La couverture temporelle indique la portée dans le temps des données publiées.
Granularité spatiale
La granularité spatiale indique le niveau de détail géographique le plus fin que peut couvrir vos données.
Mode privé
L’activation du mode privé permet de ne pas mettre en ligne le jeu de données. Cela laisse la possibilité de l’éditer avant sa publication.
