Listing de bâtiments

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]

Liste des batiments

get

Cet endpoint permet de récupérer une liste paginée de bâtiments. Des filtres, notamment par code INSEE de la commune, sont disponibles. NB : l'URL se termine nécessairement par un slash (/).

Paramètres de requête

insee_codestringOptionnel

Filtre les bâtiments dont l'emprise au sol est située dans les limites géographiques de la commune ayant ce code INSEE.

Example: 75101

statusstringOptionnel

Filtre les bâtiments par statut. Il est possible d'utiliser plusieurs valeurs séparées par des virgules. Les valeurs possibles sont : constructionProject : En projetcanceledConstructionProject : Projet annuléongoingConstruction : Construction en coursconstructed : ConstruitongoingChange : En cours de modificationnotUsable : Non utilisabledemolished : Démoli

Example: constructed,demolished

cle_interop_banstringOptionnel

Filtre les bâtiments associés à cette clé d'interopérabilité BAN.

Example: 94067_7115_00073

bbstringOptionnel

Filtre les bâtiments dont l'emprise au sol est située dans la bounding boxdéfinie par les coordonnées Nord-Ouest et Sud-Est. Les coordonnées sont séparées par des virgules. Le format est nw_lat,nw_lng,se_lat,se_lng où : nw_lat : latitude du point Nord Ouest de la bounding boxnw_lng : longitude du point Nord Ouest de la bounding boxse_lat : latitude du point Sud Est de la bounding boxse_lng : longitude du point Sud Est de la bounding box

Example: 48.845782,2.424525,48.839201,2.434158

withPlotsbooleanOptionnel

Inclure les parcelles intersectant les bâtiments de la réponse. Valeur attendue : 1. Chaque parcelle associée intersecte le bâtiment correspondant. Elle contient son identifiant ainsi que le taux de couverture du bâtiment.

Default: falseExample: 1

Réponses

200

Liste paginée de bâtiments

application/json

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/buildings/ HTTP/1.1
Host: rnb-api.beta.gouv.fr
Accept: */*

{
  "next": "https://rnb-api.beta.gouv.fr/api/alpha/buildings/?cursor=cD02MzQ3OTk1",
  "previous": "https://rnb-api.beta.gouv.fr/api/alpha/buildings/?cursor=hFG78YEdFR",
  "results": [
    {
      "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
        }
      ]
    }
  ]
}