IGNFGeocoderAddress

L'IGNFGeocoderAddress est un Transformer encapsulant le service de géocodage de l'IGN.

Il remplace la géométrie de l'entité par un point correspondant à l'emplacement d'une adresse donnée en paramètre.

Documentation du service de géocodage de l'IGN

Note

Le service de géocodage permet de fournir les coordonnées géographiques d’une adresse postale. Ce service de géocodage est basé sur la BAN (Base Adresse Nationale).


Configuration

Port en entrée

Input

Toutes entités sont acceptées en entrée.

Port de sortie

Output

Les entités ressortent avec pour géométrie le point calculé par les services de l'IGN, en WGS 84.

Un attribut "score" est également ajouté. Le calcul du score, dont la valeur est comprise entre 0 et 1, s’effectue de la manière suivante : le score est calcul à partir de plusieurs composantes. Chacune d’entre elles est définie par un poids et son score peut-être compris entre 0 et ce poids. Le score final est calculé de la manière suivante : score final = somme des scores des composantes / somme des poids des composantes.

Le score du géocodage est calculé à partir de trois composantes :

  • la distance entre chaînes de charactères (poids : 1) : calculée par comparaison entre la chaîne de la requête et les labels des objets ;

  • la distance géographique (poids: 1) : calculée en fonction de la distance entre le localisant de l’objet et un point de référence spécifié dans la requête. Si le point de référence n’est pas spécifié dans la requête (paramètre lonlat), cette composante n’est pas prise en compte.

  • l’importance de l’objet (poids 0,1) : chaque objet possède un champ importance dont la valeur est comprise entre 0 et 1.

<Rejected>

Les entités invalides ou en erreurs ressortent par ce port avec un attribut supplémentaire, "_error", indiquant la raison du rejet.

Une erreur lors de la consultation du service de calcul altimétrique de l'IGNF causera le rejet de l'entité.

Paramètres

  • Adresse à chercher

chaîne décrivant la localisation à rechercher

Exemples de chaîne :

  • 73 Avenue de Paris Saint-Mandé

  • 9, Place Jules Grandclément VILLEURBANNE

  • 21 rue Victor Hugo Rennes