BAN Geocoder

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).

Transformer BANGeocoder

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 les temps de traitement.

Téléchargement

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

Utilisation

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.

Mode unitaire

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

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

    BANGeocoder géocodage unitaire

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.

Un 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).

Mode en masse

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

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

    BANGeocoder géocodage en masse

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é.

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).

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.

Journal des modifications

Version 1 (21 mars 2018)

  • Première version

Version 2 (22 mars 2018)

  • Rejet des adresses sans coordonnées après géocodage
  • Remplacement de “result_longitude” par “result_x”
  • Remplacement de “result_latitude” par “result_y”

Améliorations

N’hésitez pas à contacter Geonov pour toute demande de correction ou d’amélioration de ce transformer.