Géocodage en masse d'adresses situées en FRANCE (Français)

The documentation in English can be found here.

Description

Cet outil permet de réaliser un géocodage direct et en masse d'une liste d'adresses situées en France. Le géocodage consiste à affecter des coordonnées géographiques (longitude/latitude) à une adresse postale donnée. L'outil utilise l'API publique de la BAN (Base Adresse Nationale) transférée récemment (courant 2025) à l’IGN (Institut National de l’Information Géographique et Forestière). Le traitement est réalisé de manière conforme aux limitations imposées par l'API, à savoir un maximum de 50 appels/seconde pour une adresse IP donnée, ainsi qu'une taille de fichier CSV inférieure à 50M pour le traitement par lots. Le respect des limitations est géré par l'outil (introduction de délais d'attente et découpage en sous-lots pour les gros lots de données).

Fonctionnalités

• Réaliser le géocodage d'une liste d'adresses postales situées en France (entrée).
• Par défaut, le géocodage est réalisé par lots et de manière synchrone en utilisant l'API de géocodage de l'IGN (fichier CSV en entrée). Ceci permet un traitement performant de données massives, ainsi qu'une réduction du nombre d'appels à l'API.
• Le lot de données en entrée est découpé en sous-lots de manière à respecter les limitations imposées par l'API.
• Le traitement par lots permet de générer une seule adresse candidate par adresse en entrée.
• Le traitement par lots pourrait être désactivé. Dans ce cas, un traitement unitaire sera réalisé. Chaque adresse en entrée va générer un appel à l'API et plusieurs adresses candidates pourront être renvoyées. Ce mode est utile pour géocoder des adresses parcielles, mais le traitement sera beaucoup plus long.
• La limitation en nombre d'appels de l'API par seconde est prise en compte par l'outil. Des délais d'attente sont mis en oeuvre si besoin.
• Les résultats sont fournis au format JSON

Usage

Cet outil est destiné à faciliter le géocodage (direct) d'une masse importante d'adresses postales en France. Plusieurs utilisations sont possibles comme la construction de cartes intéractives (annuaires), processus de commande et livraison, etc.

Entrée

• Une liste d'adresses postales (requis). Cette liste est fournie, soit au format JSON (tableau de chaînes de caractères), soit en fournissant un fichier texte en entrée. Le fichier doit contenir une adresse par ligne.
• Activation ou désactivation du traitement par lots (actif par défaut)
• Le nombre maximum de candidats à renvoyer pour chaque adresse. A noter que ce paramètre n'est pas pris en compte dans le mode de traitement par lots.
• Utilisation éventuelle de proxys.

Sortie

Une liste d'adresses accompagnées de coordonnées GPS ainsi que d'autres métadonnées. A noter que dans le cas de traitement unitaire, une même adresse en entrée peut générer plusieurs résultats si plusieurs candidats ont été trouvés. Les champs retournés pour chaque résultat sont les suivants:

• input_id: Identifiant de l'adresse en entrée (permet de regrouper les résultats correspondants à une même adresse en entrée)
• input_adr: Adresse entrée
• longitude: Longitude de l'adresse trouvée (Système de coordonnées GPS WGS84)
• latitude: Latitude de l'adresse trouvée (Système de coodonnées GPS WGS84)
• label: Libellé complet de l'adresse trouvée
• type: Type d'adresse trouvée (housenumber/street/locality/municipality) (housenumber: numéro de maison, street: rue, locality: quartier, municipality: ville, commune)
• housenumber: Numéro de Rue de l'adresse trouvée
• street: Nom de la Rue de l'adresse trouvée
• postcode: Code postal de la Commune de l'adresse trouvée
• city: Nom de la Commune de l'adresse trouvée
• citycode: Code INSEE de la Commune de l'adresse trouvée
• context: Département et région de l'adresse trouvée
• score: Score (dégré de correspondance entre l'adresse en entrée et l'adresse candidate trouvée)
• status: Statut du géocodage (ok/not-found/skipped/error) (ok: adresse trouvée, not-found: aucune adresse candidate trouvée, skipped: entrée ignorée car invalide, error: erreur du serveur lors de la recherche)

