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.

A propos L'Open Geospatial Consortium (OGC) définit le standard OGC API - 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.

---

Racine de l'API du RNB au standard OGC

get

Ce endpoint est le point d'entrée pour exploiter les données RNB au standard OGC.

Réponses

200

Principaux liens disponibles dans l'API

application/json

titlestringOptionnel

descriptionstringOptionnel

linksarrayOptionnel

400

Requête invalide (données mal formatées ou incomplètes).

429

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. Veuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota.

get

/

HTTPcURLJavaScriptPython

GET /api/alpha/ogc/ HTTP/1.1
Host: rnb-api.beta.gouv.fr
Accept: */*

{
  "title": "text",
  "description": "text",
  "links": []
}

Déclaration de conformité de l'API du RNB au standard OGC

get

Liste les classes de conformité OGC auxquelles cette API adhère.

Réponses

200

Classes de conformité

application/json

conformsTostring[]Optionnel

400

Requête invalide (données mal formatées ou incomplètes).

429

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. Veuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota.

get

/conformance

HTTPcURLJavaScriptPython

GET /api/alpha/ogc/conformance HTTP/1.1
Host: rnb-api.beta.gouv.fr
Accept: */*

{
  "conformsTo": [
    "text"
  ]
}

Liste des collections de données

get

Ce endpoint liste les collections de données disponibles au standard OGC. Pour le moment, seuls les bâtiments sont disponibles.

Réponses

200

Liste des collections

Aucun contenu

400

Requête invalide (données mal formatées ou incomplètes).

429

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. Veuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota.

get

/collections

HTTPcURLJavaScriptPython

GET /api/alpha/ogc/collections HTTP/1.1
Host: rnb-api.beta.gouv.fr
Accept: */*

Aucun contenu

Métadonnées de la collection de bâtiments

get

Fournit des informations détaillées sur la collection de bâtiments.

Réponses

200

Métadonnées de la collection

Aucun contenu

400

Requête invalide (données mal formatées ou incomplètes).

429

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. Veuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota.

get

/collections/buildings

HTTPcURLJavaScriptPython

GET /api/alpha/ogc/collections/buildings HTTP/1.1
Host: rnb-api.beta.gouv.fr
Accept: */*

Aucun contenu

Liste des bâtiments

get

Récupère une liste de bâtiments sous forme de FeatureCollection GeoJSON.

Paramètres de requête

bboxarrayOptionnel

Filtre géographique par Bounding Box.

insee_codestringOptionnel

Filtre les bâtiments dont la géométrie est située dans les limites géographiques de la commune ayant ce code INSEE.

Example: 75101

limitinteger · min: 1 · max: 100Optionnel

Nombre maximum de bâtiments à retourner dans la page de résultats.

Default: 20Example: 50

Réponses

200

Une FeatureCollection (GeoJSON) de bâtiments. Les résultats sont paginés.

application/geo+json

typestringOptionnelExample: FeatureCollection

numberReturnedintegerOptionnel

Nombre de bâtiments retournés dans cette page de résultats.

Example: 20

timeStampstring · date-timeOptionnel

Horodatage de la génération de la réponse.

Example: 2025-12-25T13:37:00Z

linksobject[]Optionnel

Liens de pagination et autres liens associés.

400

Requête invalide (données mal formatées ou incomplètes).

429

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. Veuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota.

get

/collections/buildings/items

HTTPcURLJavaScriptPython

GET /api/alpha/ogc/collections/buildings/items HTTP/1.1
Host: rnb-api.beta.gouv.fr
Accept: */*

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          [
            -0.570505392116188,
            44.841034137099996
          ]
        ]
      },
      "id": "PG46YY6YWCX8",
      "properties": {
        "status": "constructed",
        "addresses": [
          {
            "id": "02191_0020_00003",
            "source": "bdnb",
            "street_number": "3",
            "street_rep": "bis",
            "street": "rue de l'église",
            "city_name": "Chivy-lès-Étouvelles",
            "city_zipcode": "02000",
            "city_insee_code": "02191"
          }
        ],
        "ext_ids": [
          {
            "id": "bdnb-bc-3B85-TYM9-FDSX",
            "source": "bdnb",
            "source_version": "2023_01",
            "created_at": "2023-12-07T13:20:58.310444+00:00"
          }
        ],
        "is_active": true,
        "plots": null
      }
    }
  ],
  "numberReturned": 20,
  "timeStamp": "2025-12-25T13:37:00Z",
  "links": [
    {}
  ]
}

Récupérer un bâtiment par son ID-RNB

get

Récupère un seul bâtiment en tant que Feature GeoJSON.

Paramètres de chemin

featureIdstringRequis

ID-RNB du bâtiment (rnb_id).

Réponses

200

Le bâtiment RNB au format GeoJSON.

application/geo+json

Représentation GeoJSON du bâtiment

typestringOptionnelExample: Feature

idstringOptionnel

Identifiant unique du bâtiment dans le RNB

Example: PG46YY6YWCX8

400

Requête invalide (données mal formatées ou incomplètes).

404

Bâtiment non trouvé.

429

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. Veuillez consulter les headers HTTP de la réponse pour plus d'informations concernant le quota.

get

/collections/buildings/items/{featureId}

HTTPcURLJavaScriptPython

GET /api/alpha/ogc/collections/buildings/items/{featureId} HTTP/1.1
Host: rnb-api.beta.gouv.fr
Accept: */*

{
  "type": "Feature",
  "geometry": {
    "type": "Point",
    "coordinates": [
      [
        -0.570505392116188,
        44.841034137099996
      ]
    ]
  },
  "id": "PG46YY6YWCX8",
  "properties": {
    "status": "constructed",
    "addresses": [
      {
        "id": "02191_0020_00003",
        "source": "bdnb",
        "street_number": "3",
        "street_rep": "bis",
        "street": "rue de l'église",
        "city_name": "Chivy-lès-Étouvelles",
        "city_zipcode": "02000",
        "city_insee_code": "02191"
      }
    ],
    "ext_ids": [
      {
        "id": "bdnb-bc-3B85-TYM9-FDSX",
        "source": "bdnb",
        "source_version": "2023_01",
        "created_at": "2023-12-07T13:20:58.310444+00:00"
      }
    ],
    "is_active": true,
    "plots": null
  }
}