Aller au contenu principal

Les API

L'API adresse

Ce service public ouvert à tous permet d'interroger la base de données de l’intégralité des adresses du territoire français gratuitement. L'API Adresse enregistre moyenne 1 milliard d'appels par mois (avril 2021). L'infrastructure a un coût direct d'environ 0,35€ par million d'adresses géocodées, versus les $4000 qui seraient facturés par certains grands acteurs du numérique.

Couverture

France métropolitaine, départements et régions d’outremer

Utiliser simplement l'API

Rappel aux intégrateurs qui utilisent cette API : il n'est pas utile de réaliser un appel pour chaque caractère saisi par les utilisateurs. Penser "Debouncing and Throttling"

Installer l'API

L'API Base Adresse Locale

Cette API permet d'effectuer toutes les actions réalisables sur l'éditeur en ligne de Bases Adresses Locales mes-adresses.data.gouv.fr, et notamment de

  • créer une Base Adresse Locale et

  • en gérer les adresses de façon fine.

Documentation

L'API de dépôt

Cette API permet de déposer une mise à jour d'une Base Adresse Locale dans la Base Adresse Nationale.

Documentation

L'API de signalement

L'API de Signalement permet de centraliser les demandes de corrections sur les adresses présentent dans la BAN et de les mettre à disposition des communes et producteurs de données adresse.

Documentation

L'API validateur

Cette API permet de vérifier la conformité des fichiers au format BAL. Elle détecte automatiquement si les fichiers sont au format BAL 1.3, 1.4 ou 1.5 et affiche en conséquence les éventuelles erreurs bloquantes et avertissements de non conformité.

Documentation