Alternative a l'API BAN : pourquoi migrer vers GEOREFER en 2026

En France, la Base Adresse Nationale (BAN) reste la reference publique pour le geocodage. Gratuite, open source, alimentee par les communes et l'IGN, elle rend un service considerable a l'ecosysteme numerique francais. Mais en 2026, les exigences des applications professionnelles en FinTech, RegTech et e-commerce depassent largement ce que la BAN peut offrir seule. Cet article examine les forces et les limites de l'API BAN, puis explique comment GEOREFER comble ces lacunes pour les equipes qui ont besoin d'un referentiel geographique complet avec SLA, scoring de fiabilite et donnees entreprises.

1. Le paysage des API d'adresse en France en 2026

Le marche francais des API d'adresse a considerablement evolue ces dernieres annees. Trois grandes categories d'acteurs coexistent aujourd'hui :

• Les API publiques (BAN, geo.api.gouv.fr) : gratuites, open data, sans SLA contractuel.
• Les solutions internationales (Google Address Validation, HERE, Mapbox) : puissantes mais couteuses, sans donnees INSEE ni normalisation AFNOR.
• Les API specialisees France (GEOREFER) : SaaS dedie au referentiel geographique francais, combinant validation, normalisation et enrichissement dans une seule API.

Le choix entre ces solutions depend de votre cas d'usage. Pour un projet hobby ou un prototype, la BAN est parfaitement adaptee. Pour une application de production qui doit valider des adresses dans un contexte reglementaire, les limites apparaissent rapidement. Voyons pourquoi.

2. Qu'est-ce que l'API BAN exactement ?

La Base Adresse Nationale est le referentiel d'adresses officiel de la France. Geree par l'IGN, la DINUM et les communes, elle contient plus de 26 millions d'adresses geocodees. L'API associee, hebergee sur api-adresse.data.gouv.fr, propose trois fonctionnalites principales :

• Geocodage direct : convertir une adresse textuelle en coordonnees GPS (latitude/longitude).
• Geocodage inverse : trouver l'adresse la plus proche a partir d'un point GPS donne.
• Autocompletion : suggerer des adresses pendant la saisie dans un formulaire.

Architecture technique de la BAN

L'API BAN repose sur Addok, un moteur de geocodage open source ecrit en Python. Il utilise Redis comme base de donnees principale avec un index phonetique et textuel. L'architecture est concue pour la recherche en texte libre, pas pour la validation structuree d'adresses.

Format de requete BAN

L'API BAN utilise une architecture REST simple avec des parametres GET. Voici un exemple typique :

GET https://api-adresse.data.gouv.fr/search/?q=15+rue+de+la+paix+75002+paris&limit=1

La reponse est un GeoJSON standard avec un score de confiance entre 0 et 1, les coordonnees GPS et quelques metadonnees administratives (code INSEE, code postal, nom de commune). Ce format est adapte au geocodage mais insuffisant pour la validation d'adresse a des fins reglementaires.

3. Les forces de l'API BAN (soyons honnetes)

L'API BAN presente des avantages reels qu'il serait malhonnete d'ignorer :

• Entierement gratuite : aucun cout, aucune inscription, aucune cle API requise. C'est un bien commun numerique finance par l'Etat et accessible a tous.
• Donnees officielles et autoritaires : alimentee par les communes elles-memes via le programme Base Adresse Locale (BAL), ce qui lui confere une autorite incontestable sur les adresses francaises.
• Open source : le code source d'Addok est publie sur GitHub, ce qui permet a chacun de l'auto-heberger, de l'auditer ou de contribuer a son amelioration.
• Simplicite d'integration : une requete GET avec un parametre q suffit pour obtenir un resultat. L'integration dans une application prend quelques minutes.
• Communaute active : le projet beneficie d'une communaute de contributeurs et d'utilisateurs qui ameliorent continuellement la qualite des donnees geographiques.
• Couverture nationale complete : 26 millions d'adresses couvrent l'integralite du territoire francais, y compris les departements et regions d'outre-mer.

Pour un projet personnel, un prototype, une application citoyenne ou un projet open data avec un volume modere, la BAN est souvent le meilleur choix. Mais les besoins professionnels introduisent des exigences que la BAN n'a pas ete concue pour satisfaire.

