GEOREFER vs API BAN : comparaison complete 2026

Temps de lecture : 9 minutes

Introduction : deux API, deux philosophies

En France, deux API dominent le paysage de la gestion d'adresses : l'API BAN (Base Adresse Nationale) du gouvernement, et GEOREFER, le SaaS d'AZMORIS concu pour la FinTech et la RegTech. Les deux repondent au meme besoin initial : valider et geocoder des adresses francaises.

Pourtant, leurs approches divergent radicalement. L'une est gratuite, ouverte et minimaliste. L'autre est payante, riche en fonctionnalites et concu pour les environnements de production exigeants.

Si vous cherchez une alternative a l'API BAN pour vos projets professionnels, cette analyse vous donnera toutes les cles de decision.

Qu'est-ce que l'API BAN ?

Origine et mission

L'API BAN est le service de geocodage officiel du gouvernement francais. Elle s'appuie sur la Base Adresse Nationale, un referentiel collaboratif maintenu par Etalab, l'IGN et La Poste. Le service est accessible via api-adresse.data.gouv.fr.

Lancee dans le cadre de la politique d'ouverture des donnees publiques, l'API BAN incarne la philosophie de l'open data a la francaise. Elle est 100 % gratuite, ne necessite aucune inscription et fonctionne avec un simple appel GET.

Fonctionnalites principales

• Geocodage : convertir une adresse textuelle en coordonnees GPS (latitude/longitude)
• Geocodage inverse : retrouver une adresse a partir de coordonnees
• Autocompletion : suggestion d'adresses pendant la saisie
• Recherche par code postal ou par commune
• Score de confiance : un float entre 0.0 et 1.0 indiquant la pertinence du resultat

Pour un projet personnel, un hackathon ou un prototype rapide, l'API BAN est une excellente porte d'entree. Elle est simple, bien documentee par la communaute et fiable pour des volumes moderes.

Qu'est-ce que GEOREFER ?

Un referentiel geographique pour la production

GEOREFER est un Web Service REST SaaS developpe par AZMORIS Group. Il va bien au-dela du simple geocodage en combinant plusieurs referentiels dans une API unifiee : adresses, codes INSEE, donnees SIRENE, historique des communes COG et scoring de fiabilite.

La cible principale : les equipes techniques qui ont besoin de validation d'adresse fiable en production, avec des garanties de disponibilite, un support professionnel et des fonctionnalites metier avancees.

Fonctionnalites distinctives

• Validation d'adresse avec score de confiance granulaire (0-100)
• Normalisation AFNOR (NF Z 10-011) : 6 lignes, 38 caracteres max
• GeoTrust Score : scoring composite FATF/GAFI pour la conformite KYC
• Donnees SIRENE : 16,8 millions d'etablissements (SIREN, SIRET, code NAF)
• Historique COG : fusions, scissions et redenominations de communes
• Enrichissement : population, coordonnees, donnees economiques, zones
• Autocomplete Elasticsearch avec tolerance aux fautes de frappe (fuzzy search)
• Authentification par cle API avec quotas, rate limiting et feature gating

Pour demarrer rapidement, consultez notre guide de prise en main et la documentation technique complete.

Les vrais atouts de l'API BAN

Soyons honnetes : l'API BAN a de veritables qualites qui expliquent son adoption massive. Voici ce qu'elle fait bien.

Gratuite totale et acces ouvert

Zero euro, zero inscription, zero cle API. Vous faites un appel GET et vous obtenez une reponse. Cette simplicite est imbattable pour les projets a budget nul ou les experimentation rapides.

La licence Etalab (compatible avec les licences ouvertes) permet une reutilisation libre des donnees, y compris pour des projets commerciaux.

Source faisant autorite

La Base Adresse Nationale est le referentiel officiel de l'Etat francais. Pour les cas ou la source des donnees a une importance juridique, l'API BAN est la reference incontestable. Les communes contribuent directement a la mise a jour des adresses.

Simplicite d'integration

Un seul endpoint GET, des parametres clairs (q, postcode, citycode), une reponse GeoJSON standard. En 10 minutes, vous avez un prototype fonctionnel. Aucune autre API d'adresses ne peut rivaliser sur ce point.

Communaute active

Le projet est open source, heberge sur GitHub, avec une communaute de contributeurs et un forum de discussion. Les problemes sont remontes publiquement et les evolutions sont transparentes.

Ou l'API BAN atteint ses limites en production

