Comment obtenir des informations bâtiments à partir d’identifiants administratifs

Ce guide explique la manière d’obtenir des données bâtiments à partir d’identifiants, qu’ils soient à l’échelle des logements, bâtiments ou d’un périmètre administratif.

💡 Il est conseillé d’avoir réalisé au préalable le tutorial Apprendre à utiliser l’API BDNB

Vous cherchez des données sur des bâtiments dans une zone

Pour les zones où il est sûr qu’un groupe de bâtiments de la BDNB est contenu intégralement (c’est à qu’il ne peut pas être à cheval entre deux zones). C’est le cas pour :

Nom identifiant Code identifiant Libellé Route API
Région code_region_insee libelle_region /donnees/rerefentiel_administratif_region
Département code_departement_insee libelle_departement /donnees/rerefentiel_administratif_departement
EPCI code_epci_insee libelle_epci /donnees/rerefentiel_administratif_epci
Commune code_commune_insee libelle_commune /donnees/rerefentiel_administratif_commune
IRIS code_iris libelle_iris /donnees/rerefentiel_administratif_iris
Quartier Prioritaire de la ville code_qp nom_qp /donnees/ancqpv

Comme il n’existe qu’une seule correspondance entre un groupe de bâtiments et la zone, (un groupe ne peut pas être à cheval entre 2 zones), il est possible de procéder à des sélections directement à partir des routes API /donnees/batiment_groupe et /donnees/batiment_groupe_complet. Par exemple, cette requête retourne les 10 premiers groupe de bâtiments dans le quartier prioritaire

import requests
r = requests.get(f"https://api.bdnb.io/v1/bdnb/donnees/batiment_groupe",
                 params= {'code_iris': 'eq.010040101',
                          'limit' : 10 }
                   )
print(len(r.json()[0]))
# >>[{'batiment_groupe_id': 'bdnb-bg-9LU8-J3UA-DBNL',
#   'code_departement_insee': '01',
#   's_geom_groupe': 98,
#   'code_iris': '010040101',
#   'code_commune_insee': '01004',
#   'code_region_insee': '84',
#   'code_qp': None,
#   'nom_qp': None,
#   'quartier_prioritaire': False,
#   'libelle_commune_insee': 'Ambérieu-en-Bugey',
#   'code_epci_insee': '240100883',
#   'contient_fictive_geom_groupe': False,
#   'geom_groupe': {'type': 'MultiPolygon',
#    'coordinates': [[[[880673.1, 6543035.3],
#       [880669.1, 6543024.3],
#       [880678.7, 6543020.9],
#       [880682.5, 6543031.9],
#       [880673.1, 6543035.3]]]]},
# [...]
15

Vous pouvez également utiliser la route /donnees/batiment_groupe_complet qui réalise un certain nombre de jointures avec les tables de données métiers :

import requests
r = requests.get(f"https://api.bdnb.io/v1/bdnb/donnees/batiment_groupe_complet",
                 params= {'code_iris': 'eq.010040101',
                          'limit' : 10 }
                   )
print(f"Nombre de champs retournés par bâtiment (API Open)")
print(len(r.json()[0]))
# >> 111
Nombre de champs retournés par bâtiment (API Open)
138

Vous cherchez des données sur des bâtiments avec des identifiants spécifiques

Plusieurs identifiants peuvent correspondre à ce groupe de bâtiments BDNB. C’est le cas pour :

Nom identifiant Code de l’identifiant Source Route API
clef interopérabilité adresse BAN cle_interop_adr Base d’Adresse Nationale (BAN) /donnees/rel_batiment_groupe_adresse
code de la parcelle parcelle_id Cadastre /donnees/rel_batiment_groupe_parcelle
identifiant de l’entrée RNB rnb_id Référentiel National des Bâtiments (RNB) /donnees/batiment_construction
Identifiant de l’entrée bâtiment construction batiment_construction_id BD-Topo (IGN)) /donnees/batiment_construction
immatriculation de copropriété numero_immat Registre national d’Immatriculation des Copropriétés (RNIC) /donnees/rel_batiment_groupe_rnc
référence Mériméé merimee_ref Base de données du patrimoine monumental français (Mérimée) /donnees/rel_batiment_groupe_merimee

La relation entre le groupe de bâtiments et votre identifiant pouvant ne pas être unique, il faut interroger des tables de relation (/donnnees/rel_batiment_groupe_<jeu_de_donnee>) qui ont toutes une structure du type :

identifiant table metier batiment_groupe_id
id_1 batiment_groupe_id_1
id_2 batiment_groupe_id_1
id_3 batiment_groupe_id_2
id_3 batiment_groupe_id_3

Pour le cas spécifique de la recherche par adresse, vous pouvez consulter Comment accéder aux données à partir d’adresses

Les requêtes sont alors toujours construites de la même manière :

import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/<route API>',
                  params={'<code identifiant>': 'eq.<identifiant>'})

Exemple 1 : Vous souhaitez trouver les bâtiments sur la parcelle 012020000G1910:

Récupérer les identifiants de groupes de bâtiments batiment_groupe_id :

import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/rel_batiment_groupe_parcelle',
                     params={'limit': 5,
                             'parcelle_id': 'eq.012020000G1910'})
r.json()
# >> [{'batiment_groupe_id': 'bdnb-bg-1149-YNEL-XZ34',
#   'code_departement_insee': '01',
#   'parcelle_id': '012020000G1910',
#   'parcelle_principale': False},
#  {'batiment_groupe_id': 'bdnb-bg-1ELE-VHZA-FP1D',
#   'code_departement_insee': '01',
#   'parcelle_id': '012020000G1910',
#   'parcelle_principale': True}]
[{'batiment_groupe_id': 'bdnb-bg-1149-YNEL-XZ34',
  'code_departement_insee': '01',
  'parcelle_id': '012020000G1910',
  'parcelle_principale': True},
 {'batiment_groupe_id': 'bdnb-bg-1ELE-VHZA-FP1D',
  'code_departement_insee': '01',
  'parcelle_id': '012020000G1910',
  'parcelle_principale': True}]

Récupérer les données pour ces batiment_groupe_id :

import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/batiment_groupe_complet',
                     params={'batiment_groupe_id' :  'in.("bdnb-bg-1149-YNEL-XZ34","bdnb-bg-1ELE-VHZA-FP1D")'})
