Coordable (Articles sur how-to)

Comment géocoder des adresses avec l'API BAN (Base Adresse Nationale)

François Andrieux — Wed, 15 Jan 2025 10:00:00 GMT

Comment géocoder des adresses avec l'API BAN (Base Adresse Nationale)

Si vous travaillez avec des adresses françaises, la Base Adresse Nationale (BAN) est votre meilleur allié. C'est la base de données officielle des adresses françaises, maintenue par les collectivités locales et l'IGN (Institut Géographique National), et elle est entièrement gratuite. Que vous ayez besoin de géocoder une seule adresse ou d'en traiter des milliers, la BAN fournit des résultats fiables et précis sans les restrictions de licence ni les coûts des fournisseurs commerciaux.

Contrairement aux services de géocodage commerciaux qui facturent à la requête et limitent l'utilisation des données, la BAN offre un géocodage gratuit et illimité avec une licence ouverte permissive. C'est idéal pour les organisations françaises, les administrations publiques et tous ceux qui développent des applications centrées sur la France.

Mise à jour importante : Depuis 2025, l'API BAN a été migrée vers le service Géoplateforme géré par l'IGN. L'ancien point d'accès api-adresse.data.gouv.fr est obsolète et sera désactivé en janvier 2026. Ce tutoriel couvre les nouveaux points d'accès du service Géoplateforme. (Source)

Note : La BAN ne gère que les adresses - elle ne géocode pas les noms d'entreprises, les monuments ou les POI (Points d'Intérêt). Pour cela, vous aurez besoin d'un fournisseur commercial comme Google Maps ou HERE. Mais pour le géocodage pur d'adresses en France, la BAN est inégalée.

Sommaire :

Introduction : Pourquoi utiliser la BAN ?

Avant de plonger dans le guide pratique, comprenons ce qui rend la BAN spéciale et quand il est pertinent de l'utiliser.

Qu'est-ce que la BAN ?

La Base Adresse Nationale (BAN) est la base de données officielle des adresses françaises. Elle contient plus de 25 millions d'adresses compilées à partir des données des collectivités locales de toutes les communes françaises, y compris les territoires d'outre-mer. Ce qui rend la BAN unique :

Officielle - maintenue par les autorités françaises officielles (IGN et collectivités locales)
Exhaustive - couvre toutes les communes de France, y compris les zones rurales et les petites localités
Précise - fournit des coordonnées exactes au niveau du bâtiment plutôt que des estimations interpolées
Gratuite - entièrement gratuite sans quotas ni frais
Ouverte - licence totalement ouverte permettant le stockage, la réutilisation et la redistribution

Voici un exemple d'adresse BAN, affichée dans l'outil de visualisation officiel :

Exemple pour "118 rue st charles", Paris (capture d'écran de l'interface BAN).

Quand utiliser la BAN