4. Les 6 limites de la BAN pour un usage professionnel

4.1. Aucun SLA garanti

L'API BAN est un service public fourni en "best effort". Aucun contrat de niveau de service (SLA) ne garantit la disponibilite, le temps de reponse ou la continuite du service. En pratique, des interruptions non planifiees surviennent sans preavis et sans engagement de delai de retablissement. Pour une application de production traitant des flux de verification d'adresse en continu, cette incertitude est inacceptable. Une indisponibilite de quelques heures peut bloquer l'ensemble d'un pipeline d'onboarding client.

4.2. Rate limiting strict sans possibilite d'augmentation

La BAN impose une limite de 50 requetes par seconde par IP. Cette limite est fixe et non negociable : il n'existe pas de plan payant permettant de l'augmenter. Pour une FinTech traitant des milliers de verifications d'identite par jour ou un e-commerce pendant les pics de soldes, ce plafond devient rapidement un goulot d'etranglement. GEOREFER propose des quotas adaptes au plan souscrit, de 50 requetes/jour en DEMO jusqu'a un acces illimite pour les plans ENTERPRISE.

4.3. Absence totale de donnees entreprises (SIRENE)

La BAN ne contient que des adresses. Pour obtenir des informations sur les entreprises (numero SIREN, SIRET, code NAF, forme juridique, date de creation), il faut interroger une API completement separee (API Entreprise de la DINUM ou API SIRENE de l'INSEE), avec une authentification differente et des quotas distincts. GEOREFER integre 16,8 millions d'etablissements SIRENE directement accessibles via les memes endpoints et la meme cle API. Consultez notre article sur l'integration SIRENE dans GEOREFER pour en savoir plus.

4.4. Scoring basique (0-1) sans analyse composite

Le score de confiance de la BAN est un nombre decimal entre 0 et 1, calcule principalement sur la similarite textuelle entre la requete soumise et le resultat retourne. Ce score ne prend en compte ni la coherence geographique entre les differentes couches administratives (code postal, commune, departement, code INSEE), ni le risque pays selon les criteres FATF/GAFI.

Le GeoTrust Score de GEOREFER fournit un score composite de 0 a 100 decompose en 4 sous-scores ponderes, chacun apportant une dimension complementaire d'analyse :

• Confiance (35%) : precision du match entre l'adresse soumise et l'adresse trouvee.
• Coherence geographique (25%) : validation croisee entre code postal, commune, departement et code INSEE.
• Match postal (20%) : precision du code postal (exact, multiple ou invalide).
• Risque pays (20%) : evaluation basee sur les listes FATF/GAFI (membres, grey list, black list).

4.5. Pas de normalisation AFNOR (NF Z 10-011)

La BAN retourne l'adresse telle qu'elle est stockee dans sa base de donnees, sans aucune transformation. Elle ne propose pas de normalisation conforme a la norme AFNOR NF Z 10-011, le standard postal francais qui definit le format en 6 lignes de 38 caracteres maximum. Cette normalisation est indispensable pour les envois postaux automatises, les processus de verification d'identite bancaire et la conformite documentaire.

4.6. Pas de fuzzy search ni de tolerance aux erreurs de saisie

L'autocompletion de la BAN fonctionne principalement par prefixe et correspondance quasi-exacte. Une faute de frappe comme "Touluse" au lieu de "Toulouse" ou "Marsaille" au lieu de "Marseille" peut ne retourner aucun resultat pertinent. GEOREFER utilise Elasticsearch avec un analyseur edge n-gram et ASCII folding pour tolerer les fautes de frappe, les accents manquants et les variations orthographiques courantes.

5. Comparaison detaillee : BAN VS GEOREFER

Le tableau suivant compare les deux solutions sur 14 criteres cles pour un usage professionnel. Pour une analyse encore plus approfondie, consultez notre article dedie GEOREFER vs API BAN.

6. Guide de migration : de la BAN vers GEOREFER

La migration de l'API BAN vers GEOREFER s'effectue en quelques etapes. Le changement principal concerne le passage d'une requete GET avec un parametre de texte libre a une requete POST avec un corps JSON structure. Ce changement apporte une precision nettement superieure dans les resultats car chaque composant de l'adresse est traite individuellement.

6.1. Avant : requete BAN

# Geocodage BAN : adresse en texte libre via parametre GET
curl -s "https://api-adresse.data.gouv.fr/search/\
?q=15+rue+de+la+paix+75002+paris&limit=1"

# Reponse GeoJSON simplifiee :
# {
#   "type": "FeatureCollection",
#   "features": [{
#     "properties": {
#       "label": "15 Rue de la Paix 75002 Paris",
#       "score": 0.89,
#       "postcode": "75002",
#       "citycode": "75102",
#       "city": "Paris"
#     },
#     "geometry": {
#       "coordinates": [2.330869, 48.868701]
#     }
#   }]
# }

6.2. Apres : requete GEOREFER

# Validation d'adresse GEOREFER : champs structures via POST JSON
curl -s -X POST \
  "https://georefer.io/geographical_repository/v1/addresses/validate" \
  -H "Content-Type: application/json" \
  -H "X-Georefer-API-Key: VOTRE_CLE_API" \
  -d '{
    "street_number": "15",
    "street_name": "Rue de la Paix",
    "postal_code": "75002",
    "city": "Paris",
    "country_code": "FR"
  }'

