← Retour à l’accueil de la FAQ

Découvrir l’OpenData en tant que développeur

Cette page contient :

Informations relatives à l’API

Le site « data.gouv.fr » propose différents moyen d'accéder au catalogue des données :

L'intégralité des opérations réalisables depuis le site via votre navigateur peuvent être automatisées (publication d'un jeu de données, création d'organisations, etc). Veuillez consulter la documentation dédiée pour y accéder.

Moissonnage des dépôts de données ouvertes

« data.gouv.fr » met à disposition une infrastructure de moissonnage, permettant d’être automatiquement intégrée sur la plateforme. Il est ainsi possible d’écrire son propre moissonneur en s’inspirant du code des moissonneurs existants, fournis en Open Source (comme tout le reste du site « data.gouv.fr », distribué sous le nom uData).

Aujourd'hui, les moissoneurs suivants sont disponibles :

  • CKAN (générique)
  • OpenDataSoft (générique)
  • maaf (spécifique Ministère de l'Agriculture, de l'Agroalimentaire et de la Forêt)

Le moissonnage n’est pas le seul moyen de synchroniser des données avec « data.gouv.fr », il est possible (voir recommandé) d’utiliser l’API pour pousser ses données.

Le code source de la plateforme

L’intégralité du code de la plateforme est gratuitement disponible en Open-Source sous licence AGPL3. Cet outil a été développé de façon modulaire pour permettre à tout un chacun de l’installer et de le personnaliser pour son usage propre en marque blanche. Nous avons par exemple développé les modules udata-gouvfr pour le rendu et udata-piwik pour les statistiques.

Vous pouvez contribuer en suivant la documentation dédiée et en proposant des pull-requests.

Intégrer des cartes sur vos propres sites

Vous avez la possibilité d’intégrer des jeux de données directement sur votre site. Il vous suffit pour cela d’intégrer le code suivant sur votre page HTML à l’endroit où vous souhaitez afficher le jeux de données :


<div data-udata-dataset-id="IDENTIFIANT DU JEU DE DONNÉES"></div>
<script src="https://www.data.gouv.fr/static/widgets.js" id="udata" async defer onload="udataScript.loadDatasets()"></script>

Vous pouvez récupérer l’IDENTIFIANT DU JEU DE DONNÉES en cliquant sur le bouton des Détails lorsque vous êtes sur la page d’un jeu de données, il sera de la forme : 549d48f9c751df513b04805b.

Si vous souhaitez intégrer plusieurs jeux de données, seule la balise div avec l’identifiant du jeu de données doit être dupliquée :


<div data-udata-dataset-id="IDENTIFIANT DU PREMIER JEU DE DONNÉES"></div>
<div data-udata-dataset-id="IDENTIFIANT DU SECOND JEU DE DONNÉES"></div>
<script src="https://www.data.gouv.fr/static/widgets.js" id="udata" async defer onload="udataScript.loadDatasets()"></script>

Si vous souhaitez intégrer tous les jeux de données relatifs à un territoire :


<div data-udata-territory="IDENTIFIANT DU TERRITOIRE"></div>
<script src="https://www.data.gouv.fr/static/widgets.js" id="udata" async defer onload="udataScript.loadTerritory()"></script>

Vous pouvez récupérer l’IDENTIFIANT DU TERRITOIRE en le construisant, il sera de la forme fr-town-1300413004 est le code INSEE de la commune (attention il diffère du code postal). Vous pouvez aussi récupérer un département fr-county-13 ou une région fr-region-93.

Enfin, si vous souhaitez intégrer tous les jeux de données relatifs à une organisation :


<div data-udata-organization="IDENTIFIANT DE L'ORGANISATION"></div>
<script src="https://www.data.gouv.fr/static/widgets.js" id="udata" async defer onload="udataScript.loadOrganization()"></script>

Vous pouvez récupérer l’IDENTIFIANT DE L'ORGANISATION dans l’url depuis votre interface d’administration.

Proposer une amélioration ← Retour à l’accueil de la FAQ