Les limites de l'API BAN ne sont pas des defauts : elles refletent le perimetre volontairement restreint d'un service public gratuit. Mais pour les cas d'usage professionnels, elles deviennent bloquantes.

Aucun SLA ni garantie de disponibilite

L'API BAN ne propose aucun engagement de disponibilite. Les interruptions de service sont possibles, sans notification prealable ni compensation. Pour une application critique (paiement, onboarding KYC, logistique), ce risque est inacceptable.

Pas de donnees entreprise

L'API BAN ne contient aucune donnee SIRENE. Impossible de croiser une adresse avec un SIREN, un SIRET ou un code NAF. Pour la verification d'entreprise, il faut integrer une deuxieme API, gerer un deuxieme format de reponse et maintenir une deuxieme couche d'erreurs.

Score de confiance simpliste

Le score de l'API BAN est un simple float entre 0 et 1, sans decomposition. Vous savez qu'une adresse est "a peu pres bonne" ou "probablement mauvaise", mais vous ne savez pas pourquoi. Le GeoTrust Score de GEOREFER decompose la fiabilite en 4 sous-scores ponderes.

Pas de normalisation AFNOR

L'API BAN retourne l'adresse telle qu'elle existe dans la base, sans normalisation postale. Pour les envois courrier ou les obligations reglementaires, la norme NF Z 10-011 est pourtant indispensable.

Rate limiting fixe et non configurable

La limite de 50 requetes par seconde est partagee entre tous les utilisateurs. Lors des pics de charge, les performances se degradent sans possibilite d'amelioration. Pas d'option premium pour augmenter ce plafond.

Pas de fuzzy search avance

L'autocompletion de l'API BAN fonctionne, mais ne tolere que faiblement les fautes de frappe. GEOREFER utilise un moteur Elasticsearch avec des analyseurs edge n-gram et une fuzziness AUTO pour des resultats pertinents meme avec des saisies approximatives.

Tableau comparatif detaille : GEOREFER vs API BAN

Voici la comparaison critere par critere, point par point. Ce tableau permet de visualiser les ecarts fonctionnels entre les deux solutions.

Le tableau montre clairement que les deux solutions ciblent des segments differents. L'API BAN excelle dans l'acces libre aux donnees publiques. GEOREFER apporte les couches metier necessaires a un usage professionnel.

Comparaison cote a cote : exemples de code

Rien ne vaut du code concret pour comparer deux API. Voici les appels equivalents pour rechercher une adresse, avec la requete et un extrait de reponse.

Recherche d'adresse avec l'API BAN

curl "https://api-adresse.data.gouv.fr/search/\
?q=15+rue+de+la+paix\
&postcode=75002"

{
  "type": "FeatureCollection",
  "features": [{
    "type": "Feature",
    "geometry": {
      "type": "Point",
      "coordinates": [2.330869, 48.869572]
    },
    "properties": {
      "label": "15 Rue de la Paix 75002 Paris",
      "score": 0.9174,
      "type": "housenumber",
      "city": "Paris",
      "postcode": "75002",
      "citycode": "75102"
    }
  }]
}

Simple et efficace. Un score flottant, des coordonnees, le nom de la ville. Pour un geocodage basique, c'est suffisant.

Validation d'adresse avec GEOREFER

curl -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": "15 rue de la paix",
    "postal_code": "75002",
    "city": "Paris",
    "country_code": "FR"
  }'

{
  "success": true,
  "data": {
    "is_valid": true,
    "confidence_score": 94,
    "matched_city": {
      "name": "PARIS 2E ARRONDISSEMENT",
      "insee_code": "75102",
      "postal_code": "75002",
      "department_code": "75",
      "region": "Ile-de-France"
    },
    "geotrust_score": {
      "global_score": 91,
      "confidence": 94,
      "geo_consistency": 100,
      "postal_match": 100,
      "country_risk": 28,
      "risk_level": "LOW"
    },
    "warnings": [],
    "suggestions": []
  },
  "timestamp": "2026-03-20T14:30:00Z"
}

La difference est immediatement visible. GEOREFER retourne un scoring detaille, la coherence geographique, le niveau de risque FATF/GAFI et la hierarchie administrative complete. Une seule requete fournit ce qui necesiterait 3 appels API distincts avec l'API BAN et des services tiers.

Recherche d'entreprise (GEOREFER uniquement)

curl "https://georefer.io/geographical_repository/v1/companies/search\
?name=azmoris\
&department_code=75" \
  -H "X-Georefer-API-Key: VOTRE_CLE_API"

