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.

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/

Endpoints¶

Liste d’adresses /addresses/¶

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

Liste des villes¶

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

Liste des départements¶

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

Liste des régions¶

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

Géocodage inversé¶

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

Géocodage (API Nominatim)¶

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

Rues d’un code postal¶

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