...
 
Commits (11)
include:
- project: 'scdl/documentation'
file: '.gitlab-ci-for-schema-repo.yml'
# Changelog
# 1.1.2 -> 1.1.3
# 1.1.4
Changements internes :
- utilisation des [métadonnées standardisées](https://github.com/frictionlessdata/specs/blob/master/specs/patterns.md#table-schema-metadata-properties)
# 1.1.3
Changements internes :
......@@ -11,7 +17,7 @@ Changements internes :
- suppression de la contrainte `required` sur le champ `suffixe`
- amélioration des titres et descriptions
## 1.1.1 -> 1.1.2
## 1.1.2
Changements internes :
......@@ -19,7 +25,7 @@ Changements internes :
- rétablissement de la contrainte `required` pour le champ `numero`
- abandon de la contrainte `required` pour les champs `x`, `y`, `lat`, `long`
## 1.1 -> 1.1.1
## 1.1.1
Changements internes :
......
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](https://fr.wikipedia.org/wiki/%C3%89tablissement_public_de_coop%C3%A9ration_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"](http://www.aitf.fr/groupe-travail/sig-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](https://cms.geobretagne.fr/sites/default/files/documents/aitf-sig-topo-adresse-fichier-echange-simplifie-v_1.1_0.pdf) de l'AITF. Si nécessaire, elle sera mise à jour, adaptée et consolidée à partir de cette même source.
#### `Avertissement !`
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'
\ No newline at end of file
# Schéma relatif aux adresses locales d’une collectivité (BAL)
# Base adresse locale
## Specifications
* [Spécifications SCDL "Adresses locales" v1.1](http://www.opendatafrance.net/SCDL_Adresses_Locales)
Spécification du modèle de données relatif aux adresses locales d’une collectivité (BAL)
* [Version modifiée pour assurer une convergence stricte vers le modèle de l'AITF](https://cms.geobretagne.fr/sites/default/files/documents/aitf-sig-topo-adresse-fichier-echange-simplifie-v_1.1_0.pdf)
## Contexte
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](https://fr.wikipedia.org/wiki/%C3%89tablissement_public_de_coop%C3%A9ration_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"](http://www.aitf.fr/groupe-travail/sig-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é.
### Validation sur mesure:
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](https://cms.geobretagne.fr/sites/default/files/documents/aitf-sig-topo-adresse-fichier-echange-simplifie-v_1.1_0.pdf) de l'AITF. Si nécessaire, elle sera mise à jour, adaptée et consolidée à partir de cette même source.
Case à cocher si la faisabilité est ok et soutenable
### `cle_interop`:
#### Avertissement !
Elle est composée de plusieurs informations dont certaines peuvent etre vérifiées unitairement et d'autres dont les valeurs sont reproduites dans les autres champs
```
- (code INSEE)
+ code de voie ( 4 caractères) + numéro d’adresse (5 caractères préfixé par des zéros)
+ suffixe (indice de répétition et complément) séparés par `_`
```
L'utilisation de cette spécification requiert de prêter une attention toute particulière aux points suivants :
- [x] Validation code INSEE par recherche dans la base INSEE
- [x] Validation code de voie par cohérence
- [x] Validation du numéro d'adresse par cohérence
- [x] Validation du suffixe par cohérence
- [x] Validation de composition
* 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'
## Voir aussi
### `x`
La spécification du modèle de données peut être utilement complétée par les documents suivants :
- [ ] Vérification maximum de 2 décimales (Non)[https://git.opendatafrance.net/qualidata/qualidata-ui/issues/29]
- [ ] Vérification que la valeur X est bien dans la zone Lambert 93 ou si hors métropole dans la zone correspondante
* [Fichier gabarit à télécharger au format xlsx](https://scdl.opendatafrance.net/docs/templates/scdl-adresses.xlsx)
* [Schéma de validation](https://git.opendatafrance.net/scdl/adresses/blob/master/schema.json)
### `y`
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 :
- [ ] Vérification maximum de 2 décimales (Non)[https://git.opendatafrance.net/qualidata/qualidata-ui/issues/29]
- [ ] Vérification que la valeur Y est bien dans la zone Lambert 93 ou si hors métropole dans la zone correspondante
* [Le validateur BAL](https://adresse.data.gouv.fr/bases-locales/validateur) permet de vérifier la conformité d'un fichier BAL
* [L'éditeur BAL](https://adresse.data.gouv.fr/bases-locales/editeur) permet de créer et/ou de modifier un fichier BAL
### `lat`
Les sources de ces outils sont disponibles sur le [dépôt Github de la mission Etalab](https://github.com/etalab/adresse.data.gouv.fr).
- [ ] Vérification que la valeur lat est bien dans la zone France Métropolitaine ou DOM TOM
Pour poser une question, commenter, faire un retour d’usage ou contribuer à l’amélioration du modèle de données, vous pouvez :
### `long`
- [ ] Vérification que la valeur long est bien dans la zone France Métropolitaine ou DOM TOM
### `date_der_maj`
- [ ] Vérification que la date de mise à jour est supérieure à 2000-01-01 et inférieure à la date du jour+1?
### Exemples de fichiers CSV :
* Strasbourg : https://www.data.gouv.fr/fr/datasets/adresses-de-la-ville-de-strasbourg/
* Rennes : https://www.data.gouv.fr/fr/datasets/adresses-du-referentiel-voies-et-adresses-au-format-bal/
* Bayonne : https://www.data.gouv.fr/fr/datasets/adresses-du-referentiel-voies-et-adresses-au-format-bal-bayonne/
* Brest : https://www.data.gouv.fr/fr/datasets/referentiel-adresses-au-format-bal-pays-de-brest-1/
* adresser un message à [scdl@opendatafrance.email](mailto:scdl@opendatafrance.email?subject=Base%20Adresse%20Locale)
* ouvrir un ticket sur le [dépôt GitLab d’OpenDataFrance](https://git.opendatafrance.net/scdl/adresses/issues)
La spécification du modèle de données peut être utilement complétée par les documents suivants :
* [Fichier gabarit à télécharger au format xlsx](https://scdl.opendatafrance.net/docs/templates/scdl-adresses.xlsx)
* [Schéma de validation](https://git.opendatafrance.net/scdl/adresses/blob/master/schema-scdl-adresses.json)
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](https://adresse.data.gouv.fr/bases-locales/validateur) permet de vérifier la conformité d'un fichier BAL
* [L'éditeur BAL](https://adresse.data.gouv.fr/bases-locales/editeur) 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](https://github.com/etalab/adresse.data.gouv.fr).
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 à [scdl@opendatafrance.email](mailto:scdl@opendatafrance.email?subject=Base%20Adresse%20Locale)
* ouvrir un ticket sur le [dépôt GitLab d’OpenDataFrance](https://git.opendatafrance.net/scdl/adresses/issues)
{
"$schema": "https://frictionlessdata.io/schemas/table-schema.json",
"name": "scdl-adresses",
"title": "Base adresse locale",
"author": "OpenDataFrance",
"version": "1.1.3",
"created": "2018-05-30",
"updated": "2019-01-24",
"description": "Spécification du modèle de données relatif aux adresses locales d’une collectivité (BAL)",
"uri": "https://git.opendatafrance.net/scdl/adresses/raw/v1.1.3/schema.json",
"countryCode": "FR",
"homepage": "https://git.opendatafrance.net/scdl/adresses",
"path": "https://git.opendatafrance.net/scdl/adresses/raw/v1.1.4/schema.json",
"resources": [
{
"title": "Exemple de fichier adresses invalide",
"path": "https://git.opendatafrance.net/scdl/adresses/raw/v1.1.4/exemples/exemple_invalide.csv"
}
],
"created": "2018-05-30",
"lastModified": "2019-06-27",
"version": "1.1.4",
"contributors": [
{
"title": "OpenDataFrance",
"role": "author"
}
],
"fields": [
{
"name": "cle_interop",
......
# Base adresse locale
Spécification du modèle de données relatif aux adresses locales d’une collectivité (BAL)
- nom : scdl-adresses
- page d'accueil : https://git.opendatafrance.net/scdl/adresses
- URL du schéma : https://git.opendatafrance.net/scdl/adresses/raw/next/schema.json
- version : 1.1.3
- date de création : 30/05/2018
- date de dernière modification : 24/01/2019
- concerne le pays : FR
- valeurs manquantes représentées par : `[""]`
- contributeurs :
- OpenDataFrance (auteur)
- ressources :
- Exemple de fichier adresses invalide ([lien](https://git.opendatafrance.net/scdl/adresses/raw/next/exemples/exemple_invalide.csv))
## Modèle de données
Ce modèle de données repose sur les 13 champs suivants correspondant aux colonnes du fichier tabulaire.
### `cle_interop`
- titre : Clé d'interopérabilité
- description : Cette clé combine le [code INSEE de la commune](https://fr.wikipedia.org/wiki/Code_Insee) sur 5 caractères (incluant 'A' ou 'B' pour la Corse) + le code de voie issu du [FANTOIR](https://fr.wikipedia.org/wiki/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_]+$`
### `uid_adresse`
- 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 (uuid)
- valeur optionnelle
### `voie_nom`
- 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]+$`
### `numero`
- 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 maximale : 99 999
### `suffixe`
- 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]+$`
### `commune_nom`
- 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]+$`
### `position`
- 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"]`
### `x`
- 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](https://www.legifrance.gouv.fr/jo_pdf.do?id=JORFTEXT000000813996) 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
### `y`
- 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](https://www.legifrance.gouv.fr/jo_pdf.do?id=JORFTEXT000000813996) 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
### `long`
- titre : Longitude
- description : Coordonnée de longitude exprimée en [WGS 84](https://fr.wikipedia.org/wiki/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
### `lat`
- titre : Latitude
- description : Coordonnée de latitude exprimée en [WGS 84](https://fr.wikipedia.org/wiki/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
### `source`
- 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]+`
### `date_der_maj`
- 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](https://fr.wikipedia.org/wiki/ISO_8601).
- type : date
- exemple : `2014-10-01`
- valeur obligatoire