La BAN est parfaite quand vous : - Devez géocoder des adresses françaises (France métropolitaine et territoires d'outre-mer) - Voulez des données officielles maintenues par l'État - Devez éviter les restrictions de licence commerciales - Développez des applications nécessitant la validation d'adresses - Voulez géocoder de grands volumes sans vous soucier des coûts - Devez stocker et réutiliser les coordonnées de façon permanente

Pourquoi la BAN fonctionne si bien : Comme la BAN est mise à jour par les collectivités locales qui connaissent intimement leurs adresses, elle fournit des coordonnées exactes plutôt que des estimations. C'est particulièrement précieux pour les adresses rurales et les petites localités que les fournisseurs commerciaux pourraient mal gérer.

Quand la BAN n'est pas le bon choix

La BAN ne fonctionnera pas si vous devez : - Géocoder des adresses en dehors de la France - Trouver des entreprises, monuments ou POI par leur nom - Gérer des requêtes en langage naturel ou des fautes de frappe (la BAN nécessite des adresses bien formatées) - Obtenir des informations commerciales en temps réel (horaires, avis, etc.)

Pour ces cas d'usage, vous devriez considérer des fournisseurs commerciaux comme Google Maps, HERE ou Mapbox.

Géocodage d'une adresse unique

Commençons par le cas d'usage le plus simple : géocoder une seule adresse. C'est parfait quand vous devez convertir une adresse en coordonnées, par exemple pour une validation de formulaire ou une recherche ponctuelle.

Le nouveau point d'accès et ses paramètres (2026)

Le service de géocodage BAN est désormais fourni via le service Géoplateforme géré par l'IGN. Le point d'accès pour le géocodage direct est :

https://data.geopf.fr/geocodage/search

Important : L'ancien point d'accès api-adresse.data.gouv.fr est obsolète et sera désactivé en janvier 2026. Vous devriez migrer vers le nouveau point d'accès Géoplateforme. (Source)

Ce point d'accès /search accepte les paramètres suivants :

q (obligatoire) : L'adresse à géocoder
limit (optionnel) : Nombre de résultats à retourner (10 par défaut)
autocomplete (optionnel) : Active le mode autocomplétion (true par défaut)

D'autres paramètres sont disponibles pour préciser le contexte de géocodage (ville, code postal, etc.), mais je ne les couvrirai pas ici. Pour la liste complète des paramètres, consultez la documentation OpenAPI.

Exemple de requête

Voici un exemple avec l'adresse "118 Rue St Charles, Paris" :

GET https://data.geopf.fr/geocodage/search?q=118+Rue+St+Charles,+Paris&limit=1

Et la réponse :

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [2.283496, 48.844484]
      },
      "properties": {
        "label": "118 Rue Saint-Charles 75015 Paris",
        "score": 0.7424048484848483,
        "housenumber": "118",
        "id": "75115_8513_00118",
        "name": "118 Rue Saint-Charles",
        "postcode": "75015",
        "citycode": "75115",
        "x": 647415.92,
        "y": 6860731.63,
        "city": "Paris",
        "district": "Paris 15e Arrondissement",
        "context": "75, Paris, Île-de-France",
        "type": "housenumber",
        "importance": 0.83312,
        "street": "Rue Saint-Charles",
        "_type": "address"
      }
    }
  ],
  "query": "118 rue st charles, Paris"
}

Dans cet exemple, nous avons ajouté une limite de 1 pour n'obtenir qu'un seul résultat. L'API retourne sa meilleure estimation pour l'adresse, classée par score de correspondance.

Que se passe-t-il ? L'API recherche dans sa base de données les adresses correspondant à votre requête et retourne une liste de correspondances possibles. La réponse inclut les coordonnées exactes, l'adresse formatée et des métadonnées supplémentaires comme le code postal et la ville.

La réponse

L'API retourne une FeatureCollection GeoJSON. Chaque feature contient :

ID - l'identifiant unique de l'adresse dans la base BAN (properties.id)
Coordonnées - latitude et longitude dans le champ geometry.coordinates (format : [longitude, latitude]). Elles sont aussi disponibles en tant que x et y dans l'objet properties.
Adresse formatée - le libellé standardisé de l'adresse dans properties.label
Composants de l'adresse - housenumber, street, city, postcode, citycode, etc. Le numéro de rue et le nom de rue seront absents s'ils n'ont pas été trouvés.
Importance - importance estimée de l'adresse dans la base de données (échelle 0-1)
Score - score de pertinence indiquant la qualité de la correspondance entre votre requête et le résultat (échelle 0-1)

Note : Les résultats sont retournés par ordre de score (le plus élevé en premier), donc le premier résultat est généralement la meilleure correspondance. Cependant, vérifiez toujours les composants de l'adresse (surtout la ville et le code postal) pour vous assurer que le résultat est correct, comme nous l'expliquerons dans la section suivante.

Le score de correspondance

L'API retourne un score de confiance entre 0 et 1. Cependant, un score élevé ne signifie pas que l'adresse est correcte, et il ne signifie certainement pas que l'adresse existe.

Prenons notre exemple "118 Rue St Charles, Paris". Le premier résultat a un score de 0,74, ce qui semble raisonnable. Mais regardez le second résultat à 0,62 - il pointe vers "Rue Charles Paris 33130 Bègles". C'est à 500 km dans la banlieue de Bordeaux !

Encore plus subtil : cherchez "17 Rue St Charles, Paris" et vous obtiendrez un score respectable de 0,74... sauf que cette adresse n'existe pas. L'API a trouvé quelque chose qui ressemble, mais elle fait correspondre des chaînes de caractères, pas vérifier la réalité.

La conclusion ? Vérifiez toujours les résultats du géocodage. Le score vous indique à quel point votre requête correspond à quelque chose dans la base de données, pas si ce quelque chose est ce que vous vouliez vraiment.

Géocodage par lots : traiter plusieurs adresses

Quand vous avez de nombreuses adresses à géocoder - que ce soit un tableur avec des adresses clients ou un export de base de données - vous voudrez utiliser le géocodage par lots. La BAN offre deux approches : une interface web pour les tâches ponctuelles et une API pour l'automatisation.

Méthode 1 : Utiliser l'interface web BAN

Le moyen le plus simple de géocoder un fichier CSV est via l'interface web de la BAN. C'est parfait si vous n'êtes pas développeur ou si vous faites un traitement par lots ponctuel.

Voici comment procéder :

Préparez votre fichier CSV - Incluez des colonnes avec les données d'adresse (numéro de rue, nom de rue, code postal, ville). Exportez depuis Excel si nécessaire.
Téléversez sur l'outil CSV BAN - Sélectionnez quelles colonnes contiennent vos composants d'adresse (ex. Numéro, Rue, Ville).
Téléchargez les résultats - Récupérez vos données originales plus les coordonnées, adresses formatées et la colonne result_status.

L'outil CSV BAN vous permet de téléverser un fichier CSV et de sélectionner les colonnes contenant les données d'adresse.

Et voilà : une fois que vous avez spécifié les colonnes, le traitement se lance automatiquement.

Méthode 2 : Utiliser l'API BAN

Pour l'automatisation, l'intégration dans des applications ou le traitement régulier par lots, vous voudrez utiliser directement l'API BAN. Cela vous donne un contrôle total sur le processus et vous permet de construire des workflows personnalisés.

Comprendre le géocodage par lots avec l'API

Le service Géoplateforme fournit un point d'accès dédié au géocodage par lots qui accepte les fichiers CSV. C'est l'approche recommandée pour traiter plusieurs adresses de façon programmatique.

Le point d'accès batch est disponible à https://data.geopf.fr/geocodage/batch/.

La requête doit être une requête POST avec le fichier CSV dans le corps de la requête. Elle accepte plusieurs paramètres importants : - columns : les colonnes à concaténer pour l'adresse. Peut être laissé vide pour utiliser toutes les colonnes. - indexes : la colonne à utiliser comme index. C'est utile pour pouvoir identifier l'adresse dans le fichier CSV original.

Note : Vous pouvez toujours faire plusieurs requêtes au point d'accès /search, une pour chaque adresse, mais ce sera moins efficace que d'utiliser le point d'accès batch.

Exemple de requête

Voici un exemple de fichier CSV avec les adresses à géocoder :

id,rue,street,city,postal_code
1,12.0,Avenue des Champs-Élysées,Paris,75008
2,45.0,Rue de la République,Lyon,69002
3,78.0,Boulevard de la Croisette,Cannes,6400
4,,,???????,
5,156.0,Rue Saint-Honoré,Paris,75001

Dans ce cas, les colonnes à concaténer pour l'adresse sont : rue, street, city, postal_code, donc nous pouvons spécifier columns=rue,street,city,postal_code.

La requête devrait être :

POST https://data.geopf.fr/geocodage/search/csv
data=addresses.csv
columns=rue,street,city,postal_code

La réponse sera aussi un fichier CSV, retournant à la fois les données originales et les données géocodées avec de nouvelles colonnes toutes préfixées par result_ (result_score, result_score_next, result_label, result_type, result_id, result_housenumber, result_name, result_street, result_postcode, result_city, result_context, result_citycode, result_oldcitycode, result_oldcity, result_district, result_status).