r.json()
[{'alea_argile': 'Fort',
  'altitude_sol_mean': 234,
  'annee_construction': None,
  'annee_construction_dpe': None,
  'arrete_2021': None,
  'batenr_favorabilite_geothermie_nappe': None,
  'batenr_favorabilite_geothermie_sonde': None,
  'batenr_favorabilite_solaire_thermique': None,
  'batenr_potentiel_prod_solaire_thermique_annuelle': None,
  'batenr_potentiel_prod_solaire_thermique_ete': None,
  'batiment_groupe_id': 'bdnb-bg-1149-YNEL-XZ34',
  'chauffage_solaire': None,
  'classe_bilan_dpe': None,
  'classe_conso_energie_arrete_2012': None,
  'classe_conso_energie_dpe_tertiaire': None,
  'classe_inertie': None,
  'cle_interop_adr_principale_ban': None,
  'code_commune_insee': '01202',
  'code_departement_insee': '01',
  'code_epci_insee': '240100883',
  'code_iris': '012020101',
  'code_region_insee': '84',
  'commune_parente': '01202',
  'conso_3_usages_ep_m2_arrete_2012': None,
  'conso_5_usages_ep_m2': None,
  'conso_pro_dle_elec_2020': None,
  'conso_pro_dle_gaz_2020': None,
  'conso_res_dle_elec_2020': None,
  'conso_res_dle_gaz_2020': None,
  'contient_fictive_geom_groupe': False,
  'contrainte_urbanisme_ac1': None,
  'croisement_geospx_reussi': None,
  'date_reception_dpe': None,
  'denomination_monument_historique': None,
  'distance_batiment_historique_plus_proche': None,
  'distance_monument_historique': None,
  'ecs_solaire': None,
  'emission_ges_3_usages_ep_m2_arrete_2012': None,
  'emission_ges_5_usages_m2': None,
  'epaisseur_lame': None,
  'facteur_solaire_baie_vitree': None,
  'fiabilite_cr_adr_niv_1': None,
  'fiabilite_cr_adr_niv_2': None,
  'fiabilite_emprise_sol': None,
  'fiabilite_hauteur': None,
  'geom_groupe': {'type': 'MultiPolygon',
   'crs': {'type': 'name', 'properties': {'name': 'EPSG:2154'}},
   'coordinates': [[[[882461.6, 6536416.6],
      [882458.5, 6536416.5],
      [882458.4, 6536419.1],
      [882458.4, 6536421.1],
      [882461.5, 6536421.3],
      [882461.5, 6536419.1],
      [882461.6, 6536416.6]]]]},
  'hauteur_mean': 6,
  'identifiant_dpe': None,
  'id_reseau': None,
  'indicateur_distance_au_reseau': None,
  'l_cle_interop_adr': None,
  'l_denomination_proprietaire': None,
  'libelle_adr_principale_ban': None,
  'libelle_commune_insee': 'Lagnieu',
  'l_libelle_adr': None,
  'l_orientation_baie_vitree': None,
  'l_parcelle_id': ['012020000G1910', '012020000G1909'],
  'l_siren': None,
  'materiaux_structure_mur_exterieur': None,
  'mat_mur_txt': None,
  'mat_toit_txt': None,
  'methode_application_dpe_tertiaire': None,
  'nb_adresse_valid_ban': None,
  'nb_classe_bilan_dpe_a': None,
  'nb_classe_bilan_dpe_b': None,
  'nb_classe_bilan_dpe_c': None,
  'nb_classe_bilan_dpe_d': None,
  'nb_classe_bilan_dpe_e': None,
  'nb_classe_bilan_dpe_f': None,
  'nb_classe_bilan_dpe_g': None,
  'nb_classe_conso_energie_arrete_2012_a': None,
  'nb_classe_conso_energie_arrete_2012_b': None,
  'nb_classe_conso_energie_arrete_2012_c': None,
  'nb_classe_conso_energie_arrete_2012_d': None,
  'nb_classe_conso_energie_arrete_2012_e': None,
  'nb_classe_conso_energie_arrete_2012_f': None,
  'nb_classe_conso_energie_arrete_2012_g': None,
  'nb_classe_conso_energie_arrete_2012_nc': None,
  'nb_installation_chauffage': None,
  'nb_installation_ecs': None,
  'nb_log': None,
  'nb_log_rnc': None,
  'nb_lot_garpark_rnc': None,
  'nb_lot_tertiaire_rnc': None,
  'nb_niveau': None,
  'nb_pdl_pro_dle_elec_2020': None,
  'nb_pdl_pro_dle_gaz_2020': None,
  'nb_pdl_res_dle_elec_2020': None,
  'nb_pdl_res_dle_gaz_2020': None,
  'nom_batiment_historique_plus_proche': None,
  'nom_qp': None,
  'nom_quartier_qpv': None,
  'numero_immat_principal': None,
  'perimetre_bat_historique': None,
  'pourcentage_surface_baie_vitree_exterieur': None,
  'presence_balcon': None,
  'quartier_prioritaire': None,
  's_geom_groupe': 14,
  'surface_emprise_sol': 14,
  'traversant': None,
  'type_batiment_dpe': None,
  'type_dpe': None,
  'type_energie_chauffage': None,
  'type_energie_chauffage_appoint': None,
  'type_energie_chauffage_tertiaire': None,
  'type_fermeture': None,
  'type_gaz_lame': None,
  'type_generateur_chauffage': None,
  'type_generateur_chauffage_anciennete': None,
  'type_generateur_chauffage_anciennete_appoint': None,
  'type_generateur_chauffage_appoint': None,
  'type_generateur_climatisation': None,
  'type_generateur_climatisation_anciennete': None,
  'type_generateur_ecs': None,
  'type_generateur_ecs_anciennete': None,
  'type_generateur_ecs_anciennete_appoint': None,
  'type_generateur_ecs_appoint': None,
  'type_installation_chauffage': None,
  'type_installation_ecs': None,
  'type_isolation_mur_exterieur': None,
  'type_isolation_plancher_bas': None,
  'type_isolation_plancher_haut': None,
  'type_materiaux_menuiserie': None,
  'type_plancher_bas_deperditif': None,
  'type_plancher_haut_deperditif': None,
  'type_production_energie_renouvelable': None,
  'type_ventilation': None,
  'type_vitrage': None,
  'u_baie_vitree': None,
  'u_mur_exterieur': None,
  'u_plancher_bas_final_deperditif': None,
  'u_plancher_haut_deperditif': None,
  'usage_niveau_1_txt': None,
  'usage_principal_bdnb_open': None,
  'uw': None,
  'valeur_fonciere_m2_residentiel_rel_commune': None,
  'vitrage_vir': None,
  'zone_plu_bati_patrimonial': None},
 {'alea_argile': 'Fort',
  'altitude_sol_mean': 235,
  'annee_construction': 1875,
  'annee_construction_dpe': None,
  'arrete_2021': None,
  'batenr_favorabilite_geothermie_nappe': False,
  'batenr_favorabilite_geothermie_sonde': False,
  'batenr_favorabilite_solaire_thermique': True,
  'batenr_potentiel_prod_solaire_thermique_annuelle': 11.62,
  'batenr_potentiel_prod_solaire_thermique_ete': 3.37,
  'batiment_groupe_id': 'bdnb-bg-1ELE-VHZA-FP1D',
  'chauffage_solaire': None,
  'classe_bilan_dpe': None,
  'classe_conso_energie_arrete_2012': None,
  'classe_conso_energie_dpe_tertiaire': None,
  'classe_inertie': None,
  'cle_interop_adr_principale_ban': '01202_0035_00309',
  'code_commune_insee': '01202',
  'code_departement_insee': '01',
  'code_epci_insee': '240100883',
  'code_iris': '012020101',
  'code_region_insee': '84',
  'commune_parente': '01202',
  'conso_3_usages_ep_m2_arrete_2012': None,
  'conso_5_usages_ep_m2': None,
  'conso_pro_dle_elec_2020': None,
  'conso_pro_dle_gaz_2020': None,
  'conso_res_dle_elec_2020': None,
  'conso_res_dle_gaz_2020': None,
  'contient_fictive_geom_groupe': False,
  'contrainte_urbanisme_ac1': None,
  'croisement_geospx_reussi': None,
  'date_reception_dpe': None,
  'denomination_monument_historique': None,
  'distance_batiment_historique_plus_proche': None,
  'distance_monument_historique': None,
  'ecs_solaire': None,
  'emission_ges_3_usages_ep_m2_arrete_2012': None,
  'emission_ges_5_usages_m2': None,
  'epaisseur_lame': None,
  'facteur_solaire_baie_vitree': None,
  'fiabilite_cr_adr_niv_1': "données croisées à l'adresse fiables",
  'fiabilite_cr_adr_niv_2': "batiment sans voisin à l'adresse",
  'fiabilite_emprise_sol': 'FAIBLE',
  'fiabilite_hauteur': 'BONNE',
  'geom_groupe': {'type': 'MultiPolygon',
   'crs': {'type': 'name', 'properties': {'name': 'EPSG:2154'}},
   'coordinates': [[[[882458.8, 6536411.6],
      [882458.5, 6536411.9],
      [882458.5, 6536416.5],
      [882461.6, 6536416.6],
      [882461.5, 6536419.1],
      [882461.5, 6536421.3],
      [882467.4, 6536421.4],
      [882467.5, 6536419.1],
      [882467.7, 6536412.3],
      [882467.2, 6536411.8],
      [882463.8, 6536411.7],
      [882464, 6536409.1],
      [882460.3, 6536405.9],
      [882459.6, 6536405.4],
      [882459, 6536405],
      [882458.9, 6536406.7],
      [882458.8, 6536411.6]]]]},
  'hauteur_mean': 5,
  'identifiant_dpe': None,
  'id_reseau': None,
  'indicateur_distance_au_reseau': None,
  'l_cle_interop_adr': ['01202_0035_00309'],
  'l_denomination_proprietaire': None,
  'libelle_adr_principale_ban': '309 Rue de Bramafan 01150 Lagnieu',
  'libelle_commune_insee': 'Lagnieu',
  'l_libelle_adr': ['309 rue de bramafan, 01150, Lagnieu'],
  'l_orientation_baie_vitree': None,
  'l_parcelle_id': ['012020000G1910', '012020000G1909'],
  'l_siren': None,
  'materiaux_structure_mur_exterieur': None,
  'mat_mur_txt': 'MEULIERE',
  'mat_toit_txt': 'TUILES',
  'methode_application_dpe_tertiaire': None,
  'nb_adresse_valid_ban': 1,
  'nb_classe_bilan_dpe_a': None,
  'nb_classe_bilan_dpe_b': None,
  'nb_classe_bilan_dpe_c': None,
  'nb_classe_bilan_dpe_d': None,
  'nb_classe_bilan_dpe_e': None,
  'nb_classe_bilan_dpe_f': None,
  'nb_classe_bilan_dpe_g': None,
  'nb_classe_conso_energie_arrete_2012_a': None,
  'nb_classe_conso_energie_arrete_2012_b': None,
  'nb_classe_conso_energie_arrete_2012_c': None,
  'nb_classe_conso_energie_arrete_2012_d': None,
  'nb_classe_conso_energie_arrete_2012_e': None,
  'nb_classe_conso_energie_arrete_2012_f': None,
  'nb_classe_conso_energie_arrete_2012_g': None,
  'nb_classe_conso_energie_arrete_2012_nc': None,
  'nb_installation_chauffage': None,
  'nb_installation_ecs': None,
  'nb_log': 1,
  'nb_log_rnc': None,
  'nb_lot_garpark_rnc': None,
  'nb_lot_tertiaire_rnc': None,
  'nb_niveau': 2,
  'nb_pdl_pro_dle_elec_2020': None,
  'nb_pdl_pro_dle_gaz_2020': None,
  'nb_pdl_res_dle_elec_2020': None,
  'nb_pdl_res_dle_gaz_2020': None,
  'nom_batiment_historique_plus_proche': None,
  'nom_qp': None,
  'nom_quartier_qpv': None,
  'numero_immat_principal': None,
  'perimetre_bat_historique': None,
  'pourcentage_surface_baie_vitree_exterieur': None,
  'presence_balcon': None,
  'quartier_prioritaire': None,
  's_geom_groupe': 97,
  'surface_emprise_sol': 97,
  'traversant': None,
  'type_batiment_dpe': None,
  'type_dpe': None,
  'type_energie_chauffage': None,
  'type_energie_chauffage_appoint': None,
  'type_energie_chauffage_tertiaire': None,
  'type_fermeture': None,
  'type_gaz_lame': None,
  'type_generateur_chauffage': None,
  'type_generateur_chauffage_anciennete': None,
  'type_generateur_chauffage_anciennete_appoint': None,
  'type_generateur_chauffage_appoint': None,
  'type_generateur_climatisation': None,
  'type_generateur_climatisation_anciennete': None,
  'type_generateur_ecs': None,
  'type_generateur_ecs_anciennete': None,
  'type_generateur_ecs_anciennete_appoint': None,
  'type_generateur_ecs_appoint': None,
  'type_installation_chauffage': None,
  'type_installation_ecs': None,
  'type_isolation_mur_exterieur': None,
  'type_isolation_plancher_bas': None,
  'type_isolation_plancher_haut': None,
  'type_materiaux_menuiserie': None,
  'type_plancher_bas_deperditif': None,
  'type_plancher_haut_deperditif': None,
  'type_production_energie_renouvelable': None,
  'type_ventilation': None,
  'type_vitrage': None,
  'u_baie_vitree': None,
  'u_mur_exterieur': None,
  'u_plancher_bas_final_deperditif': None,
  'u_plancher_haut_deperditif': None,
  'usage_niveau_1_txt': 'Résidentiel individuel',
  'usage_principal_bdnb_open': 'Résidentiel individuel',
  'uw': None,
  'valeur_fonciere_m2_residentiel_rel_commune': None,
  'vitrage_vir': None,
  'zone_plu_bati_patrimonial': None}]

