Consultation d'un bâtiment

Consultation d'un bâtiment

Ce endpoint permet de récupérer l'ensemble des attributs d'un bâtiment à partir de son identifiant RNB. NB : l'URL se termine nécessairement par un slash (/).

GEThttps://rnb-api.beta.gouv.fr/api/alpha/buildings/{rnb_id}/

Path parameters

rnb_id*string

Identifiant unique du bâtiment dans le RNB

Example: "PG46YY6YWCX8"

Response

200

Détails du bâtiment

Body

application/json

rnb_idstring

Identifiant unique du bâtiment dans le RNB

Example: "PG46YY6YWCX8"

statusenum

Statut du bâtiment

Example: "constructed"

constructionProjectcanceledConstructionProjectongoingConstructionconstructedongoingChangenotUsabledemolished

pointobject

Coordonnées géographiques du bâtiment au format GeoJSON. Le système de référence géodésique est le WGS84.

shapeobject

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é:

addressesarray of BuildingAddress (object)

Liste des adresses du bâtiment

ext_idsarray of object

Le ou les identifiants de ce bâtiments au sein de la BD Topo et de la BDNB

Request

JavaScriptCurlPython

const response = await fetch('https://rnb-api.beta.gouv.fr/api/alpha/buildings/{rnb_id}/', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "rnb_id": "PG46YY6YWCX8",
  "status": "constructed",
  "point": {
    "type": "Point",
    "coordinates": [
      -0.570505392116188,
      44.841034137099996
    ]
  },
  "shape": {
    "type": "Point",
    "coordinates": [
      [
        -0.570505392116188,
        44.841034137099996
      ]
    ]
  },
  "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": 2191
    }
  ],
  "ext_ids": [
    {
      "id": "bdnb-bc-3B85-TYM9-FDSX",
      "source": "bdnb",
      "source_version": "2023_01",
      "created_at": "2023-12-07T13:20:58.310444+00:00"
    }
  ]
}