Formats de données proposés
N° 12
Format CSV de DV3F
📦 Une version simplifiée de DV3F
Depuis 2025, la base DV3F est proposée, sous une forme allégée, au format CSV.
⚠️ Ce format ne restitue que la table des mutations (1 ligne = 1 transaction) avec les informations principales issues de cette table.
🧰 Type d'utilisation
Ce format est particulièrement adapté à des usages simples ou exploratoires :
- Analyse sous tableur (Excel, LibreOffice)
- Analyse légère en Python, R
- Import simple dans une base de données
- Relecture manuelle ou contrôle qualité ponctuel
✅ Avantages
- Facile à ouvrir et manipuler : un simple tableur suffit
- Universel : lisible sur tous les systèmes d’exploitation
- Léger : idéal pour les périmètres ou périodes réduites
❌ Limites
- Pas de support natif pour les géométries (pas de fichiers SIG ou coordonnées exploitables directement)
- Typage implicite : attention aux erreurs lors de l’ouverture (dates, identifiants textuels avec des zéros en tête, etc.)
- Données partielles : seule la table des mutations est incluse ; pour bénéficier de la richesse relationnelle de DV3F, privilégier le format SQL
📥 Comment récupérer les données ?
- 🔗 Rendez-vous sur le Portail Données foncières
- 🧭 Nouveau sur le portail ? Suivez le parcours guidé pour créer un compte "bénéficiaire"
- 👤 Déjà inscrit ? Connectez-vous à votre espace
- 📄 Faites une demande de téléchargement
- Cliquez sur le bouton "Télécharger une donnée"
- 📝 Remplissez le formulaire
- Indiquez la donnée souhaitée (DV3F simplifiée)
- Précisez le format CSV et le périmètre géographique
- Une invitation Box.com vous parviendra sous 24 à 48h
- 📦 Téléchargez l'archive
- Connectez-vous à l’espace sécurisé pour récupérer le fichier compressé (.zip ou .7z)
📁 Description des fichiers obtenus
Selon le volume de données demandé, vous recevrez :
- Un fichier unique :
MUTATION_AAAA_V_CSV_NNNN_EDAA1.zip(pour des jeux de données de taille modérée) - Plusieurs fichiers découpés (taille < 800 Mo) :
MUTATION_AAAA_V_CSV_NNNN_EDAA1_part.7z.001,.002, etc.
Une fois l’archive décompressée (voir Etape 1 ci-après), vous obtenez trois dossiers :
🔹 1_DONNEES_LIVRAISON → contient le ou les fichiers de données mutation.csv
🔹 4_METADONNEES_LIVRAISON → contient le fichier de métadonnées et les documents juridiques (acte d'engagement, CGU)
🔹 5_SUPPLEMENTS_LIVRAISON → généralement vide (réservé à des compléments éventuels)
🛠️ Comment utiliser les données ?
🗂 Étape 1 – Décompresser l’archive
Utilisez un outil de décompression adapté :
- Pour les
.zip: extraire les données à partir d'un outil natif (Windows, macOS, Linux) - Pour les
.7z: extraire les données à partir d'outils libres comme 7-Zip ou PeaZip → voir tutoriel 7-zip
⚠️ Pour les fichiers découpés (.7z.001), commencez toujours la décompression à partir du fichier numéro 1 en s'assurant que tous les fichiers numérotées sont présents dans le même dossier.
📑 Étape 2 – Ouvrir et exploiter le fichier CSV
👉 Option 1 : sous tableur
- Ouvrez le fichier
mutation.csvdans LibreOffice Calc, Excel ou un éditeur de texte type Notepad++ - ⚠️ Activez l'importation avec le séparateur
|(touche AltGr + 6 du clavier) - Vérifiez que les colonnes de type texte ne perdent pas leurs zéros en tête (par ex. identifiants)
Un tutoriel pour ouvrir les fichiers csv est disponible sur guides.data.gouv.fr
👉 Option 2 : en Python ou R
- Utilisez
pandas.read_csv()(Python) oureadr::read_csv2()(R) avec :
- l'encodage
UTF-8- le séparateur
|- une lecture prudente des types de colonnes (
dtypeen Python)
Description du fichier csv
Le fichier csv correspond aux données de la table mutation de DV3F, qui permet de faire une large partie des analyses sur les marchés fonciers ou immobiliers.
Dans ce fichier, chaque ligne correspond aux informations liées à une transaction. Les colonnes proposées sont une sélection des principales variables de cette table dont les descriptions détaillées sont accessibles à partir du dictionnaire de la table
Pour plus de détails sur l'utilisation de la table mutation, n'hésitez pas à consulter le guide DV3F.
Récapitulatif des colonnes proposées dans le csv
| Nom | Description |
|---|---|
| idmutation | identifiant de clef primaire de la table mutation |
| idmutinvar | identifiant invariant de la mutation |
| datemut | date de signature du document (acte de vente) |
| anneemut | annee de signature du document |
| libnatmut | libellé de la nature de mutation |
| vefa | vrai si la mutation est une Vente en l'état futur d'achèvement (VEFA) |
| valeurfonc | prix ou évaluation déclarée dans le cadre d'une mutation onéreuse |
| nbcomm | nombre de communes concernées par la mutation |
| l_codinsee | liste des codes INSEE des communes concernées par la mutation |
| nbpar | nombre de parcelles concernées par la mutation |
| l_idpar | liste des identifiants de parcelles concernées par la mutation (idpar) |
| nbparmut | nombre de parcelles ayant muté |
| l_idparmut | liste des identifiants de parcelles ayant muté (idpar) |
| sterr | surface de terrain ayant muté |
| nbvolmut | nombre de volumes ayant muté |
| nblocmut | nombre de locaux ayant muté |
| nblocmai | nombre de maisons ayant muté |
| nblocapt | nombre d'appartements ayant muté |
| nblocact | nombre de locaux d'activité ayant muté |
| nblocdep | nombre de dépendances ayant muté |
| l_idlocmut | liste des identifiants de locaux ayant muté (idloc) |
| sbati | surface de l'ensemble du bâti ayant muté |
| sbatmai | surface de l'ensemble des maisons ayant muté |
| sbatapt | surface de l'ensemble des appartements ayant muté |
| l_nomv | noms des vendeurs (anonymisés pour les personnes physiques) |
| codtypprov | code de typologie de propriétaire pour les vendeurs (typologie Cerema) |
| l_noma | noms des acheteurs (anonymisés pour les personnes physiques) |
| codtypproa | code de typologie de propriétaire pour les acheteurs (typologie Cerema) |
| fftypact | catégorie d'activité dominante des locaux professionnels |
| ffnbloch | nombre de locaux habitées |
| ffnblogsoc | nombre de logements sociaux (repérés par exonération) |
| nblocanc | nombre de locaux anciens (année construction >= 5 ans) |
| nblocrecen | nombre de locaux récents (1< année construction < 5 ans) |
| nblocneuf | nombre de locaux neufs (<= 1 an) |
| periodecst | période de construction dominante des locaux ayant muté |
| codtypbien | code de la typologie des biens du GnDVF |
| libtypbien | libellé de la typologie des biens du GnDVF |
| filtre | code alphanumerique permettant d'exclure des mutations particulières pour l'analyse |
| devenir | indicateur de changement de typologie ou d'usage des biens vendus après la vente |
| segmtab | indicateur du segment des terrains à bâtir |
| geompar_x | coordonnée X d'un centroide des parcelles concernées par la mutation |
| geompar_y | coordonnée Y d'un centroide des parcelles concernées par la mutation |
ℹ️ Besoin d’aide ?
Pour toute difficulté, vous pouvez contacter l’équipe Datafoncier