Pour les parcelles comme pour les adresses, il existe une route dédiée qui combine ces 2 appels en un seul :

import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/batiment_groupe_complet/parcelle',
                     params={'limit': 5,
                             'parcelle_id': 'eq.012020000G1910'})
r.json()
[{'alea_argile': 'Fort',
  'altitude_sol_mean': 234,
  'annee_construction': None,
  'annee_construction_dpe': None,
  'arrete_2021': None,
  'batenr_favorabilite_geothermie_nappe': None,
  'batenr_favorabilite_geothermie_sonde': None,
  'batenr_favorabilite_solaire_thermique': None,
  'batenr_potentiel_prod_solaire_thermique_annuelle': None,
  'batenr_potentiel_prod_solaire_thermique_ete': None,
  'batiment_groupe_id': 'bdnb-bg-1149-YNEL-XZ34',
  'chauffage_solaire': None,
  'classe_bilan_dpe': None,
  'classe_conso_energie_arrete_2012': None,
  'classe_conso_energie_dpe_tertiaire': None,
  'classe_inertie': None,
  'cle_interop_adr_principale_ban': None,
  'code_commune_insee': '01202',
  'code_departement_insee': '01',
  'code_epci_insee': '240100883',
  'code_iris': '012020101',
  'code_region_insee': '84',
  'commune_parente': '01202',
  'conso_3_usages_ep_m2_arrete_2012': None,
  'conso_5_usages_ep_m2': None,
  'conso_pro_dle_elec_2020': None,
  'conso_pro_dle_gaz_2020': None,
  'conso_res_dle_elec_2020': None,
  'conso_res_dle_gaz_2020': None,
  'contient_fictive_geom_groupe': False,
  'contrainte_urbanisme_ac1': None,
  'croisement_geospx_reussi': None,
  'date_reception_dpe': None,
  'denomination_monument_historique': None,
  'distance_batiment_historique_plus_proche': None,
  'distance_monument_historique': None,
  'ecs_solaire': None,
  'emission_ges_3_usages_ep_m2_arrete_2012': None,
  'emission_ges_5_usages_m2': None,
  'epaisseur_lame': None,
  'facteur_solaire_baie_vitree': None,
  'fiabilite_cr_adr_niv_1': None,
  'fiabilite_cr_adr_niv_2': None,
  'fiabilite_emprise_sol': None,
  'fiabilite_hauteur': None,
  'geom_groupe': {'type': 'MultiPolygon',
   'crs': {'type': 'name', 'properties': {'name': 'EPSG:2154'}},
   'coordinates': [[[[882461.6, 6536416.6],
      [882458.5, 6536416.5],
      [882458.4, 6536419.1],
      [882458.4, 6536421.1],
      [882461.5, 6536421.3],
      [882461.5, 6536419.1],
      [882461.6, 6536416.6]]]]},
  'hauteur_mean': 6,
  'identifiant_dpe': None,
  'id_reseau': None,
  'indicateur_distance_au_reseau': None,
  'l_cle_interop_adr': None,
  'l_denomination_proprietaire': None,
  'libelle_adr_principale_ban': None,
  'libelle_commune_insee': 'Lagnieu',
  'l_libelle_adr': None,
  'l_orientation_baie_vitree': None,
  'l_parcelle_id': ['012020000G1910', '012020000G1909'],
  'l_siren': None,
  'materiaux_structure_mur_exterieur': None,
  'mat_mur_txt': None,
  'mat_toit_txt': None,
  'methode_application_dpe_tertiaire': None,
  'nb_adresse_valid_ban': None,
  'nb_classe_bilan_dpe_a': None,
  'nb_classe_bilan_dpe_b': None,
  'nb_classe_bilan_dpe_c': None,
  'nb_classe_bilan_dpe_d': None,
  'nb_classe_bilan_dpe_e': None,
  'nb_classe_bilan_dpe_f': None,
  'nb_classe_bilan_dpe_g': None,
  'nb_classe_conso_energie_arrete_2012_a': None,
  'nb_classe_conso_energie_arrete_2012_b': None,
  'nb_classe_conso_energie_arrete_2012_c': None,
  'nb_classe_conso_energie_arrete_2012_d': None,
  'nb_classe_conso_energie_arrete_2012_e': None,
  'nb_classe_conso_energie_arrete_2012_f': None,
  'nb_classe_conso_energie_arrete_2012_g': None,
  'nb_classe_conso_energie_arrete_2012_nc': None,
  'nb_installation_chauffage': None,
  'nb_installation_ecs': None,
  'nb_log': None,
  'nb_log_rnc': None,
  'nb_lot_garpark_rnc': None,
  'nb_lot_tertiaire_rnc': None,
  'nb_niveau': None,
  'nb_pdl_pro_dle_elec_2020': None,
  'nb_pdl_pro_dle_gaz_2020': None,
  'nb_pdl_res_dle_elec_2020': None,
  'nb_pdl_res_dle_gaz_2020': None,
  'nom_batiment_historique_plus_proche': None,
  'nom_qp': None,
  'nom_quartier_qpv': None,
  'numero_immat_principal': None,
  'parcelle_id': '012020000G1910',
  'perimetre_bat_historique': None,
  'pourcentage_surface_baie_vitree_exterieur': None,
  'presence_balcon': None,
  'quartier_prioritaire': None,
  's_geom_groupe': 14,
  'surface_emprise_sol': 14,
  'traversant': None,
  'type_batiment_dpe': None,
  'type_dpe': None,
  'type_energie_chauffage': None,
  'type_energie_chauffage_appoint': None,
  'type_energie_chauffage_tertiaire': None,
  'type_fermeture': None,
  'type_gaz_lame': None,
  'type_generateur_chauffage': None,
  'type_generateur_chauffage_anciennete': None,
  'type_generateur_chauffage_anciennete_appoint': None,
  'type_generateur_chauffage_appoint': None,
  'type_generateur_climatisation': None,
  'type_generateur_climatisation_anciennete': None,
  'type_generateur_ecs': None,
  'type_generateur_ecs_anciennete': None,
  'type_generateur_ecs_anciennete_appoint': None,
  'type_generateur_ecs_appoint': None,
  'type_installation_chauffage': None,
  'type_installation_ecs': None,
  'type_isolation_mur_exterieur': None,
  'type_isolation_plancher_bas': None,
  'type_isolation_plancher_haut': None,
  'type_materiaux_menuiserie': None,
  'type_plancher_bas_deperditif': None,
  'type_plancher_haut_deperditif': None,
  'type_production_energie_renouvelable': None,
  'type_ventilation': None,
  'type_vitrage': None,
  'u_baie_vitree': None,
  'u_mur_exterieur': None,
  'u_plancher_bas_final_deperditif': None,
  'u_plancher_haut_deperditif': None,
  'usage_niveau_1_txt': None,
  'usage_principal_bdnb_open': None,
  'uw': None,
  'valeur_fonciere_m2_residentiel_rel_commune': None,
  'vitrage_vir': None,
  'zone_plu_bati_patrimonial': None},
 {'alea_argile': 'Fort',
  'altitude_sol_mean': 235,
  'annee_construction': 1875,
  'annee_construction_dpe': None,
  'arrete_2021': None,
  'batenr_favorabilite_geothermie_nappe': False,
  'batenr_favorabilite_geothermie_sonde': False,
  'batenr_favorabilite_solaire_thermique': True,
  'batenr_potentiel_prod_solaire_thermique_annuelle': 11.62,
  'batenr_potentiel_prod_solaire_thermique_ete': 3.37,
  'batiment_groupe_id': 'bdnb-bg-1ELE-VHZA-FP1D',
  'chauffage_solaire': None,
  'classe_bilan_dpe': None,
  'classe_conso_energie_arrete_2012': None,
  'classe_conso_energie_dpe_tertiaire': None,
  'classe_inertie': None,
  'cle_interop_adr_principale_ban': '01202_0035_00309',
  'code_commune_insee': '01202',
  'code_departement_insee': '01',
  'code_epci_insee': '240100883',
  'code_iris': '012020101',
  'code_region_insee': '84',
  'commune_parente': '01202',
  'conso_3_usages_ep_m2_arrete_2012': None,
  'conso_5_usages_ep_m2': None,
  'conso_pro_dle_elec_2020': None,
  'conso_pro_dle_gaz_2020': None,
  'conso_res_dle_elec_2020': None,
  'conso_res_dle_gaz_2020': None,
  'contient_fictive_geom_groupe': False,
  'contrainte_urbanisme_ac1': None,
  'croisement_geospx_reussi': None,
  'date_reception_dpe': None,
  'denomination_monument_historique': None,
  'distance_batiment_historique_plus_proche': None,
  'distance_monument_historique': None,
  'ecs_solaire': None,
  'emission_ges_3_usages_ep_m2_arrete_2012': None,
  'emission_ges_5_usages_m2': None,
  'epaisseur_lame': None,
  'facteur_solaire_baie_vitree': None,
  'fiabilite_cr_adr_niv_1': "données croisées à l'adresse fiables",
  'fiabilite_cr_adr_niv_2': "batiment sans voisin à l'adresse",
  'fiabilite_emprise_sol': 'FAIBLE',
  'fiabilite_hauteur': 'BONNE',
  'geom_groupe': {'type': 'MultiPolygon',
   'crs': {'type': 'name', 'properties': {'name': 'EPSG:2154'}},
   'coordinates': [[[[882458.8, 6536411.6],
      [882458.5, 6536411.9],
      [882458.5, 6536416.5],
      [882461.6, 6536416.6],
      [882461.5, 6536419.1],
      [882461.5, 6536421.3],
      [882467.4, 6536421.4],
      [882467.5, 6536419.1],
      [882467.7, 6536412.3],
      [882467.2, 6536411.8],
      [882463.8, 6536411.7],
      [882464, 6536409.1],
      [882460.3, 6536405.9],
      [882459.6, 6536405.4],
      [882459, 6536405],
      [882458.9, 6536406.7],
      [882458.8, 6536411.6]]]]},
  'hauteur_mean': 5,
  'identifiant_dpe': None,
  'id_reseau': None,
  'indicateur_distance_au_reseau': None,
  'l_cle_interop_adr': ['01202_0035_00309'],
  'l_denomination_proprietaire': None,
  'libelle_adr_principale_ban': '309 Rue de Bramafan 01150 Lagnieu',
  'libelle_commune_insee': 'Lagnieu',
  'l_libelle_adr': ['309 rue de bramafan, 01150, Lagnieu'],
  'l_orientation_baie_vitree': None,
  'l_parcelle_id': ['012020000G1910', '012020000G1909'],
  'l_siren': None,
  'materiaux_structure_mur_exterieur': None,
  'mat_mur_txt': 'MEULIERE',
  'mat_toit_txt': 'TUILES',
  'methode_application_dpe_tertiaire': None,
  'nb_adresse_valid_ban': 1,
  'nb_classe_bilan_dpe_a': None,
  'nb_classe_bilan_dpe_b': None,
  'nb_classe_bilan_dpe_c': None,
  'nb_classe_bilan_dpe_d': None,
  'nb_classe_bilan_dpe_e': None,
  'nb_classe_bilan_dpe_f': None,
  'nb_classe_bilan_dpe_g': None,
  'nb_classe_conso_energie_arrete_2012_a': None,
  'nb_classe_conso_energie_arrete_2012_b': None,
  'nb_classe_conso_energie_arrete_2012_c': None,
  'nb_classe_conso_energie_arrete_2012_d': None,
  'nb_classe_conso_energie_arrete_2012_e': None,
  'nb_classe_conso_energie_arrete_2012_f': None,
  'nb_classe_conso_energie_arrete_2012_g': None,
  'nb_classe_conso_energie_arrete_2012_nc': None,
  'nb_installation_chauffage': None,
  'nb_installation_ecs': None,
  'nb_log': 1,
  'nb_log_rnc': None,
  'nb_lot_garpark_rnc': None,
  'nb_lot_tertiaire_rnc': None,
  'nb_niveau': 2,
  'nb_pdl_pro_dle_elec_2020': None,
  'nb_pdl_pro_dle_gaz_2020': None,
  'nb_pdl_res_dle_elec_2020': None,
  'nb_pdl_res_dle_gaz_2020': None,
  'nom_batiment_historique_plus_proche': None,
  'nom_qp': None,
  'nom_quartier_qpv': None,
  'numero_immat_principal': None,
  'parcelle_id': '012020000G1910',
  'perimetre_bat_historique': None,
  'pourcentage_surface_baie_vitree_exterieur': None,
  'presence_balcon': None,
  'quartier_prioritaire': None,
  's_geom_groupe': 97,
  'surface_emprise_sol': 97,
  'traversant': None,
  'type_batiment_dpe': None,
  'type_dpe': None,
  'type_energie_chauffage': None,
  'type_energie_chauffage_appoint': None,
  'type_energie_chauffage_tertiaire': None,
  'type_fermeture': None,
  'type_gaz_lame': None,
  'type_generateur_chauffage': None,
  'type_generateur_chauffage_anciennete': None,
  'type_generateur_chauffage_anciennete_appoint': None,
  'type_generateur_chauffage_appoint': None,
  'type_generateur_climatisation': None,
  'type_generateur_climatisation_anciennete': None,
  'type_generateur_ecs': None,
  'type_generateur_ecs_anciennete': None,
  'type_generateur_ecs_anciennete_appoint': None,
  'type_generateur_ecs_appoint': None,
  'type_installation_chauffage': None,
  'type_installation_ecs': None,
  'type_isolation_mur_exterieur': None,
  'type_isolation_plancher_bas': None,
  'type_isolation_plancher_haut': None,
  'type_materiaux_menuiserie': None,
  'type_plancher_bas_deperditif': None,
  'type_plancher_haut_deperditif': None,
  'type_production_energie_renouvelable': None,
  'type_ventilation': None,
  'type_vitrage': None,
  'u_baie_vitree': None,
  'u_mur_exterieur': None,
  'u_plancher_bas_final_deperditif': None,
  'u_plancher_haut_deperditif': None,
  'usage_niveau_1_txt': 'Résidentiel individuel',
  'usage_principal_bdnb_open': 'Résidentiel individuel',
  'uw': None,
  'valeur_fonciere_m2_residentiel_rel_commune': None,
  'vitrage_vir': None,
  'zone_plu_bati_patrimonial': None}]

