IGNFServiceReverseGeocoder¶
L'IGNFServiceReverseGeocoder est un Transformer encapsulant le service de géocodage inverse de l'IGN.
Ce Transformer utilise le service de géocodage inverse de l’IGN pour retourner l’entité ou les entités géolocalisées les plus proches, correspondant à une ou plusieurs des catégories suivantes : adresses, toponymes, parcelles cadastrales et unités administratives.
Le service est limité à 50 requêtes par seconde.
Documentation du service de géocodage de l'IGN
Note
Le service de géocodage inverse permet de fournir les coordonnées géographiques d’une adresse postale, d’un lieu ou d’une parcelle cadastrale. Les données de références utilisées par le service de géocodage sont :
la BAN (Base Adresse Nationale) pour le géocodage des adresse ;
la BDTOPO pour le géocodage des noms de lieux (appelés aussi « POI ») ;
le produit Parcellaire Express (PCI) pour le géocodage des parcelles.
Le géocodage des lieux est composé de plusieurs thèmes dont le thème administratif permettant de localiser les différentes divisions administrative du territoire (commune, région…).
Configuration¶
Port d'entrée¶
Input¶
Types de géométries autorisées en entrée : point, polygone, ligne et cercle.
Le Transformer à pour but de retourner, à partir d’un ou plusieurs points géographiques indiqués en latitude/longitude, la ou les entités géolocalisées les plus proches correspondantes parmi les adresses, toponymes, parcelles cadastrales, et/ou unités administratives.
Ports de sortie¶
Response¶
Correspond au JSON brut renvoyé par l’API pour chaque requête. Renvoie : request_uuid, request_response.
Point¶
Lorsque la géométrie d’entrée est un point, cette sortie fournit tous les résultats correspondant aux coordonnées de ce point (longitude et latitude), triés par ordre de pertinence (score). Renvoie : request_uuid, point_banId, point_label, point_x, point_y, point_score et point_distance.
Exemple : en prenant comme point de référence Veremes (1225 Avenue Éole), le Transformer renvoie dix résultats. Le premier correspond à Veremes lui-même, suivi des entreprises voisines classées par score en fonction de leur distance au point de référence. Dans ce cas, Veremes obtient un score de 1, tandis que les entreprises alentours obtiennent des scores inférieurs.
Geometry¶
Lorsque la géométrie d’entrée n’est pas un point, cette sortie renvoie les résultats pertinents intersectant la géométrie, chacun avec un score égal à 1. Renvoie : request_uuid, geom_banId, geom_label, geom_x, geom_y.
<Rejected>¶
Les entités invalides ou en erreurs ressortent par ce port avec des attributs supplémentaires commençant par un suffixe "request_".