Le 28 juil. 2023

En attendant l’API BDNB en fin d’année, l’API gorenove évolue. La version 2.9 de l’API Gorenove est disponible avec les nouveautés suivantes:

Features

  • 🌍 Ajout de la route /buildings/bbox pour les requêtes spatiales par bounding box.
  • 🌍 Ajout du géojson en format de sortie avec le header accept: application/geo+json

Mise à jour des Conditions Générales d’Utilisation (CGU)

  • 📈 CGU : Augmentation de la limite du nombre d’objets retournés pour une seule requête :
openopen+expert
Quota (hit/month/ip)100k1M1M
Nombre maximum d’objets retournés par requête10010001000

Exemple d’utilisation

Une illustration des nouvelles fonctionnalités en une requête :

  • Retrouve les bâtiments dans un rectangle défini par xmin,xmax,ymin,ymax
  • Formate le résultat sous forme de geojson (nécessite une colonne géométrique)

En combinaison avec les mécanismes de filtres habituels :

  • sélectionne les bâtiments de plus de 10m de hauteur
  • sélectionne les colonnes à retourner dans les properties :bnb_id, hauteur, adresse_postal, l_ban_id, geombui

En python :

import requests
r = requests.get('https://api.bdnb.io/v2/gorenove/buildings/bbox', 
                     params={'xmin': 850236.1,
                             'ymin': 6695053.8,
                             'xmax': 850768.4,
                             'ymax': 6695291.2,
                             'limit':5 ,
                             'hauteur': 'gt.10' ,
                             'select': 'bnb_id, hauteur, adresse_postal, l_ban_id, geombui'
                            },
                  headers= {'Accept': 'application/geo+json',
                           # headers={"X-Gravitee-Api-Key":<my_api_key>}, Pour les abonnés open+ et expert
                           })
r.json()

Pourquoi une API gorenove ?

Le schéma de la BDNB se stabilise avec le temps bien qu’il évolue encore régulièrement. Actuellement en version 0.7.4, les renommages de tables et de colonnes peuvent encore se produire. Nous anticipons également des modifications de schéma pour s’aligner avec le modèle du futur référentiel bâtiments (RNB) actuellement en cours de discussion dans le groupe de travail BatID du Comité National de l’Information Géographique (CNIG). Animé par la start up d’état Bat-ID (soutenu par l’IGN, l’ADEME et le CSTB), ces travaux visent à aboutir à un schéma de données partagé https://github.com/fab-geocommuns/BatID.

En attendant ces évolutions, les applications ont besoin de stabilité. C’est pourquoi l’API exposée via notre portail est pour le moment aligné sur le modèle de données utilisé pour le développement des applications Gorenove. Le modèle de données des applications est désormais un peu ancien, mais reste stable.

Nous préparons en ce moment la bascule vers le modèle de données de la BDNB et nous vous donnons rendez-vous à la fin de l’année pour une release au grand public.

À propos

La Base de Donnée Nationale des Bâtiments a été mise en place par le Centre Scientifique Technique des Bâtiments (CSTB) afin de proposer le meilleur socle de données possible à l’ensemble des acteurs intéressés.


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:

Contactez-nous