Documentation d’utilisation

1. Vue d’ensemble

L’outil affiche sur une carte de France les diagnostics de performance énergétique (DPE) des logements existants, issus du jeu de données open data de l’ADEME (DPE Logements existants (depuis juillet 2021)).

À chaque déplacement ou zoom de la carte, une requête est envoyée à l’API ADEME pour charger les DPE correspondant à la zone visible et aux filtres actifs.

2. Filtres et navigation sur la carte

• Déplacement / zoom : utilisez la souris ou les contrôles Leaflet pour changer de zone ou de niveau de zoom. Les points se rechargent automatiquement.
• Classes DPE : cliquez sur les pastilles A à G pour inclure / exclure certaines classes de performance énergétique.
• Période des DPE : sélectionnez « tous », dernier mois, 3/6 mois, 1 an ou 2 ans. Le filtre est appliqué sur la date d’établissement du DPE.
• Type de bâtiment : maison, appartement, immeuble (sélection multiple via les pastilles).
• Énergie principale chauffage : filtre optionnel (Gaz naturel, Électricité, réseau de chaleur, etc.).

Le compteur en bas du bloc « Données chargées depuis l’API ADEME » indique le nombre de biens réellement renvoyés pour la vue et les filtres courants.

3. Détail d’un bien

• Clic sur un point : ouvre un popup avec l’adresse, le type de bâtiment, la surface et les classes DPE / GES.
• Bouton « Détails complets du DPE » : ouvre un panneau latéral listant l’intégralité des champs renvoyés par l’ADEME pour ce diagnostic.
• Prix moyen au m² (secteur commune) : lorsque des données DVF (Demandes de valeurs foncières) sont disponibles pour la commune du bien, la fiche affiche le prix médian au m² dans ce secteur. Les données proviennent d’un cache local (var/prix_m2_commune.json) alimenté à partir des fichiers DVF officiels (data.gouv.fr). Voir ci-dessous pour alimenter le cache.
• Bouton « Exporter ce DPE (Excel) » (utilisateur connecté uniquement) : déclenche le téléchargement d’un fichier CSV compatible Excel contenant tous les champs du DPE (une ligne par champ).

4. Recherche par numéro de DPE

Le lien « Rechercher un DPE par numéro » ouvre une fenêtre modale contenant un formulaire de recherche sur le champ numero_dpe.

• Saisissez le numéro complet de DPE (ex. 2611E0031228S).
• La page affiche un résumé (adresse, classes, type de bâtiment, surface, date), une mini-carte localisant le bien, puis un tableau de tous les champs techniques.

5. Comptes utilisateurs et droits

• Création de compte : via la page « Créer un compte ». Le tout premier compte créé devient automatiquement administrateur.
• Connexion / déconnexion : via les liens en haut à gauche de la carte.
• Fonctionnalités réservées aux utilisateurs connectés :
  • sauvegarde de vues (« requêtes ») dans le dashboard ;
  • export Excel d’un DPE ;
  • suivi des nouveaux biens par requête (halo bleu) et bouton « marquer les biens actuels comme analysés ».

6. Dashboard et requêtes sauvegardées

• Depuis la carte, cliquez sur « Sauvegarder cette vue dans mon dashboard » pour enregistrer :
  • la position de la carte (centre / zoom) ;
  • les filtres actifs (classes, période, type de bâtiment, énergie).
• Dans le dashboard :
  • liste de vos requêtes sauvegardées (nom, description, extrait des paramètres) ;
  • lien « Ouvrir sur la carte » pour revenir exactement sur la même vue et les mêmes filtres ;
  • bouton « Supprimer » pour retirer une requête.
• Suivi des nouveaux biens :
  • les biens déjà vus pour une requête ne sont pas surlignés ;
  • les nouveaux biens apparaissent avec un halo bleu autour du point ;
  • le bouton « Marquer les biens actuels comme analysés » enregistre l’état courant : tous les DPE visibles pour cette requête sont considérés comme vus, et leurs halos bleus disparaîtront lors des prochaines consultations.

7. Prix au m² dans le secteur (commune)

La fiche de chaque bien peut afficher le prix médian au m² dans sa commune, calculé à partir des données DVF (Demandes de valeurs foncières), base officielle des transactions immobilières (data.gouv.fr).

• Les données sont lues depuis un fichier cache var/prix_m2_commune.json.
• Pour alimenter ce cache à partir des fichiers DVF officiels :
  • exécutez le script : php scripts/download-dvf-build-prix-m2.php [annee] [dep1] [dep2] ... ;
  • le script télécharge les CSV DVF (géolocalisés) depuis files.data.gouv.fr/geo-dvf/, par département ;
  • sans argument : année 2024 et tous les départements (01 à 95, 2A, 2B) ;
  • exemple pour quelques départements : php scripts/download-dvf-build-prix-m2.php 2024 18 36 37 (Cher, Indre, Indre-et-Loire).
• Le script calcule pour chaque commune le prix médian au m² à partir des champs valeur_fonciere et surface_reelle_bati des mutations DVF, puis enregistre le résultat dans var/prix_m2_commune.json.

8. Limitations et remarques

• Les données proviennent en direct de l’API ADEME et reflètent les DPE transmis par les diagnostiqueurs ; elles peuvent contenir des incohérences.
• Le prix au m² affiché est une moyenne communale (source DVF), indicative du secteur, et non une estimation du bien lui-même.
• Pour les très grandes zones ou un grand nombre de résultats, l’API peut mettre du temps à répondre : un message « Erreur de chargement » peut alors apparaître.
• Les exports Excel sont générés à la demande, un fichier par bien.