Références

Pour en savoir plus sur l'API de géocodage de l'IGN, vous pouvez consulter les ressources suivantes:

• Présentation de l'API Géoplateforme - Géocodage
• Documentation technique de l'API Géoplateforme - Géocodage (swagger)

Vos commentaires

Si vous avez des commentaires techniques, un bug à signaler ou des suggestions d'évolution ou amélioration de l'acteur, veuillez créer un ticket dans l'onglet « Problèmes liés à l'acteur ».

Bulk geocoding of addresses located in France (English)

La documentation en Français se trouve ici.

Description

This tool allows you to perform direct, bulk geocoding of a list of addresses located in France. Geocoding consists of assigning geographical coordinates (longitude/latitude) to a given postal address. The tool uses the public API of the BAN (Base Adresse Nationale), which was recently transferred (in 2025) to the IGN (Institut National de l’Information Géographique et Forestière). Processing is carried out in accordance with the limitations imposed by the API, namely a maximum of 50 calls/second for a given IP address, and a CSV file size of less than 50M for batch processing. Compliance with the limitations is managed by the tool (waiting times and split into sub-batches for large data batches).

Features

• Geocode a list of postal addresses located in France (input).
• By default, geocoding is performed in batches and synchronously using the IGN geocoding API (CSV file input). This allows for efficient processing of large amounts of data, as well as a reduction in the number of API calls.
• The input data batch is divided into sub-batches in order to comply with the limitations imposed by the API.
• Batch processing allows a single candidate address to be generated for each input address.
• Batch processing can be disabled. In this case, individual processing will be performed. Each input address will generate a call to the API and several candidate addresses may be returned. This mode is useful for geocoding partial addresses, but processing will take much longer.
• The tool takes into account the limit on the number of API calls per second. Waiting times are implemented if necessary.
• Results are provided in JSON format.

Usage

This tool is designed to facilitate the (direct) geocoding of a large number of postal addresses in France. It has several possible uses, such as the creation of interactive maps (directories), ordering and delivery processes, etc.

Input

• A list of postal addresses (required). This list is provided either in JSON format (array of strings) or by supplying a plain text file as input. The file must contain one address per line.
• Enable or disable batch processing (enabled by default)
• The maximum number of candidates to return for each address. Please note that this setting is not taken into account in batch processing mode.
• Possible use of proxies.

Output

A list of addresses accompanied by GPS coordinates and other metadata. Please note that in the case of single processing (bulk mode disabled), the same input address may generate several results if several candidates have been found. The fields returned for each result are as follows:

• input_id: Input address identifier (used to group results corresponding to the same input address)
• input_adr: Input address
• longitude: Address longitude (WGS84 GPS coordinate system)
• latitude: Address Latitude (WGS84 GPS coordinate system)
• label: Full address label
• type: Address type (housenumber/street/locality/municipality) (housenumber: house number, street: street, locality: neighbourhood, municipality: town, municipality)
• housenumber: Street number
• street: Street name
• postcode: Postcode of the municipality
• city: Name of the municipality
• citycode: INSEE code of the municipality
• context: Department and region
• score: Score (degree of correspondence between the input address and the candidate address found)
• status: Geocoding status (ok/not-found/skipped/error) (ok: address found, not-found: no candidate address found, skipped: entry ignored because invalid, error: server error during search)

References

To find out more about the IGN geocoding API, please consult the following resources:

• Presentation of the Geoplatform API - Geocoding
• Technical documentation for the Géoplateforme API - Geocoding (swagger)

Your feedback

If you have any technical comments, bugs to report, or suggestions for improving the actor, please create a ticket in the ‘Actor-related issues’ tab.