Consultation d'un bâtiment

Tous nos points d'accès acceptent un paramètre optionnel supplémentaire from qui vous permet de renseigner une adresse mail. Celle-ci nous permettra de vous prévenir en cas de changement sur l'un des endpoints qui vous utilisez.

Par exemple : https://rnb-api.beta.gouv.fr/api/alpha/buildings/?from=[e-mail]

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"

Query parameters

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

plotsarray of object

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.

Request

JavaScriptCurlPythonHTTP

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"
    }
  ],
  "plots": [
    {
      "id": "01402000AB0051",
      "bdg_cover_ratio": 0.403
    }
  ]
}