Exemple 2 : Vous souhaitez trouver le bâtiment que possède l’identifiant rnb WZA31ZZBRR5S:

Récupérer l’identifiant du bâtiment construction batiment_construction_id et du groupe de bâtiments batiment_groupe_id :

import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/batiment_construction',
                     params={'limit': 5,
                             'rnb_id': 'eq.WZA31ZZBRR5S'})
r.json()
# >> [{

#   'batiment_construction_id': 'bdnb-bc-SLLN-DQEB-SNEE',
#   'rnb_id': 'WZA31ZZBRR5S',
#   'batiment_groupe_id': 'bdnb-bg-1149-YNEL-XZ34',
#   'code_departement_insee': '01',
#   'code_iris': '012020101',
#   'code_commune_insee': '01202',
#   's_geom_cstr': 8,
#   'hauteur': 6.3,
#   'altitude_sol': 231.9,
#   'fictive_geom_cstr': False,
#   'geom_cstr': 'MULTIPOLYGON (((882458.4 6536419.1, 882458.5 6536416.5, 882461.6 6536416.6, 882461.5 6536419.1, 882458.4 6536419.1)))'
# }
# ]
[]

Récupérer les données pour ce batiment_groupe_id :

import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/batiment_groupe_complet',
                     params={'batiment_groupe_id' :  'in.("bdnb-bg-1149-YNEL-XZ34")'})
r.json()
[{'alea_argile': 'Fort',
  'altitude_sol_mean': 234,
  'annee_construction': None,
  'annee_construction_dpe': None,
  'arrete_2021': None,
  'batenr_favorabilite_geothermie_nappe': None,
  'batenr_favorabilite_geothermie_sonde': None,
  'batenr_favorabilite_solaire_thermique': None,
  'batenr_potentiel_prod_solaire_thermique_annuelle': None,
  'batenr_potentiel_prod_solaire_thermique_ete': None,
  'batiment_groupe_id': 'bdnb-bg-1149-YNEL-XZ34',
  'chauffage_solaire': None,
  'classe_bilan_dpe': None,
  'classe_conso_energie_arrete_2012': None,
  'classe_conso_energie_dpe_tertiaire': None,
  'classe_inertie': None,
  'cle_interop_adr_principale_ban': None,
  'code_commune_insee': '01202',
  'code_departement_insee': '01',
  'code_epci_insee': '240100883',
  'code_iris': '012020101',
  'code_region_insee': '84',
  'commune_parente': '01202',
  'conso_3_usages_ep_m2_arrete_2012': None,
  'conso_5_usages_ep_m2': None,
  'conso_pro_dle_elec_2020': None,
  'conso_pro_dle_gaz_2020': None,
  'conso_res_dle_elec_2020': None,
  'conso_res_dle_gaz_2020': None,
  'contient_fictive_geom_groupe': False,
  'contrainte_urbanisme_ac1': None,
  'croisement_geospx_reussi': None,
  'date_reception_dpe': None,
  'denomination_monument_historique': None,
  'distance_batiment_historique_plus_proche': None,
  'distance_monument_historique': None,
  'ecs_solaire': None,
  'emission_ges_3_usages_ep_m2_arrete_2012': None,
  'emission_ges_5_usages_m2': None,
  'epaisseur_lame': None,
  'facteur_solaire_baie_vitree': None,
  'fiabilite_cr_adr_niv_1': None,
  'fiabilite_cr_adr_niv_2': None,
  'fiabilite_emprise_sol': None,
  'fiabilite_hauteur': None,
  'geom_groupe': {'type': 'MultiPolygon',
   'crs': {'type': 'name', 'properties': {'name': 'EPSG:2154'}},
   'coordinates': [[[[882461.6, 6536416.6],
      [882458.5, 6536416.5],
      [882458.4, 6536419.1],
      [882458.4, 6536421.1],
      [882461.5, 6536421.3],
      [882461.5, 6536419.1],
      [882461.6, 6536416.6]]]]},
  'hauteur_mean': 6,
  'identifiant_dpe': None,
  'id_reseau': None,
  'indicateur_distance_au_reseau': None,
  'l_cle_interop_adr': None,
  'l_denomination_proprietaire': None,
  'libelle_adr_principale_ban': None,
  'libelle_commune_insee': 'Lagnieu',
  'l_libelle_adr': None,
  'l_orientation_baie_vitree': None,
  'l_parcelle_id': ['012020000G1910', '012020000G1909'],
  'l_siren': None,
  'materiaux_structure_mur_exterieur': None,
  'mat_mur_txt': None,
  'mat_toit_txt': None,
  'methode_application_dpe_tertiaire': None,
  'nb_adresse_valid_ban': None,
  'nb_classe_bilan_dpe_a': None,
  'nb_classe_bilan_dpe_b': None,
  'nb_classe_bilan_dpe_c': None,
  'nb_classe_bilan_dpe_d': None,
  'nb_classe_bilan_dpe_e': None,
  'nb_classe_bilan_dpe_f': None,
  'nb_classe_bilan_dpe_g': None,
  'nb_classe_conso_energie_arrete_2012_a': None,
  'nb_classe_conso_energie_arrete_2012_b': None,
  'nb_classe_conso_energie_arrete_2012_c': None,
  'nb_classe_conso_energie_arrete_2012_d': None,
  'nb_classe_conso_energie_arrete_2012_e': None,
  'nb_classe_conso_energie_arrete_2012_f': None,
  'nb_classe_conso_energie_arrete_2012_g': None,
  'nb_classe_conso_energie_arrete_2012_nc': None,
  'nb_installation_chauffage': None,
  'nb_installation_ecs': None,
  'nb_log': None,
  'nb_log_rnc': None,
  'nb_lot_garpark_rnc': None,
  'nb_lot_tertiaire_rnc': None,
  'nb_niveau': None,
  'nb_pdl_pro_dle_elec_2020': None,
  'nb_pdl_pro_dle_gaz_2020': None,
  'nb_pdl_res_dle_elec_2020': None,
  'nb_pdl_res_dle_gaz_2020': None,
  'nom_batiment_historique_plus_proche': None,
  'nom_qp': None,
  'nom_quartier_qpv': None,
  'numero_immat_principal': None,
  'perimetre_bat_historique': None,
  'pourcentage_surface_baie_vitree_exterieur': None,
  'presence_balcon': None,
  'quartier_prioritaire': None,
  's_geom_groupe': 14,
  'surface_emprise_sol': 14,
  'traversant': None,
  'type_batiment_dpe': None,
  'type_dpe': None,
  'type_energie_chauffage': None,
  'type_energie_chauffage_appoint': None,
  'type_energie_chauffage_tertiaire': None,
  'type_fermeture': None,
  'type_gaz_lame': None,
  'type_generateur_chauffage': None,
  'type_generateur_chauffage_anciennete': None,
  'type_generateur_chauffage_anciennete_appoint': None,
  'type_generateur_chauffage_appoint': None,
  'type_generateur_climatisation': None,
  'type_generateur_climatisation_anciennete': None,
  'type_generateur_ecs': None,
  'type_generateur_ecs_anciennete': None,
  'type_generateur_ecs_anciennete_appoint': None,
  'type_generateur_ecs_appoint': None,
  'type_installation_chauffage': None,
  'type_installation_ecs': None,
  'type_isolation_mur_exterieur': None,
  'type_isolation_plancher_bas': None,
  'type_isolation_plancher_haut': None,
  'type_materiaux_menuiserie': None,
  'type_plancher_bas_deperditif': None,
  'type_plancher_haut_deperditif': None,
  'type_production_energie_renouvelable': None,
  'type_ventilation': None,
  'type_vitrage': None,
  'u_baie_vitree': None,
  'u_mur_exterieur': None,
  'u_plancher_bas_final_deperditif': None,
  'u_plancher_haut_deperditif': None,
  'usage_niveau_1_txt': None,
  'usage_principal_bdnb_open': None,
  'uw': None,
  'valeur_fonciere_m2_residentiel_rel_commune': None,
  'vitrage_vir': None,
  'zone_plu_bati_patrimonial': None}]

