2‐ DRAFT# Schema de la base de données BAN

Représentation des données au sein de la Base Adresse Nationale

Structure de données au sein de la BAN

La Base Adresses Nationale (BAN) est une Base de données qui stocke différents objets. Tous ces objets sont des objets de 'lieux' (Emplacement identifiable et positionnable sur une surface géographique). Les objets de lieux sont de différent type :

• Les Toponym (tout 'lieu' possédant une dénomination propre)
• Les Address (les adresses elle-même, composées de plusieurs toponyms et autres informations),

De plus, les Toponym sont eux-mêmes séparés en plusieurs sous-groupes, disposant de leurs propres caractéristiques :

• Les CommonToponym (ou 'Toponyme Commun', à savoir, les voies, places, lieux-dits, ou autres toponymes du même ordre)
• Les District (correspondant aux entités administratives responsables des adresses, à savoir, les communes ou arrondissements).

Ces entités rassemblent, l’ensemble des lieux et données constituant une adresse.

Note :
Tout objet dit ‘identifiable’ possède un identifiant, dit ‘BanID’


Définition des types génériques utilisés dans la base de données.

Ces types sont utilisés pour définir certaines valeurs d'entrées présentes dans la base de données.

• labelSchema : Fournis un modèle permettant de stocker un label multilingue
• geometrySchema : Modèle de représentation géométrique semblable aux types de valeur attendu pour les éléments de clé geometry du format GeoJSON
• positionSchema : Représentation d'une position.
  • Le type de position est issue de la liste disponible dans la specification BAL :
  • ℹ : La géométrie fournie et toujours de type 'Point'

erDiagram
    
    TYPE__labelSchema {
        isoCode string "Code Lang au format ISO639v3"
        value string
    }

    TYPE__geometrySchema {
        type string
        coordinates array
    }

    TYPE__positionSchema {
        type string
        geometry TYPE__geometrySchema
    }

Loading

Schématisation de la base de données

La Base Adresse Nationale est constituée de 3 entités de type 'lieux' composant la donnée Adresse :

• District : Les entités administratives responsables de la gestion des adresses (les communes ou arrondissements)
• CommonToponym : Les toponymes communs. Utilisé pour la partie littérale des adresses (rue, place, lieux-dits, etc.) sous la dénomination mainCommonToponym. Ils peuvent également être ajoutés en tant que lieux secondaires de l'adresse (certains usages de lieux-dits), sous la dénomination secondaryCommonToponyms. Les CommonToponym sont 'liés à' et 'administrés par’ un District.
• Address : Les lieux adresses. Les adresses sont chacune 'liées à' et ‘administrée par’ un District et positionnés sur un CommonToponym.

Chacune de ces entités possède un attribut meta, capable de portée des données additionnelles. Ces données sont de sources externes aux périmètre de l'Adresse, mais ouvertes et d'utilités publiques (par exemple, les codes INSEE, Identifiants de parcelles cadastrale, codes postaux, etc.).

Chacune de ces entités possède une table historique associée qui est gérée automatiquement par le système. La base de données écoute chaque évènements (ajout, modification, suppression), ajoute à l'historique l'état de l'entité pré-évènement et rempli l'attribut range_validity avec la date de début et de fin de validité de l'entité.

erDiagram

    Address {
        id string(BanID-Address)
        districtID string(BanID-District)
        mainCommonToponymID string(BanID-CommonToponym)
        secondaryCommonToponymIDs arrayOf(string(BanID-CommonToponym))
        labels arrayOf(TYPE__labelSchema)
        number number
        suffix string
        positions arrayOf(TYPE__positionSchema)
        certified boolean
        meta JSONB
        updateDate date
        range_validity range(date)
        isActive boolean
    }

    CommonToponym {
        id string(BanID-CommonToponym)
        districtID string
        labels arrayOf(TYPE__labelSchema)
        geometry TYPE__geometrySchema
        meta JSONB
        updateDate date
        range_validity range(date)
        isActive boolean
    }
    CommonToponym 1--1 Address : main
    CommonToponym 1--0+ Address : secondarys

    District {
        id string(BanID-District) 
        labels arrayOf(TYPE__labelSchema)
        meta JSONB
        config JSONB
        updateDate date
        range_validity range(date)
        isActive boolean
    }
    District 1--1 Address : manage
    District 1--1 CommonToponym : manage

Loading

Description des champs des entités de lieux District

• id : (Obligatoire) Identifiant unique d'entité administrative (Commune ou arrondissement) au sein de la BAN.

• labels : Liste multilingue de dénominations littérales de l'entité administrative.

  Quelques exemples :

  • [{isoCode: 'fra', value: 'Versailles'}] utilisé sur l'adresse 'Château de Versailles, place d'Armes, 78000 Versailles'.
  • [{isoCode: 'fra', value: 'Bayonne'}, {isoCode: 'eus', value: 'Baiona'}] utilisé sur l'adresse '1 avenue Maréchal Leclerc, 64100 Bayonne'.

  Note 1: N'est mise à disposition qu'une unique valeur par la langue.
  Note 2: Bien que déconseillée, la BAN n'interdit pas l'usage d'une même dénomination sur plusieurs district.

