API ${api.proxy.contextPath} version ${api.version}
L’API BDNB est la manière la plus simple d’accéder aux données à jour du dernier millésime de la BDNB.
Vous avez ainsi accès à un vaste ensemble de données géospatiales, constamment à jour, enrichi et amélioré, ainsi qu’à un ensemble de service pour manipuler plus simplement les données qui vous intéressent.
☝ Cette API prend le relais de l’ancienne API Gorenove, désormais en fin de vie
Avec l’API BDNB, vous pouvez ainsi : - 📍 Géocoder vos adresses vers la clé d’interopérabilité de la BAN (Base d’adresses nationale) - 🔎 Accéder aux données des tables de la BDNB à partir des informations à votre disposition (adresse, parcelle , identifiant bâtiment, sélection géospatiale, etc.) - 📤 Exporter ces données aux formats json, geojson ou csv - 🏠 Afficher les données à différentes échelles : bâtiments, iris, commune, epci, département et région avec nos tuiles vectorielles dans des clients cartographiques de type maplibre.
Vous atteignez fréquemment la limite de requête de l’API ? Où vous souhaitez avoir accès à des données expertes ou disponibles sous convention ? –> Demandez l’accès à nos services d’API enrichies –> Comment souscrire?
Un problème avec l’API ? - 📈 Vérifiez la disponibilité de nos services - 📧 Contactez-nous
Vos retours sont précieux, nous prenons vos retours d’expérience et suggestions avec grand plaisir !
En savoir plus sur l’API
Documentations interactives
Premiers pas avec l’API BDNB
Nos guides pratiques :
Différence entre les API Open, Open+ et Expert
Quota et limites d’usages par souscription :
| open (pas de souscription) | open+ | expert | |
|---|---|---|---|
| Quota (hit/month/ip) | 10k | 1M | 10M |
| Nombre maximum d’objets retournés par requête | 10 | 1000 | 10000 |
| Rate limit | 120 / min | 1200 /min | 1200 /min |
Liste des routes de l’API
| Usage | Disponiblité | Route | Open | Open+ | Expert |
|---|---|---|---|---|---|
| Géocodage des adresses | Disponible | GET /v1/bdnb/geocodage |
✔ | ✔ | ✔ |
| Autocomplé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 groupe de bâtiments | Disponible | GET /v1/bdnb/donnees/batiment_groupe_complet |
✔ | ✔ | ✔ (+contenu expert) |
| Sélection de groupes de bâtiments par clé d’intéropérabilité d’adresse BAN | Disponible | GET /v1/bdnb/donnees/batiment_groupe_complet/adresse |
✔ | ✔ | ✔ (+contenu expert) |
| Sélection de groupes de bâtiments par identifiant de parcelle cadastrale | Disponible | GET /v1/bdnb/donnees/batiment_groupe_complet/parcelle |
✔ | ✔ | ✔ (+contenu expert) |
| Sélection de groupes de bâtiments par code Siren des propriétaire | Q1 2024 | GET /v1/bdnb/donnees/batiment_groupe_complet/proprietaire |
❌ | ❌ | ✔ (+contenu expert) |
| Sélection de groupes de bâtiments par identifiant RNB | Q1 2024 | GET /v1/bdnb/donnees/batiment_groupe_complet/rnb |
✔ | ✔ | ✔ (+contenu expert) |
| Sélection spatiale par boîte englobante (bounding box) | 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 de la BDNB (nom de colonnes, sources, millésime, description…) | Disponible | GET /v1/bdnb/metadonnees/ |
✔ | ✔ | ✔ |