h1. Base Adresse

Le connecteur Base Adresse permet d'interroger la Base Adresse Nationale (BAN). Il n'y a pas besoin de token.

Les API de géocodage sont une vue partielle de l’API de Nominatim https://wiki.openstreetmap.org/wiki/Nominatim ; elles ne prennent pour le moment pas en charge tous les paramètres et sont limitées au format JSON. Les API sur les villes, départements et régions sont basées sur API Géo https://api.gouv.fr/api/api-geo.html.

h2. Paramétrage

Le paramétrage doit indiquer : 

* le nom donné au connecteur (par ex. Base Adresse)
* un slug (par ex. base-adresse)
* l'url du webservice : https://api-adresse.data.gouv.fr/ (renseigné par défaut)
*  URL l’API Géo : https://geo.api.gouv.fr/ (renseigné par défaut)
*  Codes postaux ou numéros de départements d’où récupérer les rues, séparés par des virgules ; par exemple :
** @44@ pour récupérer l'ensemble des adresses du département de Loire Atlantique
** @44000,44100,44200, 44300@ pour récupérer les adresses de la ville de Nantes
** @44190@ pour récupérer les rues de la commune de Clisson
* si Latitude et Longitude sont renseignés, ces coordonnées seront utilisées pour prioriser (trier par distance) les résultats pour le endpoint @/addresses/@

h2. Endpoints

h3. Liste d’adresses /addresses/

Retourne les adresses correspondant aux paramètres passés.

h3. Liste des villes

Retourne les villes correspondant aux paramètres passés.

h3. Liste des départements

Retourne les départements correspondant aux paramètres passés.

h3. Liste des régions

Retourne les régions correspondant aux paramètres passés.

h3. Géocodage inversé

Retourne l'adresse correspondant à la latitude et la longitude passées en paramètre.

h3. Géocodage (API Nominatim)

Retourne la latitude, la longitude et l'adresse normalisée correspondant à la recherche passée en paramètre.

h3. Rues d’un code postal 

Retourne les rues correspondant au code postal passé en paramètre.