# Reponse enrichie :
# {
#   "success": true,
#   "data": {
#     "is_valid": true,
#     "confidence_score": 95,
#     "geo_trust_score": {
#       "overall": 88,
#       "confidence": 95,
#       "geo_consistency": 100,
#       "postal_match": 100,
#       "country_risk": 42
#     },
#     "normalized_address": {
#       "line1": "15 RUE DE LA PAIX",
#       "line4": "75002 PARIS"
#     },
#     "insee_code": "75102",
#     "department_code": "75",
#     "region": "Ile-de-France"
#   }
# }

6.3. Ce que vous gagnez avec la migration

• GeoTrust Score : un score composite sur 100 au lieu d'un simple decimal opaque. Quatre sous-scores detailles permettent l'audit et la conformite reglementaire.
• Normalisation AFNOR : l'adresse normalisee selon la norme NF Z 10-011 est incluse automatiquement dans chaque reponse de validation.
• Enrichissement INSEE : code commune, code departement, region, population, coordonnees GPS et donnees economiques sont retournes dans la meme reponse.
• Donnees SIRENE : recherchez une entreprise par SIREN, SIRET ou raison sociale dans la meme API, avec la meme cle d'authentification.
• Champs structures : au lieu de parser une chaine de texte libre, vous envoyez et recevez des champs distincts (numero, rue, code postal, ville), eliminant toute ambiguite.

7. Exemples de code : migration pas a pas

7.1. Python : avant (BAN)

import requests

# Recherche d'adresse via la BAN (texte libre)
response = requests.get(
    "https://api-adresse.data.gouv.fr/search/",
    params={"q": "15 rue de la paix paris", "limit": 1}
)
data = response.json()

if data["features"]:
    props = data["features"][0]["properties"]
    score = props["score"]          # 0.89 (decimal, opaque)
    city = props["city"]            # "Paris"
    postcode = props["postcode"]    # "75002"
    coords = data["features"][0]["geometry"]["coordinates"]
    print(f"Score: {score}")
    print(f"Ville: {city}, CP: {postcode}")
    print(f"Coords: {coords[1]}, {coords[0]}")
else:
    print("Aucun resultat")

7.2. Python : apres (GEOREFER)

import requests

API_KEY = "VOTRE_CLE_API"
BASE = "https://georefer.io/geographical_repository/v1"

# Validation d'adresse structuree avec scoring
response = requests.post(
    f"{BASE}/addresses/validate",
    headers={
        "Content-Type": "application/json",
        "X-Georefer-API-Key": API_KEY
    },
    json={
        "street_number": "15",
        "street_name": "Rue de la Paix",
        "postal_code": "75002",
        "city": "Paris",
        "country_code": "FR"
    }
)
data = response.json()

if data["success"]:
    result = data["data"]
    trust = result["geo_trust_score"]
    print(f"Adresse valide : {result['is_valid']}")
    print(f"GeoTrust Score : {trust['overall']}/100")
    print(f"  Confiance       : {trust['confidence']}")
    print(f"  Coherence geo   : {trust['geo_consistency']}")
    print(f"  Match postal    : {trust['postal_match']}")
    print(f"  Risque pays     : {trust['country_risk']}")
    print(f"Code INSEE : {result['insee_code']}")
