API adresse en France : géocodage, validation et autocomplétion

Une adresse fausse coûte toujours quelque chose : un colis qui revient, un appel au service client, une facture qui n'arrive pas. Le moyen le plus économique d'éviter ces coûts est d'empêcher l'adresse fausse d'entrer dans le système. C'est exactement le rôle d'une API adresse : votre formulaire envoie ce que l'internaute a saisi, l'API renvoie une adresse complète, structurée et vérifiée.

Ce guide sert de point d'entrée à tout ce que nous publions sur l'adresse en France. Il couvre l'écosystème public (BAN, IGN, Géoplateforme), le géocodage, la vérification d'adresse postale et l'autocomplétion en formulaire, ainsi que le choix entre le gratuit et le payant.

Ce que fait une API adresse, et quand elle devient nécessaire

Une API adresse est un service web. Vous lui envoyez une adresse, complète ou partielle, elle vous renvoie la version normalisée : numéro, libellé de voie, code postal, commune, code INSEE, et le plus souvent des coordonnées géographiques.

Elle devient nécessaire dès que des adresses entrent dans votre système et doivent être justes :

• E-commerce et tunnel de commande : moins d'abandons de panier, moins de livraisons en échec.
• CRM et base clients : des adresses propres à la saisie plutôt qu'un chantier de nettoyage deux ans plus tard.
• Logistique et tournées : des coordonnées fiables pour le calcul d'itinéraires et les zones de livraison.
• Onboarding et formulaires réglementaires : une saisie plus rapide et moins de rejets.

Le point commun : vous voulez que la question « cette adresse existe-t-elle vraiment ? » soit tranchée par un service, pas par la personne qui remplit le formulaire.

L'écosystème français : BAN, IGN et Géoplateforme

La France a une particularité que beaucoup de pays lui envient : un référentiel d'adresses public, gratuit et ouvert. La Base Adresse Nationale (BAN) recense les adresses du territoire et sert de socle à la plupart des outils que vous croiserez.

Il faut toutefois savoir où en est le service, car il a bougé récemment. L'API Adresse historique, hébergée sur api-adresse.data.gouv.fr, a été transférée de la DINUM à l'IGN et son ancien point d'entrée a été décommissionné : les intégrations doivent désormais passer par le service de géocodage de la Géoplateforme. Si vous maintenez du code écrit il y a deux ans, c'est probablement le premier sujet à traiter, et nous lui consacrons un article entier : migrer de l'API Adresse BAN vers la Géoplateforme.

À côté de la BAN, deux autres briques publiques reviennent souvent :

• l'API Découpage administratif (geo.api.gouv.fr), pour les communes, codes postaux, départements et régions ;
• les référentiels de La Poste, notamment autour de la normalisation postale, qui ne sont pas ouverts mais font autorité en matière de distribution du courrier.

Géocodage : de l'adresse aux coordonnées

Géocoder, c'est convertir une adresse en couple latitude / longitude. C'est ce qui vous permet d'afficher une commande sur une carte, de calculer une distance, ou de savoir si un client se trouve dans votre zone de livraison.

Deux points méritent votre attention. D'abord la précision : un géocodage « au numéro » pointe le bâtiment, un géocodage « à la voie » interpole selon la numérotation, un géocodage « à la commune » vous donne un centroïde qui peut se trouver à plusieurs centaines de mètres. Ensuite le score renvoyé par l'API, qui indique la qualité de la correspondance et qu'il ne faut pas confondre avec une garantie d'exactitude.

Le détail des deux sens de conversion, direct et inverse, se trouve dans notre article sur l'API de géocodage d'adresses. Et si le vocabulaire lui-même est nouveau pour vous, commencez plutôt par ce qu'est réellement le géocodage.

Vérification d'adresse postale : l'autre moitié du travail

Le géocodage vous dit où se trouve une adresse. Il ne vous dit pas si le facteur peut y déposer un colis. C'est la différence entre géolocaliser et vérifier une adresse postale, et elle compte dès que vous expédiez quelque chose.

En France, la vérification postale s'appuie sur les référentiels de distribution et répond à une question précise : cette adresse est-elle correctement rédigée, existe-t-elle dans le référentiel, et est-elle desservie ? C'est le meilleur rempart contre les NPAI, ces plis qui reviennent avec la mention « n'habite pas à l'adresse indiquée ». Nous détaillons la démarche dans vérifier une adresse postale avant expédition.

Un cran plus loin, la normalisation met l'adresse en forme selon les règles postales françaises, celles qui découpent l'adresse en lignes et imposent des libellés précis. Le sujet a son propre article : la normalisation d'adresse et la RNVP.

Autocomplétion : traiter le problème à la saisie

La correction la moins chère est celle qu'on n'a pas à faire. L'autocomplétion propose des adresses réelles pendant que le client tape, ce qui supprime la faute de frappe au lieu de la rattraper. Sur un tunnel de commande, l'effet est double : moins d'erreurs et moins de champs à remplir, donc un meilleur taux de conversion.