• meta : Données additionnelles au format JSON.

• config : Données de configuration de l'entité administrative.

• updateDate : Date de mise à jour de la donnée, telle qu’elle est renseignée par le fournisseur (généralement une date administrative, à différencier de la date de mise à jour technique au sein de la BAN).

• range_validity : Date de validité de l'entité. Attribut géré automatiquement par la base de données.

• isActive : Attribut permettant de savoir si l'entité est active (vrai) ou si elle a été supprimée (faux). Attribut géré automatiquement par la base de données.

Description des champs des entités de lieux CommonToponym

• id : (Obligatoire) Identifiant unique de toponyme au sein de la BAN.

• districtID : (Obligatoire) Identifiant unique de l'entité administrative (Commune ou arrondissement) sur laquelle se trouve le toponyme.

• labels : Liste multilingue de dénominations littérales du toponyme.

  Quelques exemples :

  • [{isoCode: 'fra', value: 'place d'Armes'}] utilisé sur l'adresse 'Château de Versailles, place d'Armes, 78000 Versailles'.
  • [{isoCode: 'fra', value: 'avenue Maréchal Leclerc'}, {isoCode: 'eus', value: 'Leclerc Marexalaren etorbidea'}] utilisé sur l'adresse '1 avenue Maréchal Leclerc, 64100 Bayonne'.

  Note 1: N'est mise à disposition qu'une unique valeur par la langue.
  Note 2: Bien que déconseillée, la BAN n'interdit pas l'usage d'une même dénomination sur plusieurs toponymes.

• geometry : Position du toponyme.

• meta : Données additionnelles au format JSON.

• updateDate : Date de mise à jour de la donnée, telle qu’elle est renseignée par le fournisseur (généralement une date administrative, à différencier de la date de mise à jour technique au sein de la BAN).

• range_validity : Date de validité de l'entité. Attribut géré automatiquement par la base de données.

• isActive : Attribut permettant de savoir si l'entité est active (vrai) ou si elle a été supprimée (faux). Attribut géré automatiquement par la base de données.

Description des champs des entités de lieux Address

• id : (Obligatoire) Identifiant unique de l'adresse au sein de la BAN.

• districtID : (Obligatoire) Identifiant unique de l'entité administrative (Commune ou arrondissement) sur laquelle se trouve l'adresse.

• mainCommonToponymID : (Obligatoire) Identifiant unique du toponyme (voie, lieu-dit, etc.) sur lequel se trouve l'adresse.

• secondaryCommonToponymIDs : Liste d'identifiants uniques de toponyme sur les-quelle se trouve l'adresse, utile à l'identification nominative de l'adresse (généralement, des lieux-dits, quartiers, etc.).

• labels : Dénomination alternative de l'adresse, généralement reconnue comme un lieu-dit unique à une adresse.

  Quelques exemples :

  • [{isoCode: 'fra', value: 'Château du Clos Lucé'}] pour l'adresse 'Château du Clos Lucé, 2 rue du Clos Lucé, 37400 Amboise',
  • [{isoCode: 'fra', value: 'Château de Versailles'}] pour 'Château de Versailles, place d'Armes, 78000 Versailles'
  • [{isoCode: 'fra', value: 'La Ferme Du Buisson'}] pour 'La Ferme Du Buisson, allée de la Ferme, 77186 Noisiel'

  Note 1: N'est mise à disposition qu'une unique valeur par la langue.
  Note 2: Bien que déconseillée, la BAN n'interdit pas l'usage d'une même dénomination sur plusieurs adresses.

• number : Numéro de l'adresse, utilisé dans le littéral. (Exemple : '2' pour l'adresse 'Château du Clos Lucé, 2 Rue du Clos Lucé, 37400 Amboise').

• suffix : Suffixe du numéro de l'adresse, utilisé dans le littéral. (Exemple : 'bis' pour l'adresse '1 bis Rue de la Malonnière, 37400 Amboise').

• positions : (Obligatoire) Liste des positions de l'adresse. La première position fournie est considérée comme adresse par défaut. Cette première position sera fournie aux systèmes ne réclamant qu'une unique position sans préciser le type ou si le type demandé n'est pas présent (cas de nombreux GPS ou système de cartographie).

• certified : Si vrai, alors l'adresse est certifiée par l'entité administrative responsable de l'adresse (soit, le district).

• meta : Données additionnelles au format JSON.

• updateDate : Date de mise à jour de la donnée, telle qu’elle est renseignée par le fournisseur (généralement une date administrative, à différencier de la date de mise à jour technique au sein de la BAN).

• range_validity : Date de validité de l'entité. Attribut géré automatiquement par la base de données.

• isActive : Attribut permettant de savoir si l'entité est active (vrai) ou si elle a été supprimée (faux). Attribut géré automatiquement par la base de données.