BAN (French)
Pierre Balzergue
2022-03-21
ban_fr.RmdDescription for BAN database
La base de donnée BAN (acronyme de base adresse nationale) est la référence pour les adresses en France, officiellement reconnue par l’administration française. Elle est produite et mise à jour par Etalab, un département de la direction interministérielle du numérique (DINUM) ainsi que l’Institut Géographique National (IGN) et l’agence nationale de la cohésion des territoires (ANCT). Elle est également mise à jour et implémentée grâce aux organismes partenaires (acteurs publics locaux) à travers la création d’une Base d’Adresse Locale (BAL) dans un format standardisé qui vient alimenter la BAN.
Elle est diffusée avec une licence ouverte Etalab à l’adresse suivante : https://adresse.data.gouv.fr/donnees-nationales
La périodicité de la mise à jour de la BAN est quotidienne.
La couverture des données comprend la France entière (y compris les collectivités d’outremer). Les informations disponibles dans la BAN sont organisées sous forme de deux fichiers (adresses et lieux-dits) par département.
Le format de données est de type csv, séparateur “;” et l’encodage UTF-8.
Manipulation de la BAN avec floodam.data
floodam.data permet de gérer la maintenance d’une base de donnée locale, adaptée. Les fonctions clés utilisées sont :
- download_ban pour télécharger la base de donnée distante
- adapt_ban pour adapter la base de donnée aux besoins, en
- appliquant un schéma de données
- alert_ban pour :
- analyser si une version de la ban adaptée est différente d’une autre
- si c’est le cas alerter l’équipe sur Mattermost
- supprimer la plus ancienne des versions
Téléchargement de la base de données BAN
Pour cette tâche, floodam.data se sert de la
fonction download_ban().
Il y a 1 source possible pour le téléchargement de la base de données :
La dernière source est un miroir de la première.
La fonction download_ban() La fonction permet de
télécharger la base de données, en premier lieu, à partir de la première
adresse. Des sources alternatives peuvent être utilisées en fournissant
des paramètres additionnels (voir aide de la fonction : http://www.floodam.org/floodam.data/reference/download_ban.html).
library(floodam.data)
destination = file.path("ban", "download")
download_ban(destination)Traitement de la base de données BAN
Pour cette tâche, floodam.data utilise la fonction
adapt_ban().
Une fois telechargée, la base de données peut être traitée avec la
fonction adapt_ban(). Cette fonction effectue plusieures
transformations sur la base de données originale :
- Le système de référence des coordonnées (CRS) est vérifié. Si aucun
n’est présent, le CRS EPSG:4326 est défini par défaut.
Si un autre CRS est fourni par le paramètre
projection, la base de données est reprojetée pour correspondre au CRS fourni. - Les géométries sont vérifiées et rendues valides si nécessaire.
- Un schéma pré-configuré (
floodam.data::scheme_ban) est appliqué à la base de données afin de consolider les noms et types de variables. - La sortie est sauvegardée comme fichier rds dans le dossier
fourni dans le paramètre
destination.
Schéma appliqué aux données
Le schéma appliqué aux données est détaillé dans le tableau suivant :
| name | name_origin | order | keep | type | label_fr | source | length_source | type_source | comment |
|---|---|---|---|---|---|---|---|---|---|
| id | id | 1 | TRUE | character | Identifiant | data.gouv.fr | NA | character | Clé d’interopérabilité telle que définie dans la spécification du format d’échange BAL 1.3. Lorsqu’aucun code FANTOIR n’est connu, un code transitoire composé de 6 caractères alpha-numériques est généré. |
| id_fantoir | id_fantoir | 2 | FALSE | character | identifiant FANTOIR | data.gouv.fr | NA | character | Identifiant FANTOIR de la voie, le cas échant. L’identifiant est préfixé par la commune de rattachement FANTOIR (commune actuelle ou commune ancienne) |
| address_number | numero | 3 | TRUE | integer | Numéro dans la voie | data.gouv.fr | NA | integer | Numéro de l’adresse dans la voie |
| address_rep | rep | 4 | TRUE | factor | Indice de répétition | data.gouv.fr | NA | character | Indice de répétition associé au numéro (par exemple bis, a…) |
| address_street | nom_voie | 5 | TRUE | character | Nom de la voie | data.gouv.fr | NA | character | Nom de la voie en minuscules accentuées |
| address_code | code_postal | 6 | TRUE | character | Code postal | data.gouv.fr | NA | character | Code postal du bureau de distribution de la voie |
| commune | code_insee | 7 | TRUE | character | Code INSEE | data.gouv.fr | NA | character | Code INSEE de la commune actuelle sur la base du Code Officiel géographique en vigueur |
| commune_name | nom_commune | 8 | FALSE | character | Nom officiel de la commune | data.gouv.fr | NA | character | Nom officiel de la commune actuelle |
| commune_old | code_insee_ancienne_commune | 9 | FALSE | character | Code INSEE de l’ancienne commune | data.gouv.fr | NA | character | Code INSEE de l’ancienne commune sur laquelle est située l’adresse |
| commune_old_name | nom_ancienne_commune | 10 | FALSE | character | Nom de l’ancienne commune | data.gouv.fr | NA | character | Nom de l’ancienne commune sur laquelle est située l’adresse |
| x | x | 11 | FALSE | numeric | Abscisse en projection légale | data.gouv.fr | NA | numeric | Coordonnées cartographique en projection légale |
| y | y | 12 | FALSE | numeric | Ordonnée en projection légale | data.gouv.fr | NA | numeric | Coordonnées cartographique en projection légale |
| lon | lon | 13 | TRUE | numeric | Longitude en WGS-84 | data.gouv.fr | NA | numeric | Longitude en WGS-84 |
| lat | lat | 14 | TRUE | numeric | Latitude en WGS-84 | data.gouv.fr | NA | numeric | Latitude en WGS-84 |
| position_type | type_position | 15 | TRUE | factor | Type de position | data.gouv.fr | NA | factor | Type de position telle que définie dans la spécification du format d’échange BAL 1.3. Peut-être vide si inconnu ou non renseigné. |
| alias | alias | 16 | FALSE | logical | Vide | data.gouv.fr | NA | logical | Vide |
| locality_name | nom_ld | 17 | TRUE | character | Nom du lieu-dit de rattachement | data.gouv.fr | NA | character | Nom du lieu-dit de rattachement (ou autre type de toponyme) |
| commune_name_postal | libelle_acheminement | 18 | FALSE | character | Nom de la commune d’acheminement | data.gouv.fr | NA | character | Nom de la commune d’acheminement |
| address_street_postal | nom_afnor | 19 | FALSE | character | Nom postale de la voie | data.gouv.fr | NA | character | Nom de la voie normalisé selon la norme postale |
| position_source | source_position | 20 | TRUE | factor | Source de la position géographique | data.gouv.fr | NA | factor | Source de la position géographique. Valeurs possibles : (commune, cadastre, arcep, laposte, insee, sdis, inconnue) |
| address_source | source_nom_voie | 21 | FALSE | factor | Source du nom de la voie | data.gouv.fr | NA | factor | Source du nom de la voie. Valeurs possibles : (commune, cadastre, arcep, laposte, insee, sdis, inconnue) |
| commune_certification | certification_commune | 22 | TRUE | logical | Certification par la commune | data.gouv.fr | NA | integer | Indique si l’adresse a été certifiée par la commune. Valeurs possibles : (1 pour oui, 0 pour non) |
| registry_parcel | cad_parcelles | 23 | FALSE | character | Parcelles cadastrales | data.gouv.fr | NA | character | Liste les identifiants des parcelles cadastrales auxquelles l’adresse est rattachée, si l’information est connue. Codage de l’identifiant sur 14 caractères. Séparateur |. Donnée en cours de fiabilisation |