Initialisation des identifiants - Fiche technique

v1.1 de Juin 2024

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

NB : 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 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 disponible ici (page 7 à 11 pour les identifiants BAN) :

Format BAL 1.4 : https://aitf-sig-topo.github.io/voies-adresses/files/AITF_SIG_Topo_Format_Base_Adresse_Locale_v1.4.pdf

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

La première chose à faire est de récupérer l’ « id_ban_commune » qui est le seul fourni par la BAN en utilisant l’url :

https://plateforme.adresse.data.gouv.fr/api/district/cog/{codeInsee} en remplaçant « {codeInsee}» par le code INSEE de votre commune (par exemple https://plateforme.adresse.data.gouv.fr/api/district/cog/31555 pour Toulouse)

Si besoin la doc (en version Béta) 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 toponymes (voies et lieudits) « id_ban_toponyme »

NB : la BAN ne fait pas de distinction entre les voies et les lieudits

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 et est la même pour toute 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.

· id_ban_adresse : c’est l’identifiant de l’adresse. Il est le même pour toutes les positions de l’adresses (pour ceux qui souhaitent gérer plusieurs positions)

NB : pour les voies sans numéro, il vous faudra générer un id_ban_toponyme (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é : [e-mail]