L'API BAN n'offre tout simplement aucun equivalent pour la recherche d'entreprise. Pour les workflows KYC qui necessitent a la fois la verification d'adresse et la verification d'entreprise, GEOREFER unifie les deux dans une meme plateforme.

Migrer de l'API BAN vers GEOREFER : guide etape par etape

La migration depuis l'API BAN se fait en quelques etapes simples. Voici le parcours complet pour basculer votre integration existante.

Etape 1 : obtenir une cle API

Inscrivez-vous sur georefer.io/signup pour recevoir votre cle API par email. Le plan DEMO (gratuit, 50 requetes/jour) permet de tester sans engagement.

Etape 2 : remplacer l'URL et la methode

L'API BAN utilise un endpoint GET avec des parametres dans l'URL. GEOREFER utilise un endpoint POST avec un body JSON pour la validation d'adresse. Pour la recherche de villes et l'autocomplete, GEOREFER utilise egalement des endpoints GET.

Etape 3 : ajouter le header d'authentification

Ajoutez le header X-Georefer-API-Key a toutes vos requetes. C'est la seule modification obligatoire au niveau HTTP.

Etape 4 : adapter le parsing de la reponse

La reponse GEOREFER est plus riche que celle de l'API BAN. Le champ success indique le statut, les donnees sont dans data et la pagination dans metadata. Adaptez votre code de deserialization en consequence.

Etape 5 : exploiter les nouvelles fonctionnalites

Une fois la migration de base terminee, vous pouvez progressivement exploiter les fonctionnalites exclusives : GeoTrust Score, normalisation AFNOR, donnees SIRENE, historique COG. Chaque fonctionnalite est independante et activable via votre plan tarifaire.

Quand utiliser l'API BAN vs GEOREFER : guide de decision

Le choix entre les deux solutions depend de votre contexte. Voici un guide clair pour prendre la bonne decision.

Choisissez l'API BAN si :

• Votre projet est personnel, academique ou a but non lucratif
• Vous avez besoin uniquement de geocodage basique (adresse vers coordonnees)
• Votre budget est strictement nul
• Vous n'avez aucune contrainte de SLA ou de disponibilite
• Le volume de requetes reste modere (quelques milliers par jour)
• Vous valorisez l'open source et l'open data comme principes

Choisissez GEOREFER si :

• Vous developpez une application FinTech, RegTech ou e-commerce en production
• Vous devez verifier des adresses dans un workflow KYC/AML
• La normalisation AFNOR est requise (courrier, facturation, obligations legales)
• Vous avez besoin de donnees SIRENE croisees avec les adresses
• Un SLA et un support professionnel sont necessaires
• Vous voulez un scoring de fiabilite detaille (pas un simple float)
• L'historique des communes (fusions COG) est important pour vos traitements
• Vous cherchez une alternative a l'API BAN production-ready

Questions frequentes

Quelle est la difference principale entre GEOREFER et l'API BAN ?

L'API BAN est un service public de geocodage gratuit base sur la Base Adresse Nationale. GEOREFER est un SaaS qui enrichit ces donnees avec la normalisation AFNOR, les donnees SIRENE (16,8 millions d'etablissements), le GeoTrust Score de conformite FATF/GAFI, l'historique COG des communes et un SLA garanti pour la production.

L'API BAN est-elle gratuite ? Et GEOREFER ?

Oui, l'API BAN est 100 % gratuite sans inscription. GEOREFER propose un plan DEMO gratuit (50 requetes/jour) et un plan FREE (100 requetes/jour). Les plans payants STARTER (49 EUR/mois) et PRO (199 EUR/mois) offrent des volumes plus importants et des fonctionnalites avancees.

Peut-on utiliser GEOREFER comme alternative a l'API BAN pour le KYC ?

Oui. GEOREFER est concu pour les cas d'usage FinTech et RegTech. Le GeoTrust Score fournit un scoring conforme FATF/GAFI, la normalisation AFNOR garantit le format reglementaire, et les donnees SIRENE permettent la verification d'entreprise dans le meme appel API.

Comment migrer de l'API BAN vers GEOREFER ?

La migration se fait en 4 etapes : s'inscrire pour obtenir une cle API, remplacer l'URL de l'endpoint, ajouter le header X-Georefer-API-Key, et adapter le parsing de la reponse enrichie. Un guide detaille est disponible dans la documentation.