BANGeocoder

BANGeocoder est un Transformer FME.

1 Présentation

BANGeocoder est un Transformer personnalisé créé par Geonov. Il permet de géocoder dans FME des adresses à partir de l’API de la Base Adresse Nationale (BAN).

IMPORTANT : Contrairement à d’autres Transformers de ce style, BANGeocoder permet de faire du géocodage en masse c’est à dire d’envoyer de nombreuses adresses dans une même requête. Cela soulage le serveur et améliore grandement les temps de traitement.

2 Téléchargement

BANGeocoder est téléchargeable gratuitement depuis le FME Hub de Safe Software : https://hub.safe.com/transformers/bangeocoder

3 Mode d'emploi

En entrée vous devez disposer d’un attribut contenant le numéro et le nom de la rue et d’un attribut contenant le code postal (optionnel) des adresses à géocoder.

Si vous avez peu d’adresses à géocoder, le mode "Unitaire" suffira. Dans le cas contraire, utilisez le mode "En masse".

3.1 Mode unitaire

Dans ce mode, chaque adresse est géocodée séparément (une requête est effectuée pour chaque adresse).

3.1.1 Paramètres

• Spécifiez l’attribut contenant l’adresse à géocoder (numéro et nom de la rue) dans le paramètre Attribut adresse
• Spécifiez (optionnel) l’attribut contenant le code postal de l’adresse à géocoder dans le paramètre Attribut code postal
• Choisissez “Unitaire” dans le paramètre Méthode d’appel de l’API
• Indiquez le nombre maximal de résultats souhaités pour chaque adresse dans le paramètre Nombre de résultats maximum

3.1.2 Résultats

Dans le mode "Unitaire", les adresses géocodées sortent par le port "UNITAIRE".

Les attributs suivants sont générés :

• result_x : coordonnée X de l’adresse
• result_y : coordonnée Y de l’adresse
• result_id : identifiant dans la base adresses
• result_type : type de résultat trouvé (à la plaque, à la voie, lieu-dit, à la commune)
• result_score : pertinence du résultat de 0 à 1 (1 = parfaite)
• result_housenumber : numéro dans la rue
• result_street : nom de la rue
• result_name : numéro et nom de la rue ou lieu-dit
• result_postcode : code postal
• result_citycode : code INSEE de la commune
• result_city : nom de la commune
• result_label : adresse complète
• result_context : numéro du département, nom du département et nom de la région
• result_importance : ?

De plus si le paramètre "Nombre de résultats maximum" était supérieur à 1 et que plusieurs résultats ont été trouvés, une liste "adresse{}" est générée. Elle contient les différents résultats de 0 à n.

ListExploder peut être utilisé pour extraire ces résultats.

NOTE : Dans ce mode, les coordonnées générées sont en Lambert 93 pour la Métropole (EPSG:2154).

3.2 Mode en masse

Dans ce mode, les adresses sont géocodées par lot (une seule requête est effectuée pour chaque lot).

3.2.1 Paramètres

• Spécifiez l’attribut contenant l’adresse à géocoder (numéro et nom de la rue) dans le paramètre Attribut adresse
• Spécifiez (optionnel) l’attribut contenant le code postal de l’adresse à géocoder dans le paramètre Attribut code postal
• Choisissez “En masse” dans le paramètre Méthode d’appel de l’API
• Indiquez le nombre maximal d’adresses par lot dans le paramètre Taux d’échantillonnage

ATTENTION : L’API de la BAN ne supporte pas le traitement de lots de plus de 8 Mo chacun, aussi n’indiquez pas un taux d’échantillonnage trop élevé.

3.2.2 Résultats

Dans le mode "En masse", les adresses géocodées sortent par le port "MASSE".

Les attributs suivants sont générés :

• result_x : coordonnée X de l’adresse
• result_y : coordonnée Y de l’adresse
• result_id : identifiant dans la base adresses
• result_type : type de résultat trouvé (à la plaque, à la voie, lieu-dit, à la commune)
• result_score : pertinence du résultat de 0 à 1 (1 = parfaite)
• result_housenumber : numéro dans la rue
• result_street : nom de la rue
• result_name : numéro et nom de la rue ou lieu-dit
• result_postcode : code postal
• result_citycode : code INSEE de la commune
• result_city : nom de la commune
• result_label : adresse complète
• result_context : numéro du département, nom du département et nom de la région

NOTE : Dans ce mode, les coordonnées générées sont en LL-WGS84 (latitude / longitude, EPSG:4326).

4 Exemple d’utilisation

Retrouvez un test en utilisation réelle de BANGeocoder dans notre article du 22 mars 2018 et découvrez ce que le mode "en masse" vous apportera.