id;rue;street;city;postal_code;longitude;latitude;result_score;result_score_next;result_label;result_type;result_id;result_housenumber;result_name;result_street;result_postcode;result_city;result_context;result_citycode;result_oldcitycode;result_oldcity;result_district;result_status
1;12;Avenue des Champs-Élysées;Paris;75008;2.302859;48.871285;0.8596027272727272;0.6467871900826445;Avenue des Champs Elysées 75008 Paris;street;75108_1733;;Avenue des Champs Elysées;Avenue des Champs Elysées;75008;Paris;75, Paris, Île-de-France;75108;;;Paris 8e Arrondissement;ok
2;45;Rue de la République;Lyon;69002;4.835859;45.761928;0.9157595187165776;0.6972321052631578;45 Rue de la République 69002 Lyon;housenumber;69382_6005_00045;45;45 Rue de la République;Rue de la République;69002;Lyon;69, Rhône, Auvergne-Rhône-Alpes;69382;;;Lyon 2e Arrondissement;ok
3;78;Boulevard de la Croisette;Cannes;06400;7.032336;43.54684;0.9329795565410199;;78 Boulevard de la Croisette 06400 Cannes;housenumber;06029_0880_00078;78;78 Boulevard de la Croisette;Boulevard de la Croisette;06400;Cannes;06, Alpes-Maritimes, Provence-Alpes-Côte d'Azur;06029;;;;ok
4;;;???????;;;;;;;;;;;;;;;;;;;skipped
5;156;Rue Saint-Honoré;Paris;75001;2.339989;48.862052;0.9164409090909089;0.6147660173160173;156 Rue Saint-Honoré 75001 Paris;housenumber;75101_8635_00156;156;156 Rue Saint-Honoré;Rue Saint-Honoré;75001;Paris;75, Paris, Île-de-France;75101;;;Paris 1er Arrondissement;ok

La colonne result_status contient "ok" si l'adresse a été géocodée avec succès, "skipped" si l'adresse n'a pas pu être géocodée.

Intéressant ! En mode CSV par lots, l'API ne retourne qu'un seul résultat par ligne. Cependant, vous pouvez toujours connaître le score de la deuxième meilleure correspondance dans la colonne result_score_next.

Utilisation et coût

La BAN est entièrement gratuite, sans coûts cachés ni quotas. C'est un excellent choix pour les organisations de toute taille.

Structure des coûts

Utilisation de l'API : GRATUIT - Aucun frais pour les requêtes API
Pas de quotas - Traitez autant d'adresses que nécessaire
Pas de frais d'abonnement - Aucun coût mensuel ou annuel
Téléchargement de la base : GRATUIT - Vous pouvez télécharger l'intégralité de la base BAN gratuitement

Pourquoi la BAN est gratuite : La BAN est un service public maintenu par les agences gouvernementales françaises. Elle est financée par les contribuables et fournie en données ouvertes au bénéfice de la société et de l'économie françaises.

Si vous traitez des millions d'adresses ou avez besoin d'un accès hors ligne, vous pouvez télécharger la base de données BAN complète et exécuter votre propre géocodage localement.

Pour une comparaison détaillée avec les fournisseurs commerciaux (Google Maps, HERE, Mapbox...), consultez mon guide Meilleurs fournisseurs de géocodage pour la France.

Limites de requêtes

La BAN autorise 50 requêtes par seconde par IP. Si vous dépassez cette limite, vous obtiendrez des erreurs HTTP 429. Limitez-vous à ~40/seconde et tout ira bien.

Conclusion

La BAN est gratuite, précise et ouverte. Pour les adresses françaises, c'est difficile à battre. N'oubliez pas : migrez vers le nouveau point d'accès Géoplateforme (data.geopf.fr) avant janvier 2026 si vous utilisez encore l'ancien.

Référence complète de l'API : Documentation OpenAPI Géoplateforme.

Pour avoir une vue d'ensemble complète des fournisseurs de géocodage pour la France et une comparaison entre eux, consultez notre guide : Meilleurs fournisseurs de géocodage pour la France.

