# 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":{"$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":["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","format":"uuid","description":"Identifiant UUID de l'adresse au sein de la Base Adresse Nationale (BAN)","nullable":true},"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":["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","format":"uuid","description":"Identifiant UUID de l'adresse au sein de la Base Adresse Nationale (BAN)","nullable":true},"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."}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://rnb-fr.gitbook.io/documentation/api-et-outils/api-batiments/standard-ogc-api-features.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.