else:
    print(f"Erreur : {data.get('error', 'inconnue')}")

7.3. Recherche SIRENE (bonus GEOREFER)

Avec la BAN, les donnees entreprises ne sont tout simplement pas disponibles. Avec GEOREFER, une seule requete suffit :

# Recherche d'entreprises par nom, filtree par departement
curl -s "https://georefer.io/geographical_repository/v1\
/companies/search?name=boulangerie&department_code=75\
&page=0&size=5" \
  -H "X-Georefer-API-Key: VOTRE_CLE_API"

# Retourne : SIREN, SIRET, raison sociale, adresse complete,
# code NAF, forme juridique, date de creation, statut actif/ferme

Pour un guide d'integration complet couvrant tous les endpoints disponibles, consultez notre guide de demarrage rapide GEOREFER.

8. Quand garder la BAN, quand passer a GEOREFER

8.1. Gardez la BAN si...

• Votre projet est un hobby, un prototype ou une preuve de concept sans contrainte de disponibilite.
• Vous contribuez a un projet open data, une initiative citoyenne ou un projet associatif.
• Votre budget est strictement zero euro et votre volume de requetes reste en dessous de 50 req/s.
• Vous avez uniquement besoin de geocodage simple (convertir une adresse en coordonnees GPS).
• Vous avez les competences pour auto-heberger Addok et gerer l'infrastructure correspondante.
• Vous n'avez aucune contrainte reglementaire sur la qualite de la validation d'adresse.

8.2. Passez a GEOREFER si...

• Vous operez dans un contexte KYC, AML ou conformite reglementaire et avez besoin d'un scoring auditable avec des sous-scores detailles.
• Votre application de production exige un SLA garanti avec engagement contractuel de disponibilite et de temps de reponse.
• Vous avez besoin des donnees SIRENE (informations entreprises) dans la meme API que la validation d'adresse.
• La normalisation AFNOR NF Z 10-011 est requise pour vos envois postaux, vos documents officiels ou vos processus internes.
• Vos utilisateurs font regulierement des fautes de frappe et vous avez besoin d'une recherche tolerante aux erreurs avec autocompletion intelligente.
• Vous voulez un dashboard de suivi en temps reel avec des metriques d'utilisation, des graphiques et des alertes de quotas.
• Vous traitez des volumes superieurs a 5 000 requetes par jour de facon previsible et reguliere.
• Vous avez besoin de l'historique COG des communes (fusions, scissions, renommages) pour tracer les changements administratifs.

9. Questions frequentes

La BAN va-t-elle disparaitre ?

Non. La BAN est un projet d'interet national finance par l'Etat. Elle continuera d'etre maintenue, amelioree et enrichie par les contributions communales. La question n'est pas de la remplacer, mais de la completer avec des fonctionnalites professionnelles qu'elle n'a pas vocation a offrir : SLA, normalisation, scoring composite et donnees entreprises.

GEOREFER utilise-t-il les donnees de la BAN ?

GEOREFER s'appuie sur les referentiels officiels francais (Code Officiel Geographique de l'INSEE, referentiel des codes postaux, base SIRENE) pour construire son propre referentiel geographique enrichi. Les donnees sont croisees, validees et indexees dans Elasticsearch pour fournir un service de validation et de normalisation qui va bien au-dela du simple geocodage propose par la BAN.

Combien de temps prend la migration ?

Pour un developpeur familier avec les API REST, la migration technique se realise en quelques heures. Le changement principal est le passage d'un GET avec un parametre de texte libre a un POST avec un corps JSON structure. Le portail developpeur fournit des exemples de code prets a l'emploi dans 4 langages (cURL, Python, JavaScript, Java) ainsi qu'un playground interactif pour tester chaque endpoint avant de l'integrer en production.

Puis-je tester GEOREFER gratuitement ?

Oui. Le plan DEMO est entierement gratuit et offre 50 requetes par jour avec acces aux endpoints villes, pays et recherche. Le plan FREE offre 100 requetes par jour. Aucune carte bancaire n'est requise pour l'inscription. Vous pouvez vous inscrire directement depuis le portail d'inscription et recevoir votre cle API par email en quelques secondes.