Commit ee86a1e5 authored by Christophe Benz's avatar Christophe Benz

Merge 2 files in README

parent 38b669bb
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)
## Specifications
* [Spécifications SCDL "Adresses locales" v1.1](http://www.opendatafrance.net/SCDL_Adresses_Locales)
## Contexte
* [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)
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.
### Validation sur mesure:
#### Avertissement !
Case à cocher si la faisabilité est ok et soutenable
### `cle_interop`:
L'utilisation de cette spécification requiert de prêter une attention toute particulière aux points suivants :
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 `_`
```
* 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'
- [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
## Voir aussi
La spécification du modèle de données peut être utilement complétée par les documents suivants :
### `x`
* [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)
- [ ] 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
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 :
### `y`
* [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
- [ ] 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
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).
### `lat`
Pour poser une question, commenter, faire un retour d’usage ou contribuer à l’amélioration du modèle de données, vous pouvez :
- [ ] Vérification que la valeur lat est bien dans la zone France Métropolitaine ou DOM TOM
### `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.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)
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment