Comment obtenir des informations bâtiments à partir d’une adresse

Ce guide explique la manière d’obtenir des données bâtiments à partir d’une adresse textuelle. Il est réalisable sur l’API BDNB sans souscription. Il couvre les aspects suivants :

  • géocodage de l’adresse
  • utilisation de cle_interop_adr pour obtenir des données.

Géocodage : Récupération de la clé d’intéropérabilité de la BAN cle_interop_adr

✎ Le géocodage consiste à identifier un point géographique à partir d’une adresse.

Récupération de l’identifiant adresse

Pour identifier l’adresse, passez par l’API de géocodage /v1/bnb/geocodage:

import requests
requests.get('https://api.bdnb.io/v1/bdnb/geocodage?',
             params={'q': '12 rue Charrel Grenoble'})
<Response [200]>

Le géocodeur retourne une réponse de type :

{'type': 'FeatureCollection',
 'version': 'draft',
 'features': [{'type': 'Feature',
   'geometry': {'type': 'Point', 'coordinates': [5.71488, 45.182411]},
   'properties': {'label': '12 Rue Charrel 38000 Grenoble',
    'score': 0.9752809090909089,
    'housenumber': '12',
    'id': '38185_1530_00012',
    'name': '12 Rue Charrel',
    'postcode': '38000',
    'citycode': '38185',
    'x': 913192.3,
    'y': 6457343.3,
    'city': 'Grenoble',
    'context': '38, Isère, Auvergne-Rhône-Alpes',
    'type': 'housenumber',
    'importance': 0.72809,
    'street': 'Rue Charrel'}}],
 'attribution': 'BAN',
 'licence': 'ETALAB-2.0',
 'query': '12 rue charrel grenoble',
 'limit': 5}

Ici la réponse indique que la recherche a retourné un résultat pour un numéro de rue précis ('type':'housenumber') et que le résultat est jugé très fiable ('score': 0.975).

Les résultats de type street (à la rue) et city (dans la ville) ne suffisent pas à identifier un bâtiment directement.

Si le résultat est de type housenumber, les 2 informations importantes dans le retour API sont :

  • la clef d’interopérabilité avec la base d’adresse nationale, ici 'id': '38185_1530_00012'
  • les coordonnées géographiques du point adresse ('coordinates':[lon,lat] exprimé en WSG84 / EPSG:4326, ou 'x' et 'y' exprimés dans le référentiel lambert-93 / EPSG:2154)

Sélection du ou des groupes de bâtiments qui contiennent cette adresse

Une fois muni de la clef d’interopérabilité (dans l’exemple précédant, la réponse 'id': '38185_1530_00012') nous pouvons intérroger l’API BDNB pour retrouver tous les groupes de bâtiments qui sont liés à cette adresse.

⚠️ Est-il toujours possible de retrouver des données bâtiments à partir d’une adresse ?

Non, pas toujours. Une adresse, même correctement identifiée, ne constitue pas un identifiant robuste pour sélectionner un bâtiment :

  • Un bâtiment peut avoir plusieurs adresses
  • Une adresse peut correspondre à plusieurs bâtiments
  • Certaines adresses peuvent ne pas correspondre à un bâtiment
  • Certains bâtiments peuvent ne pas avoir d’adresse
  • L’adresse d’un bâtiment peut ne pas exister dans la base d’adresse nationale.

L’API peut donc retourner 0, 1 ou plusieurs résultats à partir d’une adresse En fonction de votre cas d’usage, gardez en tête que l’appariement peut être problématique et des solutions de mitigations doivent être proposés à vos utilisateurs.

import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/batiment_groupe_complet/adresse',
                     params={'limit': 5,  # limite le nombre de réponses à 5 résultats
                             'cle_interop_adr': 'eq.38185_1530_00012'})