Exemple 3 : Vous souhaitez trouver les bâtiments avec une immatriculation de copropriété AB9910183 :

import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/rel_batiment_groupe_rnc',
                     params={'numero_immat': 'eq.AB9910183'})
r.json()
# >>
# [{'batiment_groupe_id': 'bdnb-bg-2Y6P-34Z2-SYSA',
#   'adresse_brut': '73 Rue Houdan 92330 Sceaux 92330 Sceaux',
#   'adresse_geocodee': '73 Rue Houdan 92330 Sceaux',
#   'cle_interop_adr': '92071_4460_00073',
#   'code_departement_insee': '92',
#   'fiabilite_geocodage': 'très fiable',
#   'fiabilite_globale': 'très fiable',
#   'numero_immat': 'AB9910183',
#   'parcelle_id': None}]
[{'adresse_brut': '73 Rue Houdan 92330 Sceaux',
  'adresse_geocodee': '73 Rue Houdan 92330 Sceaux',
  'batiment_groupe_id': 'bdnb-bg-2Y6P-34Z2-SYSA',
  'cle_interop_adr': '92071_4460_00073',
  'code_departement_insee': '92',
  'fiabilite_geocodage': 'très fiable',
  'fiabilite_globale': 'très fiable',
  'numero_immat': 'AB9910183',
  'parcelle_id': None}]

