# Standard OGC API - Features

Les bâtiments du RNB sont accessibles au format OGC API - Features à cette adresse :&#x20;

```
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":{"$href":"#/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":["constructionProject","canceledConstructionProject","ongoingConstruction","constructed","ongoingChange","notUsable","demolished"]},"BuildingAddress":{"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"}}},"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","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"}}},"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."}}}}
```

## 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":{"$href":"#/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":["constructionProject","canceledConstructionProject","ongoingConstruction","constructed","ongoingChange","notUsable","demolished"]},"BuildingAddress":{"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"}}},"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","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"}}},"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."}}}}
```
