6‐ DRAFT # Intégration des BanID - BaseAdresseNationale/ban-plateforme GitHub Wiki
Intégration des BanID
Chaque objet de lieu présent dans la Base Adresse Nationale (BAN) (District, CommonToponym ou Address - voir Le Schéma de la Base Adresse Locale (BAL)) peut disposer d'un identifiant. Cet identifiant est pérenne dans le temps. Une fois attribué, il n'est pas modifié, quelles que soient les évolutions de l'objet qu'il identifie.
L'ensemble des identifiants de la BAN sont appelés BanID.
Afin de cibler plus explicitement les identifiants par type d'objet de lieu, il sera précisé :
- BanID de District
- BanID de Toponym
- BanID d'Address
Format des BanID
Les BanID respectent le format UUID v4
Exemple d'identifiant UUID v4 : 123e4567-e89b-12d3-a456-426614174000
Note :
Dans la suite du document, afin de simplifier la lecture, il sera fait usage, pour désigner un identifiant UUIDv4 de la syntaxe suivante :UUIDv4-xxxx, oùxxxxsera remplacé par une valeur numérique.
BanID en tant que clé et clé de liaison
Chaque objet de lieu possède un BanID unique permettant de l'identifier de façon explicite et non ambiguë. Les BanID seront également utilisés pour indiquer un lien de dépendance entre différents lieux.
Exemples :
Un objet
District(une commune ou un arrondissement) : commune de Cocorico
- disposera d'un BanID de District
UUIDv4-0001Un objet
Toponym(une voie ou un lieu-dit) : voie route des Prodiges, Cocorico
- disposera d'un BanID de Toponym
UUIDv4-0002- contiendra une liaison vers un
Districtvia un BanID de DistrictUUIDv4-0001Un objet
Toponym(une voie ou un lieu-dit) : voie sans adresse chemin de l'Arbre Mojo, Cocorico
- disposera d'un BanID de Toponym
UUIDv4-0003- contiendra une liaison vers un
Districtvia un BanID de DistrictUUIDv4-0001Un objet
Address(une adresse) : 2bis route des Prodiges
- disposera d'un BanID d'Address
UUIDv4-0004- contiendra une liaison vers un
Toponymvia un BanID de ToponymUUIDv4-0002- contiendra une liaison vers un
Districtvia un BanID de DistrictUUIDv4-0001
Fourniture des BanID
Les BanID sont directement fournis par le Fournisseur de données, qui s'assure de leur maintenance.
Afin d'assurer la cohérence et la maintenance des données, il est important de s'assurer la maintenance de l'ensemble des Identifiants BanID constituant d'un lieu.
Fourniture d'identifiants par le biais de fichiers BAL 1.4 (DRAFT)
Les identifiants BanID seront fournis par l'usage des attributs suivant :
- BanID d'Address via
ID_BAN_ADRESSE - BanID de Toponym via
ID_BAN_TOPONYME - BanID de District via
ID_BAN_COMMUNE
Exemples :
Afin de simplifier la lisibilité, seuls certains attributs du format BAL sont indiqués
ID_BAN_COMMUNE ID_BAN_TOPONYME ID_BAN_ADRESSE NUMERO SUFFIXE VOIE_NOM COMMUNE_NOM UUIDv4-0001 UUIDv4-0002 UUIDv4-0004 2 Bis route des Prodiges Cocorico UUIDv4-0001 UUIDv4-0002 UUIDv4-0005 4 route des Prodiges Cocorico UUIDv4-0001 UUIDv4-0003 99999 chemin de l'Arbre Mojo Cocorico
Pour en savoir plus sur les attributs disponibles consultez les spécifications du format BAL 1.4 brouillon
Fourniture d'identifiants par le biais de fichiers BAL 1.3
Afin de communiquer les identifiants BanID, qui sont intégrés dans la spécification BAL à partir de la version 1.4, le format BAL 1.3 dispose de l'attribut UID_ADRESSE.
Cet attribut unique devant, à lui seul, porter l'ensemble des BanID constituant les Adresses et Toponymes, un assemblage par préfixes permettra de distinguer les différents types de BanID.
- Prefix des BanID de District :
@c: - Prefix des BanID de Toponym :
@v: - Prefix des BanID d'Address :
@a:
Les identifiants préfixés et séparés par des espaces, sont insérés, sans contrainte de tri, en tant qu'unique valeur de l'attribut UID_ADRESSE.
Exemples :
Afin de simplifier la lisibilité, seuls certains attributs du format BAL sont indiqués
UID_ADRESSE NUMERO SUFFIXE VOIE_NOM COMMUNE_NOM @c:UUIDv4-0001 @v:UUIDv4-0002 @a:UUIDv4-0004 2 Bis route des Prodiges Cocorico @c:UUIDv4-0001 @v:UUIDv4-0002 @a:UUIDv4-0005 4 route des Prodiges Cocorico @c:UUIDv4-0001 @v:UUIDv4-0003 99999 chemin de l'Arbre Mojo Cocorico