Release 2.9 de l'API gorenove

28 juillet 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 :
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.