Dernière mise à jour : 2025-01-15 | Mis à jour par : François Andrieux | Sources : Documentation API BAN, Outil de géocodage CSV, Annonce de migration de l'API, Capacités Géoplateforme, Documentation OpenAPI Géoplateforme

Avertissement : Ce guide est fourni à titre informatif. Consultez toujours la documentation officielle de la BAN et de Géoplateforme pour les points d'accès et conditions actuels.

How to geocode addresses: Transform text addresses into GPS coordinates

François Andrieux — Wed, 15 Jan 2025 10:00:00 GMT

How to geocode addresses: a practical guide

You've probably found yourself needing to convert addresses into coordinates. Maybe you have a list of customer addresses and want to see them on a map. Or perhaps you're building an app that needs to locate places automatically.

Whatever your situation, you've come to the right place! This guide will walk you through exactly how to convert addresses into coordinates using different methods, from simple web tools to powerful APIs. We'll explain why each method exists and when to use it, so you can choose the best approach for your needs.

Note: If you're curious about how geocoding works behind the scenes (the technical process), check out our guide: How geocoding works: A simple guide. This article focuses on the practical "how-to" - showing you the tools and steps to actually geocode addresses.

Table of contents:

Two main approaches: web interfaces vs APIs

Before we dive into the step-by-step instructions, let's understand why there are different ways to geocode addresses. The truth is, different situations call for different tools.

Web interfaces are perfect for one-time tasks, small batches, or when you want immediate visual results.

APIs and developer tools make sense when you need automation, integration into applications, or to process many addresses regularly.

The good news? You don't need to be a software developer to use APIs. We'll show you both approaches, starting with the simplest one.

Geocoding one address with Google Maps

Let's take an example with a well known interface: Google Maps.

Google Maps is easy to use, and it's free. If you have only one address to convert to coordinates, this is probably the simplest and fastest way to do it.

And it's actually possible to use it geocode addresses and save their latitude/longitude. Here is how to do it:

Open Google Maps in your web browser
Type your address in the search box (e.g., 530 Hancock St, Brooklyn, USA)
Right-click on the red marker that appears on the map
Click on the coordinates that appear in the popup menu
The coordinates are copied to your clipboard, as latitude and longitude (e.g: 40.68421, -73.934043)

How to geocode a single address with Google Maps

That's it! You now have the latitude and longitude for that address.

Google Maps is great for one-off lookups, but it's not designed for batch processing. If you have many addresses, you'll need to repeat this process for each one, which quickly becomes tedious.

It's possible to use Google My Maps to display data, but it requires latitude and longitude coordinates, not the addresses... And do not allow exporting data.

Geocoding multiple addresses with Coordable (Excel/CSV)

If you have multiple addresses in an Excel file and want to see them all on a map, Coordable offers a powerful web interface, with batch processing and visualization. Here is how to do it:

Go to Coordable and create an account (free tier available)
Upload your addresses - you can upload a CSV file or Excel file with a column (or many columns) containing the addresses you want to geocode.
Select your geocoding provider from the dropdown (Google Maps, HERE, Mapbox, etc.). Choose the most appropriate provider for your needs.
Start the geocoding job - Coordable processes all your addresses
View results - you can see the results on a map and in a table
Export your results - you can download the results with latitude and longitude, and other geocoding metadata

The upload interface of Coordable accepts Excel or CSV files.

Coordable transparently handles the geocoding process for you. It gives a clear view on the results and classify addresses for further analysis:

Coordable shows geocoding success rates and types of addresses.

Results are shown on a map and in a table. You can filter on columns to analyse the results, and you can also export.

Table and map views of the results.

There is no limit in the number of addresses you can geocode. Coordable geocoding by batches automatically and notify you when it's done. It's the easiest and fastest way to geocode a large number of addresses.

Try the coordable app

Geocoding multiple addresses with APIs

APIs (Application Programming Interfaces) let you geocode addresses programmatically. This means you can automate the process, integrate it into your applications, or process thousands of addresses at once. Here is how to do it:

Get an API key - you can get an API key from the geocoding provider you want to use.
Make an API HTTP request - you can make an API HTTP request to the geocoding provider you want to use.
Handle the response - save components, coordinates, handle errors, etc.

