IGNFServiceGeocoderPOI

L'IGNFServiceGeocoderPOI 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'un lieu ou unité administrative donnée en paramètre.

Documentation du service de géocodage de l'IGN

Note

Le service de géocodage au POI permet de fournir les coordonnées géographiques d’un lieu ou d’une unité administrative à rechercher. Ce service de géocodage est basé sur la BDTOPO.


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 retourné 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 géocodage de l'IGNF causera le rejet de l'entité.

Paramètres

Point d'intérêt à chercher :

chaîne décrivant un lieu ou une unité administrative à rechercher

Exemples de chaîne :

  • Lyon

  • Bretagne

  • Cimetiere Vincene

  • Mairie Perpignan

Catégorie (Optionnel) :

Permet de filtrer par catégorie de poi. Les valeurs possibles sont listées dans le getCapabilities du service de géocodage. Une liste de valeur est disponible plus bas.

Code INSEE (Optionnel) :

Permet de filtrer les résultats par code INSEE.

Code Postal (Optionnel):

Permet de filtrer les résultats par code postal.

Longitude (Optionnel)/Latitude (Optionnel):

Permet de filtrer la requête en fonction d'une position géographique pour favoriser les candidats les plus proches.

Valeurs possibles pour pour le paramètre "Catégorie" (au 29/06/2023)

{ "cimetière": [], "réservoir": [ "réservoir industriel", "château d'eau", "réservoir d'eau ou château d'eau au sol" ], "administratif": [ "région", "département", "epci", "commune", "arrondissement municipal" ], "construction": [ "construction linéaire", "pont", "barrage", "tremplin de ski", "passerelle", "aqueduc", "pont mobile", "pont isolé", "piste de bobsleigh", "pont tournant", "piste de luge", "viaduc", "sport de montagne", "construction ponctuelle", "phare", "clocher", "calvaire", "croix", "autre construction élevée", "construction surfacique", "dalle", "cale", "ecluse" ], "hydrographie": [ "cours d'eau", "détail hydrographique", "perte", "espace maritime", "point d'eau", "résurgence", "banc", "embouchure", "balise", "baie", "feu", "marais", "source", "lavoir", "source captée", "fontaine", "plan d'eau", "plan d'eau de gravière", "réservoir-bassin", "glacier, névé", "lac", "lagune", "retenue", "inconnue", "retenue-barrage", "ecoulement naturel", "mare", "retenue-digue" ], "élément topographique ou forestier": [ "détail orographique", "vallée", "plaine", "escarpement", "dépression", "grotte", "montagne", "volcan", "récif", "dune", "isthme", "crête", "plage", "col", "terril", "rochers", "cirque", "gouffre", "gorge", "pic", "ile", "cap", "sommet", "lieu-dit non habité", "arbre", "bois", "pare-feu" ], "transport": [ "équipement de transport", "gare routière", "station de métro", "service dédié aux vélos", "arrêt voyageurs", "parking", "aire de triage", "aérogare", "gare maritime", "gare voyageurs et fret", "aire de repos ou de service", "gare voyageurs uniquement", "gare téléphérique", "service dédié aux véhicules", "port", "gare fret uniquement", "station de tramway", "transport par câble", "télécabine, téléphérique", "câble transporteur", "aérodrome", "héliport", "altiport" ], "poste de transformation": [], "zone d'activité ou d'intérêt": [ "sous-préfecture", "caserne de pompiers", "collège", "parc des expositions", "site d'escalade", "stand de tir", "hôpital", "préfecture", "autre service déconcentré de l'etat", "déchèterie", "haras", "etablissement extraterritorial", "marais salant", "etablissement hospitalier", "culte divers", "parc de loisirs", "mairie", "palais de justice", "etablissement pénitentiaire", "capitainerie", "hébergement de loisirs", "mine", "enseignement supérieur", "préfecture de région", "sentier de découverte", "office de tourisme", "lycée", "camping", "culte israélite", "autre établissement d'enseignement", "piscine", "siège d'epci", "maison du parc", "culte musulman", "divers agricole", "parc zoologique", "police", "université", "usine", "hôtel de département", "patinoire", "divers commercial", "enseignement primaire", "poste", "caserne", "refuge", "baignade surveillée", "divers public ou administratif", "ecomusée", "centre équestre", "divers industriel", "musée", "zone industrielle", "structure d'accueil pour personnes handicapées", "monument", "hôtel de région", "gendarmerie", "tombeau", "maison forestière", "golf", "stade", "site de vol libre", "ouvrage militaire", "complexe sportif couvert", "habitation troglodytique", "culte chrétien", "marché", "etablissement thermal", "mégalithe", "hippodrome", "maison de retraite", "terrain de sport", "terrain de handball", "terrain de rugby", "piste de sports mécaniques", "grand terrain de sport", "terrain de tennis", "piste de vélodrome", "piste d'hippodrome", "stade d'athlétisme", "piste de sport", "bassin de natation", "petit terrain multi-sports", "terrain de volley-ball", "piste de cynodrome", "city-stade", "terrain de football", "terrain de basket-ball", "terrain de pelote basque" ], "zone d'habitation": [ "lieu-dit habité", "château", "moulin", "habitat temporaire", "ruines", "grange" ] }