Documentation
adresse.data.gouv.fr
  • Généralités
  • Rappel historique
  • Feuille de route
  • Naviguer sur le site
    • Services et outils à disposition
    • Les API
  • Utiliser la Base Adresse Nationale
    • Les fichiers de la Base Adresse Nationale
    • Les adresses certifiées
    • Adresses et FANTOIR
    • Foire aux questions
    • Adresse_Labs
    • Identifiants : gestion et guide pratique
      • Initialisation des identifiants - Fiche technique
      • Gestion des identifiants - Bonnes pratiques
        • Résumé des règles de bonnes pratiques (ce qu’il faut retenir !)
        • Création d'une nouvelle adresse
        • Modifications (attributaires)
        • Suppression d'une adresse
        • Cas complexes de scission, fusion
        • Cas des voies et lieudits
        • Identifiant des communes
        • Ressources Notion de référentiel et identifiant
      • FAQ Identifiants
  • Mettre à jour sa Base Adresse Locale
    • L'adresse, compétence communale
    • Schéma du parcours
    • Les aides aux communes
    • Les prestations pour la réalisation d’une Base Adresse Locale
    • Principe de fonctionnement d'une Base Adresse Locale
    • Le Format Base Adresse Locale
      • La gestion des hameaux et lieux-dits
      • La gestion du lien adresse_parcelle
      • La gestion des voies sans adresse
    • Renseigner les adresses en langue régionale
    • Publier une Base Adresse Locale
    • Une Base Adresse Locale ne se dépublie pas
    • Comment accompagner les communes
    • Communes, prestataires. Rappels des responsabilités
    • Communiquer sur ses adresses
    • Communes, opérateurs. Obligations relatives à l’adresse
    • Mise à jour des fonds de plans
    • Diffuser la réglementation en matière de circulation routière
    • Outils des Partenaires de la Charte
    • Adresse en région
      • Restitution des ateliers organisés à Rennes
      • Restitution des ateliers organisés à Landerneau
      • Restitution des ateliers organisés à Amiens
Propulsé par GitBook
Sur cette page
  • 1. Le format BAL 1.4
  • 2. Comment générer l’ id_ban_commune (API)
  • 3. Comment générer des uuid v4 pour les adresses « id_ban_adresse » et les odonymes (voies et lieudits) « id_ban_toponyme »
  • 4. Règles d’affectation des identifiants
  • 5. …Et republier la BAL
  1. Utiliser la Base Adresse Nationale
  2. Identifiants : gestion et guide pratique

Initialisation des identifiants - Fiche technique

v1.3 de Février 2025

PrécédentIdentifiants : gestion et guide pratiqueSuivantGestion des identifiants - Bonnes pratiques

Dernière mise à jour il y a 3 mois

Suivi des modifications
Texte

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

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 .

La description de ce format est dans la documentation (page 7 à 11 pour les identifiants BAN), disponible ici :

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

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 :

et en remplaçant « {codeInsee}» par le code INSEE de votre commune.

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 :

  • 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

Format BAL 1.4 :

Par exemple pour récupérer l' id_ban_commune de Toulouse

Si besoin, la doc de l'API (en version Beta) est ici :

· pour en générer un

· pour en générer 10000 (maxi fixé à 100000)

ou sinon un site « indépendant »

Si jamais vous rencontrez une difficulté :

https://aitf-sig-topo.github.io/voies-adresses/files/AITF_SIG_Topo_Format_Base_Adresse_Locale_v1.4.pdf
https://plateforme.adresse.data.gouv.fr/api/district/cog/{codeInsee}
https://plateforme.adresse.data.gouv.fr/api/district/cog/31555
DRAFT # API BAN Plateforme · BaseAdresseNationale/ban-plateforme Wiki · GitHub
https://plateforme.adresse.data.gouv.fr/api/ban-id
https://plateforme.adresse.data.gouv.fr/api/ban-id?quantity=10000
Online UUID Generator Tool
adresse@data.gouv.fr
Modèle de données Spec BAL 1.4 avec les 3 identifiants BAN
Exemple de transmission d'identifiants dans le champ uid_adresse de la spec BAL 1.3