Aller au contenu principal

v1.3 de Février 2025

Initialisation des identifiants - Fiche technique

Suivi des modificationsTexte
v1.1 de Juin 2024Version initiale
v1.2 de Septembre 2024Chap 4/id_ban_toponyme : Ajout d'une précision sur le cas des voies à cheval sur 2 communes
v1.3 de Fev 2025Chap 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).

1. Le format BAL 1.4​

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 .

Modèle de données Spec BAL 1.4 avec les 3 identifiants BAN

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

Exemple de transmission d'identifiants dans le champ uid_adresse de la spec BAL 1.3

2. Comment générer l’ id_ban_commune (API)​

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

3. Comment générer des uuid v4 pour les adresses « id_ban_adresse » et les odonymes (voies et lieudits) « id_ban_toponyme »​

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).

4. Règles d’affectation des identifiants​

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.

5. …Et republier la BAL​

Si jamais vous rencontrez une difficulté : adresse@data.gouv.fr