La donnée adresse qui compose la Base Adresse Nationale (BAN) est soit :
issue de données provenant d’acteurs historiques de l’adresse (IGN, Cadastre, etc.) ;
issue des Bases Adresses Locales (BAL) qui sont l’inventaire des adresses créé par les communes.
À terme, ces dernières devraient devenir la seule source. La commune doit certifier ces adresses, c’est-à-dire valider que les adresses saisies sont justes.
L’image ci-dessous résume la situation pour consolider les données adresses :
L'API Adresse est utilisée principalement pour :
trouver par un formulaire une adresse pour la corriger et/ou récupérer des coordonnées en ayant une liste de choix pour trouver le résultat : c’est l’autocomplétion ;
fournir un fichier tabulaire pour obtenir en retour une version enrichie des coordonnées et d’autres informations.
Pour accéder aux données d'adresses, il est possible de :
Récupérer directement les données. Cette méthode s’adresse à des utilisateurs avancés.
Utiliser l’API de recherche. Cette API peut rechercher des adresses soit via un appel unique par adresse soit en mode "batch" : on passe un fichier avec une liste d’adresse, une par ligne et on retourne la première adresse retournée pour chacune des lignes.
