> For the complete documentation index, see [llms.txt](https://rnb-fr.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments/standard-ogc-api-features.md).
# Standard OGC API - Features
Les bâtiments du RNB sont accessibles au format OGC API - Features à cette adresse :
```
https://rnb-api.beta.gouv.fr/api/alpha/ogc/
```
Cette URL est généralement suffisante pour accéder à l'ensemble des données de l'API. Les outils respectant le standard découvrent seuls ce qu'elle contient et vous proposeront d'accéder aux données des bâtiments.
Dans un souci d'exhaustivité, nous détaillons ci-dessous l'ensemble des endpoints disponibles.
{% hint style="info" %}
**A propos**\
L'Open Geospatial Consortium (OGC) définit le standard [OGC API - Features](https://ogcapi.ogc.org/features/) uniformisant la façon de distribuer et de lire des données géospatiales. Ce standard facilite l'utilisation des données du RNB dans des outils comme QGIS, FME ou ArcGIS.
{% endhint %}
***
## Racine de l'API du RNB au standard OGC
> Ce endpoint est le point d'entrée pour exploiter les données RNB au standard OGC.
```json
{"openapi":"3.1.0","info":{"title":"RNB OGC API","version":"ogc"},"servers":[{"url":"https://rnb-api.beta.gouv.fr/api/alpha/ogc"}],"paths":{"/":{"get":{"summary":"Racine de l'API du RNB au standard OGC","description":"Ce endpoint est le point d'entrée pour exploiter les données RNB au standard OGC.","responses":{"200":{"description":"Principaux liens disponibles dans l'API","content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"description":{"type":"string"},"links":{"type":"array"}}}}}},"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."}}}}}}
```
## Déclaration de conformité de l'API du RNB au standard OGC
> Liste les classes de conformité OGC auxquelles cette API adhère.
```json
{"openapi":"3.1.0","info":{"title":"RNB OGC API","version":"ogc"},"servers":[{"url":"https://rnb-api.beta.gouv.fr/api/alpha/ogc"}],"paths":{"/conformance":{"get":{"summary":"Déclaration de conformité de l'API du RNB au standard OGC","description":"Liste les classes de conformité OGC auxquelles cette API adhère.","responses":{"200":{"description":"Classes de conformité","content":{"application/json":{"schema":{"type":"object","properties":{"conformsTo":{"type":"array","items":{"type":"string"}}}}}}},"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."}}}}}}
```
## Liste des collections de données
> Ce endpoint liste les collections de données disponibles au standard OGC. Pour le moment, seuls les bâtiments sont disponibles.
```json
{"openapi":"3.1.0","info":{"title":"RNB OGC API","version":"ogc"},"servers":[{"url":"https://rnb-api.beta.gouv.fr/api/alpha/ogc"}],"paths":{"/collections":{"get":{"summary":"Liste des collections de données","description":"Ce endpoint liste les collections de données disponibles au standard OGC. Pour le moment, seuls les bâtiments sont disponibles.","responses":{"200":{"description":"Liste des collections"},"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."}}}}}}
```
## Métadonnées de la collection de bâtiments
> Fournit des informations détaillées sur la collection de bâtiments.
```json
{"openapi":"3.1.0","info":{"title":"RNB OGC API","version":"ogc"},"servers":[{"url":"https://rnb-api.beta.gouv.fr/api/alpha/ogc"}],"paths":{"/collections/buildings":{"get":{"summary":"Métadonnées de la collection de bâtiments","description":"Fournit des informations détaillées sur la collection de bâtiments.","responses":{"200":{"description":"Métadonnées de la collection"},"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."}}}}}}
```
## Liste des bâtiments
> Récupère une liste de bâtiments sous forme de FeatureCollection GeoJSON.
```json
{"openapi":"3.1.0","info":{"title":"RNB OGC API","version":"ogc"},"servers":[{"url":"https://rnb-api.beta.gouv.fr/api/alpha/ogc"}],"paths":{"/collections/buildings/items":{"get":{"summary":"Liste des bâtiments","description":"Récupère une liste de bâtiments sous forme de FeatureCollection GeoJSON.","parameters":[{"name":"bbox","in":"query","description":"Filtre géographique par Bounding Box.","schema":{"type":"array"},"style":"form"},{"name":"insee_code","in":"query","description":"Filtre les bâtiments dont la géométrie est située dans les limites géographiques de la commune ayant ce code INSEE.","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Nombre maximum de bâtiments à retourner dans la page de résultats.","required":false,"style":"form","schema":{"type":"integer","default":20,"maximum":100,"minimum":1}}],"responses":{"200":{"description":"Une FeatureCollection (GeoJSON) de bâtiments. Les résultats sont paginés.","content":{"application/geo+json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"features":{"type":"array","items":{"$ref":"#/components/schemas/BuildingGeoJSON"}},"numberReturned":{"type":"integer","description":"Nombre de bâtiments retournés dans cette page de résultats."},"timeStamp":{"type":"string","format":"date-time","description":"Horodatage de la génération de la réponse."},"links":{"type":"array","description":"Liens de pagination et autres liens associés.","items":{"type":"object"}}}}}}},"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."}}}}},"components":{"schemas":{"BuildingGeoJSON":{"type":"object","description":"Représentation GeoJSON du bâtiment","properties":{"type":{"type":"string"},"geometry":{"$ref":"#/components/schemas/BuildingShape"},"id":{"$ref":"#/components/schemas/RNBID"},"properties":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/BuildingStatus"},"addresses":{"type":"array","items":{"$ref":"#/components/schemas/BuildingAddress"}},"ext_ids":{"type":"array","items":{"$ref":"#/components/schemas/ExtId"}},"is_active":{"$ref":"#/components/schemas/BuildingIsActive"},"plots":{"$ref":"#/components/schemas/BuildingPlots"}}}}},"BuildingShape":{"type":"object","description":"Géométrie représentative du bâtiment. 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"}}}}]}}}},"RNBID":{"type":"string","description":"Identifiant unique du bâtiment dans le RNB"},"BuildingStatus":{"type":"string","description":"Statut du bâtiment","enum":["constructed","notUsable","demolished"]},"BuildingAddress":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de l'adresse au sein de la Base Adresse Nationale (BAN)"},"ban_id":{"type":["string","null"],"format":"uuid","description":"Identifiant UUID 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","null"],"description":"Numéro de la voie"},"street_rep":{"type":["string","null"],"description":"Indice de répétition du numéro de la voie"},"street":{"type":["string","null"],"description":"Nom de la voie"},"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"}}},"ExtId":{"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","null"],"description":"Version de la base de donnée contenant l'identifiant"},"created_at":{"type":"string","description":"Date de création du lien entre l'identifiant RNB et l'identfiant externe"}}},"BuildingIsActive":{"type":"boolean","description":"Indique si l'identifiant RNB est actif (True) ou inactif (False). Un identifiant inactif désigne un objet ne correspondant pas à la définition d'un bâtiment."},"BuildingPlots":{"type":"array","description":"Liste des parcelles cadastrales intersectant le bâtiment. Disponible si le paramètre withPlots=1
est intégré à l'URL de requête. NB: il s'agit d'un croisement géométrique et non d'une donnée fiscale. Il arrive parfois qu'un bâtiment intersecte une mauvaise parcelle du fait d'un décalage géographique entre les bâtiments du cadastre et ceux du RNB. Nous fournissons avec chaque parcelle cadastrale le taux d'intersection du bâtiment avec celle-ci. Les parcelles intersectant largement un bâtiment sont plus susceptibles d'être réellement associées à ce bâtiment d'un point de vue fiscal.","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de la parcelle."},"bdg_cover_ratio":{"type":"number","description":"Taux d'intersection du bâtiment par la parcelle. Ce taux est compris entre 0 et 1. Un taux de 1 signifie que la parcelle couvre entièrement le bâtiment."}}}}}}}
```
## Récupérer un bâtiment par son ID-RNB
> Récupère un seul bâtiment en tant que Feature GeoJSON.
```json
{"openapi":"3.1.0","info":{"title":"RNB OGC API","version":"ogc"},"servers":[{"url":"https://rnb-api.beta.gouv.fr/api/alpha/ogc"}],"paths":{"/collections/buildings/items/{featureId}":{"get":{"summary":"Récupérer un bâtiment par son ID-RNB","description":"Récupère un seul bâtiment en tant que Feature GeoJSON.","parameters":[{"name":"featureId","in":"path","required":true,"description":"ID-RNB du bâtiment (rnb_id).","schema":{"type":"string"}}],"responses":{"200":{"description":"Le bâtiment RNB au format GeoJSON.","content":{"application/geo+json":{"schema":{"$ref":"#/components/schemas/BuildingGeoJSON"}}}},"400":{"description":"Requête invalide (données mal formatées ou incomplètes)."},"404":{"description":"Bâtiment non trouvé."},"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."}}}}},"components":{"schemas":{"BuildingGeoJSON":{"type":"object","description":"Représentation GeoJSON du bâtiment","properties":{"type":{"type":"string"},"geometry":{"$ref":"#/components/schemas/BuildingShape"},"id":{"$ref":"#/components/schemas/RNBID"},"properties":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/BuildingStatus"},"addresses":{"type":"array","items":{"$ref":"#/components/schemas/BuildingAddress"}},"ext_ids":{"type":"array","items":{"$ref":"#/components/schemas/ExtId"}},"is_active":{"$ref":"#/components/schemas/BuildingIsActive"},"plots":{"$ref":"#/components/schemas/BuildingPlots"}}}}},"BuildingShape":{"type":"object","description":"Géométrie représentative du bâtiment. 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"}}}}]}}}},"RNBID":{"type":"string","description":"Identifiant unique du bâtiment dans le RNB"},"BuildingStatus":{"type":"string","description":"Statut du bâtiment","enum":["constructed","notUsable","demolished"]},"BuildingAddress":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de l'adresse au sein de la Base Adresse Nationale (BAN)"},"ban_id":{"type":["string","null"],"format":"uuid","description":"Identifiant UUID 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","null"],"description":"Numéro de la voie"},"street_rep":{"type":["string","null"],"description":"Indice de répétition du numéro de la voie"},"street":{"type":["string","null"],"description":"Nom de la voie"},"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"}}},"ExtId":{"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","null"],"description":"Version de la base de donnée contenant l'identifiant"},"created_at":{"type":"string","description":"Date de création du lien entre l'identifiant RNB et l'identfiant externe"}}},"BuildingIsActive":{"type":"boolean","description":"Indique si l'identifiant RNB est actif (True) ou inactif (False). Un identifiant inactif désigne un objet ne correspondant pas à la définition d'un bâtiment."},"BuildingPlots":{"type":"array","description":"Liste des parcelles cadastrales intersectant le bâtiment. Disponible si le paramètre withPlots=1
est intégré à l'URL de requête. NB: il s'agit d'un croisement géométrique et non d'une donnée fiscale. Il arrive parfois qu'un bâtiment intersecte une mauvaise parcelle du fait d'un décalage géographique entre les bâtiments du cadastre et ceux du RNB. Nous fournissons avec chaque parcelle cadastrale le taux d'intersection du bâtiment avec celle-ci. Les parcelles intersectant largement un bâtiment sont plus susceptibles d'être réellement associées à ce bâtiment d'un point de vue fiscal.","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifiant de la parcelle."},"bdg_cover_ratio":{"type":"number","description":"Taux d'intersection du bâtiment par la parcelle. Ce taux est compris entre 0 et 1. Un taux de 1 signifie que la parcelle couvre entièrement le bâtiment."}}}}}}}
```