[{'code_departement_insee': '38',
  'code_commune_insee': '38185',
  'code_iris': '381850111',
  'libelle_commune_insee': 'Grenoble',
  'batiment_groupe_id': '38185000HY0083_37ffec3e7aeb842',
  'libelle_adr_principale_ban': '8 rue irvoy, 38000, Grenoble',
  'nb_adresse_valid_ban': 4,
  'cle_interop_adr_principale_ban': '38185_3670_00008',
  'geom_groupe': {'type': 'MultiPolygon',
   'coordinates': [[[[913152.6, 6457362.8],
      [913149.1, 6457349.9],
      [913158, 6457347.5],
      [913158.9, 6457350.4],
      [913228.9, 6457331.2],
      [913231.7, 6457341.4],
      [913152.6, 6457362.8]]]]},
  'hauteur_mean': 25,
  'altitude_sol_mean': 216,
  'alea_argiles': 'Faible',
  'alea_radon': 'Faible',
  'nb_log': 73,
  'nb_log_rnc': 73.0,
  'nb_lot_garpark_rnc': 110.0,
  'nb_lot_tertiaire_rnc': 0.0,
  'numero_immat_principal': 'AA2308963',
  'distance_batiment_historique_plus_proche': 192,
  'nom_batiment_historique_plus_proche': 'Eglise Saint-André',
  'fiabilite_cr_adr_niv_2': 'batiment sur parcelle unifiee avec adresses non-exclusives',
  'fiabilite_cr_adr_niv_1': "données croisées à l'adresse moyennement fiables",
  'fiabilite_emprise_sol': 'BONNE',
  'fiabilite_hauteur': 'BONNE',
  'croisement_geospx_reussi': True,
  'cle_interop_adr': '38185_1530_00012',
  'lien_valide': True,
  'geom_bat_adresse': {'type': 'LineString',
   'coordinates': [[913189.7703464259, 6457347.119185508],
    [913192.2957350374, 6457343.29879159]]}
  [...]
  }
]

💡 Astuce

La route batiment_groupe_complet agrège l’ensemble des informations, soit plus de 100 colonnes en open data (plus encore en expert). Pour aller plus vite, pensez à ne sélectionner que les colonnes qui vous intéressent.

import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/batiment_groupe_complet/adresse',
                     params={'limit': '5',  # limit le nombre de réponses à 5 
                             'select': 'batiment_groupe_id,nb_log, libelle_adr_principale_ban',
                             'cle_interop_adr': 'eq.38185_1530_00012'})
Sans filtre sur les colonnes Avec filtre sur les colonnes
Nombre de charactère dans la réponse 4178 129
Temps d’exécution 3500 ms 370 ms

❔ Pourquoi utiliser batiment_groupe_complet/adresse ?

batiment_groupe_complet contient une ligne par groupe de bâtiments et n’a pas de colonne cle_interop_adr, seulement une colonne l_cle_interop_adr, qui est une liste des adresses pour ce groupe. Exécuter une requête sur une liste n’est pas performant.

batiment_groupe_complet/adresse contient une ligne par combinaison (adresses, groupe de bâtiments), il est possible de faire des requêtes sur la valeur cle_interop_adr de manière plus performante (la colonne est indexée).

Autres recherches à partir de cle_interop_adr

cle_interop_adr est disponible et indexé pour la recherche dans les routes suivantes :

import requests
r = requests.get('https://api.bdnb.io/v1/bdnb/metadonnees', 
                 params={'nom_colonne': 'eq.cle_interop_adr',
                         'select': 'nom_table, nom_colonne, route, type, index, contrainte_acces_table, description_jeu_de_donnees '},
                 )
nom_table nom_colonne route type_sql index contrainte_acces_table description_jeu_de_donnees
0 adresse cle_interop_adr /v1/bdnb/donnees/adresse varchar True open_data_lo Base de Données Nationale des Bâtiments, millésime 2023-01
1 rel_batiment_groupe_adresse cle_interop_adr /v1/bdnb/donnees/rel_batiment_groupe_adresse varchar True open_data_lo Base de Données Nationale des Bâtiments, millésime 2023-01