# Rechercher un bâtiment

{% hint style="info" %}
Tous nos points d'accès acceptent un paramètre optionnel supplémentaire `from` qui vous permet de renseigner une adresse mail. Celle-ci nous permettra de vous prévenir en cas de changement sur l'un des endpoints qui vous utilisez.

Par exemple : [https://rnb-api.beta.gouv.fr/api/alpha/buildings/?from=xxx@exemple.fr](https://rnb-api.beta.gouv.fr/api/alpha/buildings/?from=xxx@exemple.fr)
{% endhint %}

## Bâtiments les plus proches d'un point

> Cet endpoint permet d'obtenir une liste paginée des bâtiments présents dans un rayon donné autour d'un point donné. Les bâtiments sont triés par distance croissante par rapport au point donné. NB : l'URL se termine nécessairement par un slash (/).

```json
{"openapi":"3.1.0","info":{"title":"API du Référentiel National des Bâtiments","version":"alpha"},"servers":[{"url":"https://rnb-api.beta.gouv.fr","description":"API du Référentiel National des Bâtiments"}],"paths":{"/api/alpha/buildings/closest/":{"get":{"summary":"Bâtiments les plus proches d'un point","description":"Cet endpoint permet d'obtenir une liste paginée des bâtiments présents dans un rayon donné autour d'un point donné. Les bâtiments sont triés par distance croissante par rapport au point donné. NB : l'URL se termine nécessairement par un slash (/).","operationId":"closestBuildings","parameters":[{"name":"point","in":"query","description":"Latitude et longitude, séparées par une virgule, du point de recherche.","required":true,"schema":{"type":"string"}},{"name":"radius","in":"query","description":"Rayon de recherche en mètres, autour du point. Compris entre 0 et 1000 mètres.","required":true,"schema":{"type":"number"}}],"responses":{"200":{"description":"Liste paginée des bâtiments les plus proches du point donné","content":{"application/json":{"schema":{"type":"object","properties":{"next":{"type":"string","description":"URL de la page de résultats suivante","nullable":true},"previous":{"type":"string","description":"URL de la page de résultats précédente","nullable":true},"results":{"type":"array","items":{"allOf":[{"type":"object","properties":{"rnb_id":{"type":"string","description":"Identifiant unique du bâtiment dans le RNB"},"status":{"type":"string","description":"Statut du bâtiment","enum":["constructionProject","canceledConstructionProject","ongoingConstruction","constructed","ongoingChange","notUsable","demolished"]},"point":{"type":"object","description":"Coordonnées géographiques du bâtiment au format GeoJSON. Le système de référence géodésique est le WGS84.","properties":{"type":{"type":"string"},"coordinates":{"type":"array","items":{"type":"number"}}}},"shape":{"type":"object","description":"Géométrie du bâtiment au format GeoJSON. Le système de référence géodésique est le WGS84. Elle peut être un multipolygone, un polygone ou un point et correspond notre meilleure connaissance de la réalité:","properties":{"type":{"type":"string","enum":["Point","Polygon","MultiPolygon"]},"coordinates":{"type":"array","items":{"oneOf":[{"type":"array","description":"Coordonnées pour un Point","items":{"type":"number"}},{"type":"array","description":"Coordonnées pour un Polygon","items":{"type":"array","items":{"type":"number"}}},{"type":"array","description":"Coordonnées pour un MultiPolygon","items":{"type":"array","items":{"type":"array","items":{"type":"number"}}}}]}}}},"addresses":{"type":"array","description":"Liste des adresses du bâtiment","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de l'adresse au sein de la Base Adresse Nationale (BAN)"},"source":{"type":"string","description":"Source du lien bâtiment ↔ adresse"},"street_number":{"type":"string","description":"Numéro de la voie","nullable":true},"street_rep":{"type":"string","description":"Indice de répétition du numéro de la voie","nullable":true},"street":{"type":"string","description":"Nom de la voie","nullable":true},"city_name":{"type":"string","description":"Nom de la commune"},"city_zipcode":{"type":"string","description":"Code postal de la commune"},"city_insee_code":{"type":"string","description":"Code INSEE de la commune"}}}},"ext_ids":{"type":"array","description":"Le ou les identifiants de ce bâtiments au sein de la BD Topo et de la BDNB","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de ce bâtiment au sein de la BD Topo ou de la BDNB"},"source":{"type":"string","description":"Base de donnée contenant de l'identifiant"},"source_version":{"type":"string","description":"Version de la base de donnée contenant l'identifiant","nullable":true},"created_at":{"type":"string","description":"Date de création du lien entre l'identifiant RNB et l'identfiant externe"}}}}}},{"type":"object","properties":{"distance":{"type":"number","format":"float","description":"Distance en mètres entre le bâtiment et le point donné"}}}]}}}}}}},"400":{"description":"Requête invalide (données mal formatées ou incomplètes)."},"429":{"description":"Le quota de requêtes a été atteint. Un quota maximal de 20 requêtes par secondes est appliqué, mais celui-ci peut varier par requête.\nVeuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota."}}}}}}
```

## Identification de bâtiments par leur adresse

> Cet endpoint permet d'obtenir une liste paginée des bâtiments associés à une adresse. NB : l'URL se termine nécessairement par un slash (/).

```json
{"openapi":"3.1.0","info":{"title":"API du Référentiel National des Bâtiments","version":"alpha"},"servers":[{"url":"https://rnb-api.beta.gouv.fr","description":"API du Référentiel National des Bâtiments"}],"paths":{"/api/alpha/buildings/address/":{"get":{"summary":"Identification de bâtiments par leur adresse","description":"Cet endpoint permet d'obtenir une liste paginée des bâtiments associés à une adresse. NB : l'URL se termine nécessairement par un slash (/).","operationId":"address","parameters":[{"name":"q","in":"query","description":"Adresse texte non structurée. L'adresse fournie est recherchée dans la BAN afin de récupérer la clé d'interopérabilité associée. C'est via cette clé que sont filtrés les bâtiments. Si le geocodage échoue aucun résultat n'est renvoyé et le champ **status** de la réponse contient **geocoding_no_result**","required":false,"schema":{"type":"string"}},{"name":"min_score","in":"query","description":"Score minimal attendu du géocodage BAN. Valeur par défaut : **0.8**. Si le score est strictement inférieur à cette limite, aucun résultat n'est renvoyé et le champ **status** de la réponse contient **geocoding_score_is_too_low**","required":false,"schema":{"type":"float"}},{"name":"cle_interop_ban","in":"query","description":"Clé d'interopérabilité BAN. Si vous êtes en possession d'une clé d'interoperabilité, il est plus efficace de faire une recherche grâce à elle que via une adresse textuelle.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Liste paginée des bâtiments associés à l'adresse donnée.","content":{"application/json":{"schema":{"type":"object","properties":{"next":{"type":"string","description":"URL de la page de résultats suivante","nullable":true},"previous":{"type":"string","description":"URL de la page de résultats précédente","nullable":true},"cle_interop_ban":{"type":"string","description":"Clé d'interopérabilité BAN utilisée pour lister les bâtiments","nullable":true},"status":{"type":"string","description":"'geocoding_score_is_too_low' si le géocodage BAN renvoie un score inférieur à 'min_score'. 'geocoding_no_result' si le géocodage ne renvoie pas de résultats. 'ok' sinon","nullable":false},"score_ban":{"type":"float","description":"Si un géocodage a lieu, renvoie le score du meilleur résultat, celui utilisé pour lister les bâtiments. Ce score doit être supérieur à 'min_score' pour que des bâtiments soient renvoyés.","nullable":false},"results":{"type":"array","nullable":true,"items":{"type":"object","properties":{"rnb_id":{"type":"string","description":"Identifiant unique du bâtiment dans le RNB"},"status":{"type":"string","description":"Statut du bâtiment","enum":["constructionProject","canceledConstructionProject","ongoingConstruction","constructed","ongoingChange","notUsable","demolished"]},"point":{"type":"object","description":"Coordonnées géographiques du bâtiment au format GeoJSON. Le système de référence géodésique est le WGS84.","properties":{"type":{"type":"string"},"coordinates":{"type":"array","items":{"type":"number"}}}},"shape":{"type":"object","description":"Géométrie du bâtiment au format GeoJSON. Le système de référence géodésique est le WGS84. Elle peut être un multipolygone, un polygone ou un point et correspond notre meilleure connaissance de la réalité:","properties":{"type":{"type":"string","enum":["Point","Polygon","MultiPolygon"]},"coordinates":{"type":"array","items":{"oneOf":[{"type":"array","description":"Coordonnées pour un Point","items":{"type":"number"}},{"type":"array","description":"Coordonnées pour un Polygon","items":{"type":"array","items":{"type":"number"}}},{"type":"array","description":"Coordonnées pour un MultiPolygon","items":{"type":"array","items":{"type":"array","items":{"type":"number"}}}}]}}}},"addresses":{"type":"array","description":"Liste des adresses du bâtiment","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de l'adresse au sein de la Base Adresse Nationale (BAN)"},"source":{"type":"string","description":"Source du lien bâtiment ↔ adresse"},"street_number":{"type":"string","description":"Numéro de la voie","nullable":true},"street_rep":{"type":"string","description":"Indice de répétition du numéro de la voie","nullable":true},"street":{"type":"string","description":"Nom de la voie","nullable":true},"city_name":{"type":"string","description":"Nom de la commune"},"city_zipcode":{"type":"string","description":"Code postal de la commune"},"city_insee_code":{"type":"string","description":"Code INSEE de la commune"}}}},"ext_ids":{"type":"array","description":"Le ou les identifiants de ce bâtiments au sein de la BD Topo et de la BDNB","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de ce bâtiment au sein de la BD Topo ou de la BDNB"},"source":{"type":"string","description":"Base de donnée contenant de l'identifiant"},"source_version":{"type":"string","description":"Version de la base de donnée contenant l'identifiant","nullable":true},"created_at":{"type":"string","description":"Date de création du lien entre l'identifiant RNB et l'identfiant externe"}}}}}}}}}}}},"400":{"description":"Requête invalide (données mal formatées ou incomplètes)."},"429":{"description":"Le quota de requêtes a été atteint. Un quota maximal de 20 requêtes par secondes est appliqué, mais celui-ci peut varier par requête.\nVeuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota."}}}}}}
```

## Bâtiments sur une parcelle cadastrale

> Cet endpoint permet d'obtenir une liste paginée des bâtiments présents sur une parcelle cadastrale. Les bâtiments sont triés par taux de recouvrement décroissant entre le bâtiment et la parcelle (le bâtiment entièrement sur une parcelle arrive avant celui à moitié sur la parcelle). La méthode de filtrage est purement géométrique et ne tient pas compte du lien fiscal entre le bâtiment et la parcelle. Des faux positifs sont donc possibles. NB : l'URL se termine nécessairement par un slash (/).

```json
{"openapi":"3.1.0","info":{"title":"API du Référentiel National des Bâtiments","version":"alpha"},"servers":[{"url":"https://rnb-api.beta.gouv.fr","description":"API du Référentiel National des Bâtiments"}],"paths":{"/api/alpha/buildings/plot/{plot_id}/":{"get":{"summary":"Bâtiments sur une parcelle cadastrale","description":"Cet endpoint permet d'obtenir une liste paginée des bâtiments présents sur une parcelle cadastrale. Les bâtiments sont triés par taux de recouvrement décroissant entre le bâtiment et la parcelle (le bâtiment entièrement sur une parcelle arrive avant celui à moitié sur la parcelle). La méthode de filtrage est purement géométrique et ne tient pas compte du lien fiscal entre le bâtiment et la parcelle. Des faux positifs sont donc possibles. NB : l'URL se termine nécessairement par un slash (/).","operationId":"plotBuildings","parameters":[{"name":"plot_id","in":"path","description":"Identifiant de la parcelle cadastrale.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Liste paginée des bâtiments présents sur la parcelle cadastrale","content":{"application/json":{"schema":{"type":"object","properties":{"next":{"type":"string","description":"URL de la page de résultats suivante","nullable":true},"previous":{"type":"string","description":"URL de la page de résultats précédente","nullable":true},"results":{"type":"array","items":{"allOf":[{"type":"object","properties":{"rnb_id":{"type":"string","description":"Identifiant unique du bâtiment dans le RNB"},"status":{"type":"string","description":"Statut du bâtiment","enum":["constructionProject","canceledConstructionProject","ongoingConstruction","constructed","ongoingChange","notUsable","demolished"]},"point":{"type":"object","description":"Coordonnées géographiques du bâtiment au format GeoJSON. Le système de référence géodésique est le WGS84.","properties":{"type":{"type":"string"},"coordinates":{"type":"array","items":{"type":"number"}}}},"shape":{"type":"object","description":"Géométrie du bâtiment au format GeoJSON. Le système de référence géodésique est le WGS84. Elle peut être un multipolygone, un polygone ou un point et correspond notre meilleure connaissance de la réalité:","properties":{"type":{"type":"string","enum":["Point","Polygon","MultiPolygon"]},"coordinates":{"type":"array","items":{"oneOf":[{"type":"array","description":"Coordonnées pour un Point","items":{"type":"number"}},{"type":"array","description":"Coordonnées pour un Polygon","items":{"type":"array","items":{"type":"number"}}},{"type":"array","description":"Coordonnées pour un MultiPolygon","items":{"type":"array","items":{"type":"array","items":{"type":"number"}}}}]}}}},"addresses":{"type":"array","description":"Liste des adresses du bâtiment","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de l'adresse au sein de la Base Adresse Nationale (BAN)"},"source":{"type":"string","description":"Source du lien bâtiment ↔ adresse"},"street_number":{"type":"string","description":"Numéro de la voie","nullable":true},"street_rep":{"type":"string","description":"Indice de répétition du numéro de la voie","nullable":true},"street":{"type":"string","description":"Nom de la voie","nullable":true},"city_name":{"type":"string","description":"Nom de la commune"},"city_zipcode":{"type":"string","description":"Code postal de la commune"},"city_insee_code":{"type":"string","description":"Code INSEE de la commune"}}}},"ext_ids":{"type":"array","description":"Le ou les identifiants de ce bâtiments au sein de la BD Topo et de la BDNB","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de ce bâtiment au sein de la BD Topo ou de la BDNB"},"source":{"type":"string","description":"Base de donnée contenant de l'identifiant"},"source_version":{"type":"string","description":"Version de la base de donnée contenant l'identifiant","nullable":true},"created_at":{"type":"string","description":"Date de création du lien entre l'identifiant RNB et l'identfiant externe"}}}}}},{"type":"number","name":"bdg_cover_ratio","description":"Taux d'intersection entre le bâtiment et la parcelle. Ce taux est compris entre 0 et 1. Un taux de 1 signifie que la parcelle couvre entièrement le bâtiment."}]}}}}}}},"400":{"description":"Requête invalide (données mal formatées ou incomplètes)."},"429":{"description":"Le quota de requêtes a été atteint. Un quota maximal de 20 requêtes par secondes est appliqué, mais celui-ci peut varier par requête.\nVeuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota."}}}}}}
```

####
