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 :
open | open+ | expert | |
---|---|---|---|
Quota (hit/month/ip) | 100k | 1M | 1M |
Nombre maximum d’objets retournés par requête | 100 | 1000 | 1000 |
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.