25 janvier 2024
Nous sommes ravis de vous annoncer l'API BDNB , la manière la plus simple d’accéder aux données de la Base de Données Nationale des Bâtiments.
L’API BDNB s’adresse à tous les acteurs qui souhaitent accéder rapidement et facilement aux données bâtiments pour leurs études, les intégrer dans leur système d’information ou dans leurs applications. L’API BDNB est une évolution de l'API gorénove qui passe désormais en dépréciation .
Un accès simplifié, enrichi et aligné avec le nouveau modèle de données BDNB
L’API BDNB offre un accès sans précédent à un vaste ensemble de données géospatiales, constamment à jour, enrichi et amélioré.
Avec l’API BDNB, vous bénéficiez de :
-
⌚ Une mise à jour automatique : Accédez toujours à la dernière version de la BDNB, avec la simplicité d’un appel API
-
🚀 Une performance optimale : Profitez d’une API à la fois riche et performante, basée sur le schéma de données de la BDNB.
-
🧘 Une flexibilité inégalée : Interrogez les données bâtiment de multiples manières – par adresse, identifiants spécifiques (parcelles, immatriculation de copropriété, numéro de DPE…) ou via des requêtes géospatiales.
-
📘Une documentation revue et améliorée
Des offres personnalisées pour chaque besoin
-
API BDNB Open : Accès immédiat aux données open data, ouvert et gratuit, idéal pour les premiers pas
-
API BDNB Open+ : Pour ceux qui ont des exigences plus élevées en termes de volume, de support et de garantie de service
-
API BDNB Expert : Accédez aux données open complétées par des indicateurs expert calculés par le CSTB (prédictions DPE, valeur foncière verte, synthèses d’indicateurs consolidée…), réalisez des calculs de statistiques avancés, et bien plus avec un support prioritaire et des quotas encore plus élevés.
-
API BDNB ayant droit : Réservée aux acteurs publics ayants-droits (fichiers fonciers, dvf, etc. ), cette formule constitue une version augmentée de l'API BDNB Expert
Liste de routes de l’API
| Usage | Disponibilité | Route | Open | Open+ | Expert |
|---|---|---|---|---|---|
| Géocodage des adresses | Disponible | GET /v1/bdnb/geocodage |
✅ | ✅ | ✅ |
| Auto-complétion des noms de lieux ou de propriétaires | Disponible | GET /v1/bdnb/autocompletion |
❌ | ❌ | ✅ |
| Statistiques | Disponible | GET /v1/bdnb/stats/batiment_groupe |
❌ | ❌ | ✅ +contenu expert |
| Données agrégées par groupes de bâtiments | Disponible | GET /v1/bdnb/donnees/batiment_groupe_complet |
✅ | ✅ | ✅ +contenu expert |
| Sélection clé d’intéropérabilité d’adresse BAN | Disponible | GET /v1/bdnb/donnees/batiment_groupe_complet/adresse |
✅ | ✅ | ✅ +contenu expert |
| Sélection identifiant de parcelle cadastrale | Disponible | GET /v1/bdnb/donnees/batiment_groupe_complet/parcelle |
✅ | ✅ | ✅ +contenu expert |
| Sélection par code Siren des propriétaire | Disponible | GET /v1/bdnb/donnees/batiment_groupe_complet/proprietaire |
❌ | ❌ | ✅ +contenu expert |
| Sélection par identifiant RNB | Q1 2024 | GET /v1/bdnb/donnees/batiment_groupe_complet/rnb |
✅ | ✅ | ✅ +contenu expert |
| Sélection spatiale par boîte englobante (bbox) | Disponible | GET /v1/bdnb/donnees/batiment_groupe_complet/bbox |
✅ | ✅ | ✅ +contenu expert |
| Sélection spatiale par polygone | Disponible | GET /v1/bdnb/donnees/batiment_groupe_complet/polygon |
❌ | ❌ | ✅ +contenu expert |
| Données des tables BDNB | Disponible | GET /v1/bdnb/donnees/{table_bdnb} |
✅ | ✅ | ✅ +contenu expert |
| Tuiles vectorielles MVT : Bâtiments 2D extrudée | Disponible | GET /v1/bdnb/tuiles/batiment_groupe/{zoom}/{x}/{y}.pbf |
✅ | ✅ | ✅ +contenu expert |
| Tuiles vectorielles MVT : Contours des iris | Disponible | GET /v1/bdnb/tuiles/iris/{zoom}/{x}/{y}.pbf |
✅ | ✅ | ✅ |
| Tuiles vectorielles MVT : Contours des Communes | Disponible | GET /v1/bdnb/tuiles/commune/{zoom}/{x}/{y}.pbf |
✅ | ✅ | ✅ |
| Tuiles vectorielles MVT : Contours des EPCI | Disponible | GET /v1/bdnb/tuiles/epci/{zoom}/{x}/{y}.pbf |
✅ | ✅ | ✅ |
| Tuiles vectorielles MVT : Contours des départements | Disponible | GET /v1/bdnb/tuiles/departement/{zoom}/{x}/{y}.pbf |
✅ | ✅ | ✅ |
| Tuiles vectorielles MVT : Contours des Régions | Disponible | GET /v1/bdnb/tuiles/region/{zoom}/{x}/{y}.pbf |
✅ | ✅ | ✅ |
| Information sur les données (nom de colonnes, sources…) | Disponible | GET /v1/bdnb/metadonnees/ |
✅ | ✅ | ✅ |
Nouveautés :
Contenus :
- Les tables de la BDNB. Changelog du dernier millésime (
/v1/bdnb/donnees/<table>) - Des routes regroupant les principales informations métier (
/v1/bdnb/donnees/batiment_groupe_complet, 100+ colonnes en Open, 170+ en Expert) - Le référentiel administratif et ses contours (région, départements, EPCI, commune, iris, quartier prioritaires…), synchronisé avec les données BDNB (
/v1/bdnb/donnees/referentiel_administratif_region…) - Tuiles vectorielles pour les contenus Open et Expert pour la visualisation dans des clients cartographiques performants
/v1/bdnb/tuiles/batiment_groupe,/v1/bdnb/tuiles/iris… - Table de filiation d’identifiants BDNB <2022 vers BDNB 2023* (en version expert)
Fonctionnalités :
-
API de calculs de statistiques par zone géographique et par propriétaire avec filtres avancés
/v1/bdnb/stats(API BDNB Expert) -
API d’auto-complétion des noms de lieux et de propriétaires personne morales
/v1/bdnb/autocompletion. Améliorez votre expérience utilisateur avec notre API d’auto-complétion. Obtenez des codes prêts à l’emploi dans l’API : code siren, code commune, code iris… (API BDNB Expert) :
-
Requêtes géospatiales par polygone et boite englobante (bbox)
/v1/bdnb/donnees/batiment_groupe_complet/bbox -
Requêtes géospatiales par polygone (API BDNB Expert)
/v1/bdnb/donnees/batiment_groupe_complet/polygon -
Formats de sortie JSON, GeoJSON ou CSV
Documentation :
-
Métadonnées sur l’ensemble des colonnes et des tables disponibles, facilement explorables : source des données, millésimes, description… (
/v1/bdnb/metadonnees) -
Tutoriels :
-
Guides :
- Comment accéder aux données bâtiments à partir d'adresses
- Comment accéder aux données bâtiments à partir d'identifiants
- Comment migrer de l'API gorenove vers l'API BDNB (souscriptions, correspondance des nom de colonnes…)
- Comment souscrire à une API : création d’application, demande d’abonnement, utilisation de vos clés d’API, logs, dashboard de suivi de consommation…
-
Références :
- Page de statut de l'API : https://status.bdnb.io
- Spécifications OpenAPI pour les API BDNB Open, Open+ et Api BDNB Expert comprenant la description exhaustive des paramètres et des schéma de données des colonnes exposées.
- Le schéma de données interactifs de la BDNB
- Conditions Générales d'Utilisation et garantie de service (SLA)
Améliorations:
- Amélioration du croisement géospatial et des dernières avancées du millésime 2023_01a
- Amélioration de la performance de la recherche de bâtiments par code adresse
Mise à jour :
- Mise à jour vers le millésime 2023_01a de la BDNB
- Mise à jour du géocodeur BAN, synchronisé avec le dernier millésime BDNB pour un meilleur taux de réponse.
- Mise à jour des quotas, rate limit et nombre d'objets retournée par niveau de souscription (lien vers le tableau des offres).
Dépréciation :
L’API Gorénove entre en phase de dépréciation :
-
Aucun nouvel abonnement n’est désormais possible.
-
Les abonnements existants seront transférés et bénéficieront d’un support dédié pour la migration.
-
L’API restera active jusqu’au 30 juin 2024 mais ne recevra plus de mises à jour BDNB (elle reste sur le millésime précédant).
-
Consultez notre guide détaillé pour migrer facilement vers l’API BDNB.
Bientôt disponible (1er trimestre 2024):
- Intégration du Référentiel National des Bâtiments (RNB)
Nous vous encourageons à explorer ces nouvelles fonctionnalités et améliorations. Vos retours sont précieux pour nous, n’hésitez pas à partager vos expériences et suggestions.
Pour toute demande d’informations sur nos offres d’API avancées, de fourniture de données, d’études sur mesure ou de soutien technique: