Auteur : OpenDataFrance
Schéma créé le : 30/05/2018
Schéma mis à jour le : 24/01/2019
Site web : https://git.opendatafrance.net/scdl/adresses
Valeurs manquantes : ""
En France, la création des voies et des adresses est une compétence exercée par les communes et s'appuie sur des décisions prises par les conseils municipaux. La mise en oeuvre de cette compétence peut néanmoins être déléguée à un Etablissement Public de Coopération Intercommunale (EPCI). Le regroupement de tout ou partie des adresses d’une collectivité dans une base de données permet d'outiller la gestion et la publication de cette ressource.
En 2016, dans le cadre du groupe de travail "SIG et Topographie" rassemblant des ingénieurs territoriaux de différentes collectivités locales, l’Association des Ingénieurs Territoriaux de France (AITF) a défini un modèle d'échange de données entre les bases voie-adresse gérées localement et la Base Adresse Nationale (BAN). En l'absence d'un cadre réglementaire précis, cette spécification d'un modèle de données simple applicable à une Base Adresse Locale (BAL) permet de standardiser la publication en open data des adresses d'une collectivité.
La spécification SCDL du modèle de données relatif aux adresses locales d’une collectivité a donc été élaborée à partir de la proposition d’un modèle de données simple visant à alimenter la BAN par des fichiers de l'AITF. Si nécessaire, elle sera mise à jour, adaptée et consolidée à partir de cette même source.
L'utilisation de cette spécification requiert de prêter une attention toute particulière aux points suivants :
Contrairement aux recommandations applicables à toutes les spécifications SCDL, le modèle de l'AITF prévoit que le séparateur de colonnes du fichier tabulaire doit être le point-virgule et pas la virgule.
De même, les règles de nommage sont légèrement différentes : le nom du fichier comporte la date de création du jeu de données, la désignation du producteur et son code SIREN. Le tout sans espace ni accent et en minuscules, soit : AAAAMMJJ_producteur_siren.csv. Exemple : '20151004_rennes_213502388.csv'
Ce modèle de données fait partie et respecte les exigences du Socle Commun des Données Locales. Il repose sur les 13 champs
suivants correspondant aux colonnes du fichier tabulaire.
Titre : Clé d'interopérabilité
Description : Cette clé combine le code INSEE de la commune sur 5 caractères (incluant 'A' ou 'B' pour la Corse) + le code de voie issu du FANTOIR de la DGFiP sur 4 caractères + le numéro d’adresse sur 5 caractères préfixé par des zéros + un suffixe s'il existe, qui peut être un indice de répétition ('bis', 'ter', 'qua', 'qui', etc... codés sur 3 caractères) et/ou un complément ('a', 'b', 'c', 'a1', 'b2', 'lesmimosas', etc... sans limitation du nombre de caractères). Chaque élément est séparé par un tiret du bas et les lettres sont en minuscule.
Type : chaîne de caractères
Exemple : 35238_3961_00007_bis
Valeur : obligatoire
Taille minimale : 16
Motif : ^[A-Za-z0-9_]+$
Titre : Identifiant unique national d’adresse
Description : Cet identifiant unique d’adresse est géré et attribué par le service "guichet national d’identification" de la Base Adresse Nationale. Dans l'attente de la mise en place de ce service, les règles de création ou de gestion de cet identifiant ne sont pas connues. La valeur de ce champ est donc optionnelle et sera laissée vide aussi longtemps que le service d'identification ne sera pas opérationnel.
Type : chaîne de caractères (format uuid
)
Valeur : optionnelle
Titre : Nom complet de la voie
Description : Ce champ contient la concaténation du type et du nom de la voie ou le nom d'un lieu-dit, exprimés en majuscules et minuscules accentuées.
Type : chaîne de caractères
Exemple : 'Allée de Bréhat' pour une concaténation ou 'Le pré aux grenouilles' pour un lieu-dit
Valeur : obligatoire
Taille minimale : 3
Motif : ^[a-zA-Z0-9\-\'\s\d\u00C0-\u00FF]+$
Titre : Numéro d’adresse
Description : Numéro d’adresse dans la voie et, dans le cas des voies sans adresse, la valeur “99999” est attendue
Type : nombre entier
Exemple : 130
Valeur : obligatoire
Valeur minimale : 0
Valeur maximale : 99999
Titre : Information suffixée qui complète et précise le numéro d’adresse
Description : Cette information peut être un indice de répétition ('bis', 'ter', 'qua', 'qui', etc... codés sur 3 caractères en minuscules) ou un complément comme le nom d'entrée d'immeuble ('a', 'b', 'c', 'a1', 'b2', 'lesmimosas', etc... codés en minuscules non accentuées, sans espace ni limite du nombre de caractères).
Type : chaîne de caractères
Exemple : 'ter' pour un indice de répétition ou 'lesmimosas' pour un nom d'entrée d'immeuble
Valeur : optionnelle
Motif : ^[a-z\d\u00DF-\u00FF]+$
Titre : Nom officiel de la commune
Description : Ce champ doit permettre d’identifier rapidement le territoire concerné et d'éviter les quiproquos.
Type : chaîne de caractères
Exemple : Brest
Valeur : obligatoire
Motif : ^[A-Za-z\s\-\u00C0-\u00FF]+$
Titre : Code de position de l’adresse
Description : Ce code décrit la position d’une adresse à partir d’une liste de valeurs qui provient de la spécification INSPIRE v 3.1 sur le thème "Adresses". Les valeurs attendues sont, au choix, 'délivrance postale', 'entrée', 'bâtiment', 'cage d’escalier', 'logement', 'parcelle', 'segment', ou 'service technique'.
Type : chaîne de caractères
Exemple : cage d’escalier
Valeur : obligatoire
Valeurs autorisées : délivrance postale, entrée, bâtiment, cage d’escalier, logement, parcelle, segment, service technique
Titre : Coordonnée X
Description : Coordonnée X du système légal en vigueur sur le territoire concerné, conformément à l’article 1 du décret n° 2006-272 du 3 mars 2006. Le signe de séparation entre les parties entière et décimale du nombre est le point.
Type : nombre réel
Exemple : 145377.5
Valeur : optionnelle
Titre : Coordonnée Y
Description : Coordonnée Y du système légal en vigueur sur le territoire concerné, conformément à l’article 1 du décret n° 2006-272 du 3 mars 2006. Le signe de séparation entre les parties entière et décimale du nombre est le point.
Type : nombre réel
Exemple : 6835665.67
Valeur : optionnelle
Titre : Longitude
Description : Coordonnée de longitude exprimée en WGS 84. Le signe de séparation entre les parties entière et décimale du nombre est le point.
Type : nombre réel
Exemple : -4.502217943385534
Valeur : optionnelle
Titre : Latitude
Description : Coordonnée de latitude exprimée en WGS 84. Le signe de séparation entre les parties entière et décimale du nombre est le point.
Type : nombre réel
Exemple : 48.383985827041485
Valeur : optionnelle
Titre : Nom de la source
Description : Ce nom peut désigner, au choix, la collectivité ayant créé juridiquement l’adresse (par délibération), l'entité ayant créé la donnée, ou l’entité ayant diffusé / publié la donnée.
Type : chaîne de caractères
Exemple : Rennes Métropole
Valeur : obligatoire
Motif : [a-zA-Z0-9\-\d\s\u00C0-\u00FF]+
Titre : Date de dernière mise à jour
Description : Cette date est celle de la dernière mise à jour connue de la donnée. Elle ne correspond pas à la date de publication du jeu de données en open data. Elle est exprimée au format AAAA-MM-JJ suivant la norme internationale ISO 8601.
Type : date
Exemple : 2014-10-01
Valeur : obligatoire
La spécification du modèle de données peut être utilement complétée par les documents suivants :
Pour faciliter la production et améliorer la qualité des données au format Base Adresse Locale, la mission Etalab de la DINSIC, met à disposition des outils dédiés sur le portail adresse.data.gouv.fr :
Le validateur BAL permet de vérifier la conformité d'un fichier BAL
L'éditeur BAL permet de créer et/ou de modifier un fichier BAL
Les sources de ces outils sont disponibles sur le dépôt Github de la mission Etalab.
Pour poser une question, commenter, faire un retour d’usage ou contribuer à l’amélioration du modèle de données, vous pouvez :
adresser un message à [email protected]
ouvrir un ticket sur le dépôt GitLab d’OpenDataFrance
ouvrir un ticket sur le dépôt GitLab d’OpenDataFrance