FR:Key:ref:FR:FANTOIR

La clé ref:FR:FANTOIR=* est une référence nationale française, qui identifie les voies, lieux-dits et ensembles immobiliers. Elle est utilisée en particulier dans le projet BANO (Base d'Adresses Nationale Ouverte).

Le fichier TOPO (ex-FANTOIR)

Le fichier TOPO, qui s'appelait jusqu'en 2023 fichier FANTOIR (Fichier ANnuaire TOpographique Initialisé Réduit), et anciennement fichier RIVOLI (Répertoire Informatisé des VOies et LIeux-dits), est un document listant, par commune, les voies, les lieux-dits et les ensembles immobiliers. Il est produit et utilisé par la direction générale des Finances publiques (DGFiP) pour l'édition et l'émission des feuilles d'impôts. Sa mise à jour est prévue pour être mensuelle.

Voir sur Wikipédia : Wikipedia:FANTOIR

Le fichier TOPO contient notamment le type de lieu (voie, lieu-dit ou ensemble immobilier), son nom, son code unique composé de caractères alphanumériques, sa date de création...

Le "code Fantoir"

A l'époque du fichier RIVOLI, le code unique attribué à chaque voie, lieu-dit ou ensemble immobilier était composé de 4 caractères.

Le premier caractère est :

• un chiffre de 0 à 9 pour les voies du domaine public
• une lettre A pour les ensembles immobiliers (résidences, lotissements privés, copropriétés) dont la voirie interne ne fait pas partie du domaine public,
• une lettre de B à W pour les lieux-dits (habités ou non),
• une lettre X pour les pseudo-voies (souvent des noms d'équipements ou de secteurs, tels que les ZAC, centres commerciaux, centres sportifs, hôpitaux, ou les zones militaires dont la voirie interne n'est pas détaillée, mais aussi des canaux, voies ferrées, des zones portuaires, etc.)
• une lettre Y à Z pour les voies provisoires à annuler (par exemple créées pour contourner des travaux importants).

Dans son successeur, le fichier FANTOIR, on trouve un «identifiant de la voie» sur 11 caractères :

• les codes département (2 caractères, ou 3 pour l'outre-mer) et direction (1 caractère) ;
• le code commune Insee (3 caractères, ou 2 pour l'outre-mer) ;
• le code RIVOLI (4 caractères) ;
• la clé de contrôle (1 lettre de l'alphabet sans I, O et Q).

On a dérivé de cet «identifiant de la voie» le contenu de la clé ref:FR:FANTOIR=*, sur 10 caractères, en enlevant le code direction. C'est ce qu'on appelle communément le «code Fantoir».

Le fichier FANTOIR a été remplacé par le fichier TOPO fin 2023 et le code est passé à 9 caractères, avec la disparition du code direction et de la clé de contrôle.

Il ne reste donc plus que :

• le code INSEE de la commune ou de l'arrondissement municipal (5 caractères) ;
• le code RIVOLI de la voie (4 caractères).

Attention : Malgré le changement de nom du fichier, on continue par habitude à l'appeler "code Fantoir" et la clé sur OpenStreetMap reste ref:FR:FANTOIR=*.

Utilisation de la clé

Ajouter de préférence les nouveaux codes Fantoir sur 9 caractères (format du fichier TOPO).

Les codes sur 10 caractères (format du fichier FANTOIR) sont toujours acceptés et reconnus par JOSM, Osmose et Pifomètre.

L'utilisation de ce tag est décrite en détails sur la page Contribuer à la BANO.

Sur les voies

En principe, on place le tag sur l'entité représentant la voie en évitant de le dupliquer inutilement :

• la relation associatedStreet (ou street),
• ou à défaut sur le(s) way(s) symbolisant la voie.

Sur les lieux-dits

On place le tag sur le nœud symbolisant le lieu-dit (place=*).

Cas particulier des voies limitrophes

Lorsqu'une voie marque la frontière entre deux communes, il est parfois nécessaire d'indiquer les références FANTOIR propres aux deux communes (voir par exemple le Chemin de Garenne) :

• ref:FR:FANTOIR:left=* (commune du coté gauche de la voie)
• ref:FR:FANTOIR:right=* (commune du coté droit de la voie)

Références

• Définition : https://data.economie.gouv.fr/api/datasets/1.0/fichier-fantoir-des-voies-et-lieux-dits/attachments/descriptif_du_fichier_national_fantoir_pdf
• Accès simple d'utilisation (code sur 9 caractères sans la clé de contrôle) : https://adresse.data.gouv.fr/fantoir
• Fichiers globaux par région (code sur 11 caractères incluant la clé de contrôle) : https://www.collectivites-locales.gouv.fr/competences/le-fichier-des-voies-et-lieux-dits-fantoir