Intégration API API Adresse
Nous développons votre connecteur API Adresse
Nous branchons le service de géocodage de la Base Adresse Nationale sur vos formulaires : l'utilisateur tape trois lettres, choisit une adresse normalisée, et votre base récupère le code INSEE et les coordonnées.
- Équipe produit senior
- connecteurs de données publiques en production
- du cadrage au monitoring
À quoi sert l'API Adresse et pourquoi l'intégrer dans une application française ?
L'API Adresse transforme une adresse saisie librement en adresse normalisée avec ses coordonnées géographiques, son code INSEE et son code postal. Elle sait aussi faire l'inverse : trouver l'adresse la plus proche d'une position GPS. Construite sur la Base Adresse Nationale, elle est gratuite, sans inscription et maintenue par l'IGN. On l'intègre pour fiabiliser les saisies d'adresse dans un formulaire, géolocaliser une intervention ou valider un lieu de livraison avant d'affranchir un colis, en remplaçant une saisie libre par une donnée vérifiée et structurée.
Ce que nos clients construisent sur l'API Adresse
Autocomplétion dans le tunnel
L'adresse se choisit au lieu de se taper. Moins de colis non livrés, moins de courriers retournés, moins d'interventions au mauvais endroit.
Affectation automatique d'intervention
Les coordonnées et le code commune décident de l'agence, de la tournée ou du technicien compétent, sans arbitrage humain.
Reprise d'un historique d'adresses
Des dizaines de milliers d'adresses saisies à la main sont géocodées par lot, avec un rapport des lignes non résolues à traiter.
Contrôle d'éligibilité géographique
Zone desservie, secteur d'un franchisé, périmètre d'une aide locale : la réponse tombe pendant la saisie, pas après la validation.
Ce que ça change dans vos formulaires
La technique au service d'un résultat mesurable : moins d'adresses fausses, moins de trajets perdus, une donnée exploitable.
La fin des adresses approximatives
L'adresse est choisie dans une liste officielle plutôt que saisie librement. C'est la classe de bugs la plus banale et la plus coûteuse qui disparaît.
Un formulaire plus court
Trois lettres suffisent. Rue, code postal et commune arrivent ensemble, et l'utilisateur ne se trompe plus d'un chiffre sur le code postal.
Des données prêtes à servir
Chaque adresse validée sort avec ses coordonnées et son code INSEE, donc exploitable pour le routage, la tarification ou le reporting.
Un référentiel sans doublons
Un identifiant stable remplace la comparaison de chaînes, qui échoue toujours entre 8 bd du Port et 8 Boulevard du Port.
Comment nous livrons votre connecteur Adresse
Cadrage
Saisie en direct ou reprise de masse, niveau de précision exigé, règle d'acceptation. On tranche avant d'écrire une ligne de code.
Développement
Couche d'abstraction sur le fournisseur, URL de base en configuration, débounce et longueur minimale, annulation des requêtes obsolètes.
Recette
Rejeu sur vos adresses réelles, mesure du taux de résolution au niveau numéro, revue manuelle des cas résolus au niveau rue seulement.
Monitoring
Alerte sur les 429 et sur la chute du taux de résolution, rafraîchissement périodique du référentiel. La base évolue chaque semaine.
Ce que permet l'API Adresse
- Autocomplétion d'adresse
- Le mode auto-complétion est actif par défaut, avec filtrage possible par code postal, code commune ou département et jusqu'à cinquante résultats.
- Géocodage inverse
- Une position GPS devient une adresse exploitable : pointage de chantier, preuve de passage, déclaration d'incident, rapport d'intervention.
- Traitement par lot
- Un fichier CSV géocodé en une opération, en mode synchrone jusqu'à cinquante mégaoctets, ou en mode asynchrone pour les très gros volumes.
- Trois index interrogeables
- Adresses mises à jour chaque semaine, points d'intérêt et parcelles cadastrales chaque trimestre, combinables dans une même requête.
Le vocabulaire du géocodage
- banId
- L'identifiant stable d'une adresse dans la Base Adresse Nationale. C'est la clé de déduplication d'un référentiel : la comparaison de chaînes échoue toujours entre 8 bd du Port et 8 Boulevard du Port.
- citycode
- Le code INSEE de la commune, et non le code postal. C'est lui qui doit servir de clé de rattachement territorial : un code postal peut couvrir plusieurs communes, et Paris en compte vingt et un à lui seul.
- type
- Le niveau de correspondance : housenumber, street, locality ou municipality. C'est le champ sur lequel se décide l'acceptation, pas le score. Une livraison exige un numéro, une zone d'intervention se contente d'une rue.
- score
- Un indicateur de confiance, pas une probabilité, et sans seuil universel. Une correspondance exacte peut ressortir sous 0,5 simplement parce que le libellé existe dans deux communes. Le rejeter serait une erreur.
- autocomplete
- Le paramètre qui vaut 1 par défaut, adapté à la saisie en direct. Pour du géocodage de masse ou du rapprochement d'adresses existantes, il faut le passer à 0 pour obtenir un appariement sur la chaîne complète.
- index
- Le jeu interrogé : address pour la BAN, poi pour les points d'intérêt, parcel pour les parcelles cadastrales. Ils se combinent, et leurs fraîcheurs diffèrent : hebdomadaire pour le premier, trimestrielle pour les autres.
Les contraintes réelles de l'API Adresse
L'ancienne URL répond encore, et c'est le piège
La documentation annonce que api-adresse.data.gouv.fr est dépréciée et devait être décommissionnée fin janvier 2026. En août 2026 elle répondait toujours. Une intégration bâtie dessus fonctionne aujourd'hui et s'arrêtera sans préavis utile.
Le score ne se lit pas comme une probabilité
Une correspondance parfaite au numéro peut ressortir sous 0,5 quand la requête est ambiguë. Traiter un seuil de score comme un critère de rejet revient à écarter des adresses justes. La décision se prend sur le champ type.
Un seul appel CSV simultané par adresse IP
Cinquante appels par seconde sur les requêtes unitaires, mais un seul traitement de fichier en vol par IP. Un lot se conçoit avec une file et un verrou, jamais en parallélisant naïvement, sous peine de tout faire tomber.
Une adresse est une donnée personnelle
Envoyer un fichier client nominatif à un service de géocodage est un traitement à documenter. On n'envoie que les colonnes d'adresse, jamais le nom, l'email ou l'identifiant client, et on affiche l'attribution de la source.
API Adresse ou géocodeur commercial ?
Deux façons de normaliser une adresse. Le bon choix dépend de votre couverture géographique et de votre volume, pas de la technique.
| Critère | API AdresseService public | Géocodeur commercialGoogle, Mapbox |
|---|---|---|
| Couverture | France, très fine | Monde, qualité variable |
| Coût | Gratuit, licence ouverte | Facturé à la requête |
| Code INSEE de commune | Oui, dans la réponse | Rarement, à recomposer |
| Parcelles cadastrales | Oui, index dédié | Non, sauf option payante |
| Débit | 50 par seconde et par IP | Selon le contrat souscrit |
| Engagement de service | Aucun contrat opposable | Contrat et support |
| Le bon cas | Vos adresses sont en France | Vous adressez plusieurs pays |
Les deux se combinent : l'API Adresse pour la France, un fournisseur commercial en repli pour l'international. La couche d'abstraction rend ce choix réversible.
Ce que nous mesurons sur une intégration Adresse
Les autres API publiques
Les briques open data que nous branchons le plus souvent à côté.
API AdresseNous développons votre connecteur API AdresseCette page
Météo FrancePrévisions et observations, quand la météo entre dans vos règles métier.
URSSAFDonnées et contrôles sociaux, pour vos parcours employeur et paie.
SNCF & transportHoraires, perturbations et données de transport dans vos parcours.API Particulier
France Travail
DVF & cadastre
LegifranceNous développons votre connecteur Légifrance
API GéoOn combine API Adresse avec
La stack qui entoure le géocodage sur nos projets.
Intégration API Adresse : vos questions
Côté navigateur, un champ avec un délai d'attente d'environ trois cents millisecondes, une longueur minimale de trois caractères et l'annulation des requêtes obsolètes : sans cela, une frappe de vingt-cinq caractères génère vingt-cinq appels, dont vingt-quatre inutiles et arrivant dans le désordre. Côté serveur, un proxy qui porte les appels dès qu'il y a du volume, puisque la limite est par adresse IP, plus un cache court sur l'autocomplétion et long sur les adresses résolues. Côté base, on stocke le label, le code INSEE, les coordonnées, l'identifiant d'adresse et le niveau de correspondance, en gardant la saisie originale de l'utilisateur à côté.
Oui. Le service de géocodage de la Géoplateforme est ouvert, sans compte ni clé d'API, sous Licence ouverte 2.0, ce qui impose de mentionner la source, IGN et Base Adresse Nationale, partout où la donnée géocodée est affichée. Une seule exception : le traitement par lot asynchrone, pour les fichiers jusqu'à un gigaoctet, exige un espace de travail Géoplateforme et une authentification OAuth 2.0. Ce n'est pas un simple changement de paramètre par rapport au mode synchrone, c'est un autre parcours d'accès, à prévoir au cadrage.
Ne jamais bloquer l'utilisateur. La Base Adresse Nationale ne contient pas tout et ne le prétend pas : les adresses très récentes, les lieux-dits, certaines zones industrielles peuvent ne remonter qu'au niveau de la rue ou de la commune. Un produit qui exige un numéro pour continuer bloque des utilisateurs légitimes. La règle que nous posons est une acceptation par niveau de correspondance, avec conservation de la saisie originale et une file de géocodage différé. Une adresse non géocodée est un défaut de qualité, pas un motif de refus d'inscription.
La réponse tient dans une contrainte que peu de gens connaissent : le géocodage par fichier CSV n'autorise qu'un seul appel simultané par adresse IP. On ne parallélise donc pas, on découpe en lots successifs avec une file, un verrou et une reprise après interruption. Le mode synchrone accepte des fichiers jusqu'à cinquante mégaoctets, le mode asynchrone jusqu'à un gigaoctet mais avec un parcours d'accès authentifié. Nous chiffrons ce type de reprise au volume réel de votre fichier, après un test sur un échantillon représentatif.
Oui, et c'est l'audit le plus rentable que nous fassions sur cette catégorie. L'API a changé de domaine et d'opérateur : elle est désormais servie par l'IGN sur data.geopf.fr, et l'ancienne adresse est officiellement dépréciée avec un décommissionnement annoncé pour fin janvier 2026. Elle répondait pourtant encore en août 2026, ce qui explique que tant d'intégrations vivent sans le savoir sur une URL condamnée. La vérification prend une requête. La correction, si l'URL de base est en configuration, prend quelques minutes.
Un projet d'intégration Adresse ?
Parlons-en. 30 minutes pour cadrer votre besoin, vérifier ce que le service de géocodage permet vraiment et vous dire franchement ce qui est faisable.
Parler de mon projet API Adresse