Initialisation des identifiants - Fiche technique
v1.3 de Février 2025
Dernière mise à jour
v1.3 de Février 2025
Dernière mise à jour
v1.1 de Juin 2024
Version initiale
v1.2 de Septembre 2024
Chap 4/id_ban_toponyme : Ajout d'une précision sur le cas des voies à cheval sur 2 communes
v1.3 de Fev 2025
Chap 1 : ajout retro-compatibilité BAL 1.3, chap 3 : ajout précisions
Préambule : cette doc a pour vocation de guider le gestionnaire de fichiers BAL qui souhaite initialiser les identifiants BAN dans les Bases Adresses Locales. Il ne concerne donc pas les communes qui utilisent un outil comme MesAdresses ou un autre outil « local » (geopal ou autre).
Vocabulaire : on parlera dans ce document d’adresse et d’id_ban_adresse pour être cohérent avec le format BAL (même si quand on parle d’identifiant il serait plus juste de parler d’identifiant de lieu adressé : on détaillera cette notion dans la documentation sur les bonnes pratiques des identifiants).
C’est la version 1.4 de la spécification BAL qui permet de renseigner distinctement les 3 identifiants BAN id_ban_commune
, id_ban_toponyme
et id_ban_adresse
.
La description de ce format est dans la documentation (page 7 à 11 pour les identifiants BAN), disponible ici :
Format BAL 1.4 : https://aitf-sig-topo.github.io/voies-adresses/files/AITF_SIG_Topo_Format_Base_Adresse_Locale_v1.4.pdf
La version du format BAL 1.3 permet également d'embarquer les identifiants de façon conservatoire. Pour cela, vous devez utiliser le champ uid_adresse
, et le remplir en concaténant les 3 identifiants, et en les faisant précéder des suffixes @a: @v: @c: pour gérer les associations.
A l'intérieur de la colonne uid-adresse, l'ordre des éléments n'est pas important.
@a: pour l'id_ban_adresse
@v: pour l'id_ban_toponyme
@c: pour l'id_ban_commune
La première étape à réaliser est de récupérer l’ « id_ban_commune
», qui est le seul fourni et maintenu par la BAN, en utilisant l’url :
https://plateforme.adresse.data.gouv.fr/api/district/cog/{codeInsee}
et en remplaçant « {codeInsee}» par le code INSEE de votre commune.
Par exemple https://plateforme.adresse.data.gouv.fr/api/district/cog/31555 pour récupérer l' id_ban_commune
de Toulouse
Si besoin, la doc de l'API (en version Beta) est ici : DRAFT # API BAN Plateforme · BaseAdresseNationale/ban-plateforme Wiki · GitHub
NB : le modèle BAN ne fait pas de distinction entre les voies et les lieudits
Les identifiants BAN suivent le format standard UUID v4.
Pour générer des identifiants BAN, vous pouvez :
utiliser l’API BAN-plateforme :
· https://plateforme.adresse.data.gouv.fr/api/ban-id pour en générer un
· https://plateforme.adresse.data.gouv.fr/api/ban-id?quantity=10000 pour en générer 10000 (maxi fixé à 100000)
ou sinon un site « indépendant » Online UUID Generator Tool
ou des outils internes à des bases de données (ex : possible avec Postgres).
En suivant le format BAL 1.4, chaque ligne du format BAL csv possède les attributs :
· id_ban_commune
: c’est la valeur récupérée à l’étape 2. Elle est la même pour toutes les adresses de la commune.
· id_ban_toponyme
: c’est l’identifiant du toponyme (voie ou lieudit). Il est le même pour toutes les lignes qui concernent cette voie ou lieudit.
Précision de traitement pour les voies à cheval sur 2 communes qui auraient le même libellé : la maille de travail des BAL étant la commune, il est nécessaire d'avoir 2 id_ban_toponyme
différents, afin de ne pas créer de doublons quand on agrège les BAL.
· id_ban_adresse
: c’est l’identifiant de l’adresse. Il est le même pour toutes les positions de l’adresse (pour ceux qui souhaitent gérer plusieurs positions).
Cas particulier des voies sans numéro : il vous faudra générer un id_ban_toponyme pour l'odonyme (voie ou lieu-dit sans numéro). L'id_ban_adresse ne sera pas rempli pour ces lignes de voies sans numéro.
Si jamais vous rencontrez une difficulté : adresse@data.gouv.fr