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

The documentation in English can be found here.

Description

Cet acteur est un outil rapide et optimisé en termes de coûts qui vous permet d'effectuer un géocodage direct et groupé d'une liste d'adresses situées en France. Le coût commence à partir de 0,02 $ pour 1 000 adresses, ce qui le rend moins cher que les alternatives. 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). Cet outil permet d'interroger deux indexes à savoir: la base d'adresses BAN (actualisée chaque semaine) ainsi que la base des lieux (actualisée tous les trimestres). Cette dernière correspond à la couche "points d’intérêt" (POI) de la base de données TOPO. 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). L'outil permet également de visualiser les addresses géocodées sur une carte géographique et d'exporter la carte au format HTML.

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
• Optionnellement, une carte géographique incluant les addresses géocodées pourrait être construite, visualisée et exportée au format HTML pour une intégration éventuelle sur votre propre plateforme ou site web.

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)
• Sélection de l'index à interroger (Adresses ou Lieux (POI)) (Adresse 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.
• Création éventuelle d'une cartographie des résultats sur une carte géographique. La carte inclut des marqueurs (sans dépasser la limite de 1000 pour conserver la lisibilité) ainsi que des info-bulles pour accéder aux détails (Inactif par défaut).

Sortie

Une liste d'adresses ou de lieux accompagnés 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 ou lieu trouvé (Système de coordonnées GPS WGS84)
• latitude: Latitude de l'adresse ou lieu trouvé (Système de coodonnées GPS WGS84)
• label: Libellé complet de l'adresse ou lieu trouvé
• type: Type d'adresse ou de lieu trouvé. Dans le cas d'une adresse, ça correspond à une des valeurs suivantes: housenumber: numéro de maison, street: rue, locality: quartier, municipality: ville ou commune. Dans le cas de lieu, les valeurs possibiles sont plus nombreuses comme: *hôpital", lieu-dit habité, Etablissement d'enseignement, etc.
• 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 ou lieu trouvé (Pour les lieux, la valeur peut être multiple)
• city: Nom de la Commune de l'adresse trouvée (Pour les lieux, la valeur peut être multiple)
• citycode: Code INSEE de la Commune de l'adresse trouvée (Pour les lieux, la valeur peut être multiple)
• context: Département et région de l'adresse trouvée ou nom du territoire pour les lieux
• score: Score (dégré de correspondance entre l'adresse en entrée et l'adresse candidate trouvée)
• source: Index Source (Address/POI)
• status: Statut du géocodage (ok/not-found/skipped/error) (ok: adresse trouvée, not-found: aucun candidat trouvé, skipped: entrée ignorée car invalide, error: erreur du serveur lors de la recherche)

Carte

Il est possible de construire une carte géographique basée sur OpenStreetMap représentant l'ensemble des addresses géocodées sous forme de marqueurs et d'info-bulles. Le nombre de résultats représentés est limité à 1000 pour conserver la lisibilité de la carte. Le résultat est sous forme de code HTML et Javascript, accessible de deux manières:

• Fichier map.html se trouvant dans le dossier par défaut de storage
• La carte est directement visualisable depuis la zône sortie par défaut Output sous la vue Map View

Note: Cette fonctionnalité est expérimentale. Tout retour est le bienvenu. En particulier, des idées d'options pour personnaliser la carte et la rendre plus exploitable.

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 la base des lieux BD TOPO
• 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 actor is a fast and cost optimized tool that allows you to perform direct, bulk geocoding of a list of addresses located in France. The cost starts from 0.01$ for 1000 addresses, which makes it cheaper than alternatives. 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). This actor allows you to query two indexes: the BAN address database (updated weekly) and the location database (updated quarterly). The latter corresponds to the ‘points of interest’ (POI) layer of the TOPO database. 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). The tool also allows you to view geocoded addresses on a map and export the map in HTML format.

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.
• Optionally, a map including geocoded addresses could be created, viewed, and exported in HTML format for possible integration into your own platform or website.

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)
• Select the index to query (Addresses or Places (POI)) (Default address)
• 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.
• Possible mapping of results. The map includes markers (without exceeding the limit of 1,000 to maintain readability) and tooltips to access each address result details ((Disabled by default)).

Output

A list of addresses or locations 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 or location longitude (WGS84 GPS coordinate system)
• latitude: Address or location Latitude (WGS84 GPS coordinate system)
• label: Full address or location label
• type: Address or location type. In the case of an address, this corresponds to one of the following values: housenumber: house number, street: street, locality: neighbourhood, municipality: town or municipality. In the case of a place, there are more possible values, such as: hôpital, lieu-dit habité, Etablissement d'enseignement, etc.
• housenumber: Street number
• street: Street name
• postcode: Postcode of the municipality ((For locations, the value may be multiple))
• city: Name of the municipality (For locations, the value may be multiple)
• citycode: INSEE code of the municipality (For locations, the value may be multiple)
• context: Department and region of a found address or territory name for locations
• score: Score (degree of correspondence between the input address and the candidate address found)
• source: Source Index (Address/POI)
• status: Geocoding status (ok/not-found/skipped/error) (ok: address found, not-found: no candidate found, skipped: entry ignored because invalid, error: server error during search)

Map

It is possible to build a map based on OpenStreetMap representing all geocoded addresses as markers and tooltips. The number of results displayed is limited to 1,000 to maintain the map's readability. The result is in HTML and JavaScript code, accessible in two ways:

• The map.html file located in the default storage folder
• The map can be viewed directly from the default Output area under the Map View

Note: This feature is experimental. Any feedback is welcome. In particular, ideas for options to customize the map and make it more usable.

References

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

• Presentation of the locations database BD TOPO
• 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.