⚠️ Attention aux sources de données multiples

Dans cette table, il ne s’agit que des informations brutes issues du RNIC.

Dans l’exemple précédant, l’identifiant de parcelle est manquant, alors qu’il est disponible dans les croisements de la BDNB :

import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/batiment_groupe_complet',
                     params={'batiment_groupe_id': 'eq.bdnb-bg-2Y6P-34Z2-SYSA',
                            'select' : 'batiment_groupe_id, l_parcelle_id'})
r.json()
# [{'batiment_groupe_id': 'bdnb-bg-2Y6P-34Z2-SYSA',
#   'l_parcelle_id': ['920710000K0301']}]
[{'batiment_groupe_id': 'bdnb-bg-2Y6P-34Z2-SYSA',
  'l_parcelle_id': ['920710000K0301']}]

Exemple 4 : Reseaux de chaleur - froid :

⚠️ Attention: En open data, la distance et l’identifiant du réseau sont accessibles. Le potentiel de raccordement est accessible qu’avec l’API expert de la BDNB.

  • Requête pour obtenir le potentiel de raccordement aux réseaux de chaleur et de froid depuis l’identifiant bâtiment groupe
import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/batiment_groupe_indicateur_reseau_chaud_froid',
                     params={'batiment_groupe_id': 'eq.bdnb-bg-1123-F49H-QBUD'})
r.json()
[]

Exemple 5 : Requêter depuis le SIREN :

⚠️ Attention: ces données ne sont accessibles qu’avec l’API expert de la BDNB.

  • Trouver Vos Bâtiments Liés à Votre SIREN :
import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/rel_batiment_groupe_siren_complet',
                     params={'siren': 'eq.775688229'},
                     headers={'X-Gravitee-Api-Key': 'ma-clef-d-api-secrete'})
