Skip to contents

Description 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 :

  1. 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.
  2. Les géométries sont vérifiées et rendues valides si nécessaire.
  3. 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.
  4. 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 :

Schéma appliqué à la base de donnée BAN
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

Analyse de la base de données BAN

Pour cette tâche, floodam.data se sert de la fonction analyse_ban().

→ A fournir une fois que la fonction sera finie