La mise en œuvre concrète, côté interface comme côté API, est traitée dans l'autocomplétion d'adresse dans vos formulaires.

Codes postaux et communes : la couche administrative

Beaucoup de besoins ne portent pas sur l'adresse exacte mais sur la maille administrative : à quelle commune correspond ce code postal, quel est le code INSEE associé, quelles communes couvrent un département. En France, la relation entre code postal et commune n'est d'ailleurs pas simple, puisqu'un code postal peut couvrir plusieurs communes et une commune porter plusieurs codes postaux.

C'est un sujet à part entière, traité dans l'API code postal et communes.

Et quand vos clients passent la frontière

C'est la limite structurelle du service public français, et elle arrive plus vite qu'on ne le pense : la BAN couvre la France. Elle ne peut pas valider une adresse bruxelloise, un NPA genevois ou une PLZ allemande.

Or les hypothèses françaises tombent dès la frontière. Le code postal fait quatre chiffres en Belgique, en Suisse et au Luxembourg, pas cinq. En Allemagne, le numéro se place après le nom de la voie. En Belgique, la même commune porte souvent un nom français et un nom néerlandais, tous deux valides. Un formulaire calibré pour la France rejette donc des adresses parfaitement correctes, ou pire, en accepte de fausses.

Nous détaillons les formats et les pièges pays par pays dans codes postaux et adresses des pays voisins.

Premier appel en cinq minutes

Les API d'adresse s'interrogent depuis n'importe quel langage : vous envoyez l'adresse et votre clé, vous recevez l'adresse structurée en retour.

Le détail de l'appel, avec les paramètres attendus et un exemple de code prêt à copier, est dans la documentation développeur.

Deux réflexes à prendre dès le premier jour. Appelez l'API depuis votre serveur et non depuis le navigateur si la clé est facturée, sinon n'importe qui peut la réutiliser. Et décidez tout de suite de ce que vous stockez : la saisie brute, l'adresse corrigée, ou les deux. Conserver les deux est la seule façon d'expliquer une correction six mois plus tard.

Service public gratuit ou API commerciale ?

La question se pose sérieusement en France, parce que le service public est bon. Quelques critères pour trancher :

• Le volume et les quotas. Les API publiques appliquent des limites de débit pensées pour un usage raisonnable. Un tunnel de commande à fort trafic les atteint.
• L'engagement de service. Un service gratuit ne vous doit rien. Si une indisponibilité bloque vos commandes, c'est un risque métier, pas un incident technique.
• La couverture. La BAN couvre la France. Dès que vos clients sont en Belgique, en Suisse ou en Allemagne, il vous faut autre chose, et de préférence un seul format de réponse pour tout le monde plutôt qu'une intégration par pays.
• Le périmètre fonctionnel. Géocoder est une chose ; vérifier, normaliser, compléter à la saisie et calculer des distances en est une autre.

Notre position est simple : si vous êtes en France uniquement, avec un volume modeste et sans exigence de disponibilité, les services publics font le travail. Dès que l'un de ces trois paramètres change, une API commerciale se justifie.

Ce que propose Pro6PP

Pro6PP est une API d'adresse européenne. Pour la France, nous fournissons la complétion et la validation d'adresse, la suggestion à la saisie, la recherche par zone, le géocodage inverse et le calcul de distance, à vol d'oiseau comme par la route. La même API couvre les Pays-Bas, la Belgique, l'Allemagne, le Luxembourg, le Danemark, l'Autriche, la Suisse, l'Espagne et le Royaume-Uni, avec un format de réponse identique partout.

Questions fréquentes

Existe-t-il une API adresse gratuite en France ?

Oui. La Base Adresse Nationale est un service public gratuit, aujourd'hui servi par la Géoplateforme de l'IGN, avec des quotas d'usage. C'est un excellent point de départ pour un projet à volume modéré.

Quelle est la différence entre géocoder et vérifier une adresse ?

Le géocodage donne des coordonnées à une adresse. La vérification confirme que l'adresse existe dans un référentiel et qu'elle est desservie. Une adresse peut être géocodée avec un score correct sans être distribuable.

Un code postal correspond-il à une seule commune ?

Non, et c'est une source d'erreurs classique. Un code postal peut couvrir plusieurs communes, et certaines communes utilisent plusieurs codes postaux. Le code INSEE, lui, identifie la commune de façon unique.

Faut-il appeler l'API depuis le navigateur ou depuis le serveur ?

Depuis le serveur dès que la clé est facturée ou soumise à quota, car une clé placée dans du JavaScript côté client est lisible par tout le monde.

Que faire si l'API ne trouve pas l'adresse ?

Ne bloquez pas la commande. Proposez les suggestions les plus proches, et si aucune ne convient, laissez le client confirmer sa saisie en marquant l'enregistrement comme non vérifié. Les logements neufs sont le cas légitime le plus fréquent.

Pour aller plus loin

Commencez petit : branchez la complétion sur un seul formulaire, mesurez le taux de complétion et le nombre de retours, puis étendez.

• Consulter la documentation API
• Créer un compte
• Se connecter
• Toutes les actualités