r.json()
{'message': 'Unauthorized', 'http_status_code': 401}

⚠️ Attention : Si l’entreprise possède des établissements répartis sur plusieurs bâtiments, la réponse à votre requête sera une liste de ces bâtiments.

  • Trouver un Bâtiment et les Entreprises Associées : Si vous connaissez l’id du bâtiment groupe :
import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/rel_batiment_groupe_siren_complet',
                     params={'batiment_groupe_id': 'eq.bdnb-bg-EPJS-1QZ2-LAN9'},
                     headers={'X-Gravitee-Api-Key': 'ma-clef-d-api-secrete'})
r.json()
{'message': 'Unauthorized', 'http_status_code': 401}

Si vous ne connaissez pas l’id du bâtiment groupe : Voir comment récupérer l’id de mon bâtiment depuis l’adresse

  • Analyser les Entreprises dans une Zone Géographique Spécifique
import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/rel_batiment_groupe_siren_complet',
                     params={'code_departement_insee': 'eq.75'},
                     headers={'X-Gravitee-Api-Key': 'ma-clef-d-api-secrete'})
r.json()
{'message': 'Unauthorized', 'http_status_code': 401}

Exemple 6 : Requêter depuis le SIRET :

⚠️ Attention: ces données ne sont accessibles qu’avec l’API expert de la BDNB.

  • Trouver Vos Bâtiments Liés à Votre SIRET :
import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/rel_batiment_groupe_siret_complet',
                     params={'siret': 'eq.77568822900050'},
                     headers={'X-Gravitee-Api-Key': 'ma-clef-d-api-secrete'})
r.json()
{'message': 'Unauthorized', 'http_status_code': 401}
  • Trouver un Bâtiment et les établissements qu’y sont présents : Si vous connaissez l’id du bâtiment groupe :
import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/rel_batiment_groupe_siret_complet',
                     params={'batiment_groupe_id': 'eq.bdnb-bg-EPJS-1QZ2-LAN9'},
                     headers={'X-Gravitee-Api-Key': 'ma-clef-d-api-secrete'})
r.json()
{'message': 'Unauthorized', 'http_status_code': 401}

Si vous ne connaissez pas l’id du bâtiment groupe : Voir comment récupérer l’id de mon bâtiment depuis l’adresse

⚠️ Attention : Un bâtiment peut ragrouper plusieurs établissements, donc la réponse à votre requête sera une liste d’établissements.

  • Trouver les Bâtiments avec des Établissements Liés à une Catégorie d’Activité spécifique.
    • Par exemple, trouver les bâtiments avec des établissements dont l’activité principale est la ‘Recherche-développement scientifique’
    • Les code d’activité principale sont ceux indiqués dans la base sirene pour les établisssements - Consulter la source
import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/rel_batiment_groupe_siren_complet',
                     params={'code_activite_principale': 'eq.72.19Z'},
                     headers={'X-Gravitee-Api-Key': 'ma-clef-d-api-secrete'})
r.json()
{'message': 'Unauthorized', 'http_status_code': 401}

Exemple 7 : Iris et son contexte géographique :

⚠️ Attention: ces données ne sont accessibles qu’avec l’API expert de la BDNB.

import requests
# Requête pour obtenir les informations géographiques d'un IRIS spécifique
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/iris_contexte_geographique',
                     params={'code_iris': 'eq.130780101'},
                     headers={'X-Gravitee-Api-Key': 'ma-clef-d-api-secrete'})
r.json()
{'message': 'Unauthorized', 'http_status_code': 401}
Vos retours sont précieux pour nous, n’hésitez pas à partager vos expériences et suggestions - Contactez-nous

FAQ

Le retour de l’API est vide

Plusieurs cas de figure sont possibles : - Il n’existe pas de groupe de bâtiments BDNB dans cette zone. - L’identifiant n’existe pas dans les référentiels administratifs utilisés pour la création de la BDNB.

Pour vérifier si l’identifiant existe, il suffit d’interroger le référentiel correspondant. Prenons un example dans la liste des communes historiques de l’INSEE :

Création de la commune nouvelle d’Anizy-le-Grand en lieu et place des communes

  • d’Anizy-le-Château (02018)
  • de Faucoucourt (02301)
  • de Lizy (02434)

devenues déléguées. Date d’effet : 01/01/2019

import requests
r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/referentiel_administratif_commune',                 
                 params= {'limit': 10,
                          'select': 'code_commune_insee, code_departement_insee, libelle_commune',
                           'code_commune_insee': 'in.("02301","02434")'                                                   
                         }
                )
r.json()


r = requests.get(f'https://api.bdnb.io/v1/bdnb/donnees/referentiel_administratif_commune',                 
                 params= {'limit': 10,
                          'select': 'code_commune_insee, code_departement_insee, libelle_commune',
                           'code_commune_insee': 'eq.02018'                                                   
                         }
                )
r.json()

# >> [{'code_commune_insee': '02018',
#   'code_departement_insee': '02',
#   'libelle_commune': 'Anizy-le-Grand'}]
[{'code_commune_insee': '02018',
  'code_departement_insee': '02',
  'libelle_commune': 'Anizy-le-Grand'}]

Je ne dispose que de libellés, pas de code

Pour les utilisateurs avec une souscription expert, il est possible d’utiliser l’autocomplétion sur vos données textuelles :

import requests
import pandas as pd
from time import time
t0 = time()

r =  requests.get(f'https://api.bdnb.io/v1/bdnb/autocompletion',
                  params  = {'search_term':'Aniz',
                              'min_similarity': 0.2,
                              'limit_by_entite': 20,
                              'type_entite': 'eq.commune',
                              'select':'nom, code, type_entite, origine_nom, origine_code, similarity'
                            },
                 )
print(f"status : {r.status_code} | length of response : {len(r.json())}|  | {time()-t0}s")

pd.DataFrame(r.json())
# >> status : 200 | length of response : 3|  | 0.18 s
# >>
status : 200 | length of response : 3|  | 0.21194219589233398s
nom code type_entite origine_nom origine_code similarity
0 Anizy-le-Grand 02018 commune commune.libelle_commune commune.code_commune_insee 0.25
1 Banize 23016 commune commune.libelle_commune commune.code_commune_insee 0.20
2 Danizy 02260 commune commune.libelle_commune commune.code_commune_insee 0.20
nom code type_entite origine_nom origine_code similarity
0 Anizy-le-Grand 02018 commune commune.libelle_commune commune.code_commune_insee 0.25
1 Danizy 02260 commune commune.libelle_commune commune.code_commune_insee 0.2
2 Banize 23016 commune commune.libelle_commune commune.code_commune_insee 0.2