Using an API usually require some technical knowledge, and you need to handle the response from the API. Geocoding APIs are not uniformized, which can make it somehow hard to change from an API to an other.

Most of the time, APIs return raw coordinates (latitude, longitude), formatted addresses, and confidence scores. Sometimes they also include address components and place types. However, APIs don't provide visual maps of results, table views for batch processing, built-in quality verification, easy export to common formats, or visual feedback on accuracy.

This is why many people use APIs for automation but then need additional tools to visualize and verify results. Coordable fills this gap by providing API-like automation with built-in visualization and quality checks.

Meta-geocoding strategies

It's also possible to combine multiple APIs in a cascade way. Here are at least two benefical ways:

To get higher geocoding rates: You could geocode 90% of the addresses using a local, open-source geocoding provider (e.g. a state geocoding service), then rely on the commercial provider for the remaining 10% that the initial provider cannot geocode.
To pick the best result: Some providers work well for POIs (restaurants, enterprises, etc.) and others for residential addresses. Combining 2 or more geocoding providers can help you get the best result possible. However, such strategy require a good understanding of each provider strengths and weaknesses.

Good to know: Coordable has out-of-the-box capabilities to implement meta-geocoding strategies. The Coordable API allow you to pick one or multiple providers, and even to add a custom endpoint for geocoding.

What to do after geocoding

Geocoding your addresses is just the first step. Here's what you should do next to ensure quality results:

1. Verify your results

Don't trust results blindly! Even the best geocoding services can make mistakes. Always verify:

Check a few results manually - look them up on a map to confirm they're correct
Review confidence scores - if the API provides them, pay attention to low-confidence results
Look for outliers - addresses that seem to be in the wrong country or region
Check for false positives - results that look confident but are actually wrong

Good to know: Coordable includes a built-in verification engine that automatically flags potentially incorrect results, making it easier to spot problems.

2. Visualize and the results

Seeing your geocoded addresses on a map helps you

Spot errors - addresses in wrong locations are obvious on a map
Understand patterns - see clusters, distributions, and geographic relationships
Share results - maps are easier to understand than coordinate lists

Tools like Coordable provide built-in map visualization, or you can use external mapping tools (ArcGIS, QGIS, etc.) to create custom visualizations.

QGIS, as an example, is a free and open-source GIS software that does it very well. Here is an example of a map of the results:

QGIS example of a map of the results.

You can also use mapping libraries (Leaflet, Mapbox GL, Google Maps) to create custom visualizations.

Best practices for quality results

Geocoding is complex problem to solve. An address that seem obvious to you might be difficult to geocode for a machine. Here are some best practices to help a geocoding engine:

Clean your addresses: remove typos, standardize formats (learn more about how geocoding works to understand why this matters)
Add context: include country, postal code when possible
Validate addresses: check if they exist before geocoding, when possible

Pro tip: If you're processing many addresses, start with a small sample (10-20 addresses) to test your workflow and verify quality before processing the full dataset.

Conclusion

Geocoding addresses doesn't have to be complicated. Whether you need to transform text addresses into GPS coordinates for a one-time project or set up automated geocoding for thousands of addresses, there's a method that fits your needs.

Remember:

Don't trust results blindly - always verify geocoding results, especially for critical applications
Analyze your results - check completion rates, accuracy, and identify patterns in failures
Pick the best geocoding provider based on your analysis and completion rate - different providers work better for different regions and address types

The key is choosing the right tool for your specific situation. Start simple with a web interface if you're new to geocoding, then move to APIs if you need to scale up or automate.

If you want to learn more about how geocoding works behind the scenes, check out our guide: How geocoding works: A simple guide.

For country-specific recommendations and provider comparisons, see our country analyses: - Best Geocoding Providers for France - Best Geocoding Providers for the United Kingdom - Best Geocoding Providers for Germany

Ready to get started? If you need to geocode addresses with visualization and quality checks, try Coordable - it's designed to make geocoding easy, whether you have one address or thousands.

Happy geocoding! ⭐