LogoLogo
Site du RNBGithub
  • Documentation du Référentiel National du Bâtiment (RNB)
  • API et Outils
    • 🛍️Liste des API et outils du RNB
    • 🗺️Tuiles vectorielles
    • 🏨API Bâtiments
      • Consultation d'un bâtiment
      • Listing de bâtiments
      • Identification de bâtiment
      • Différentiel entre deux dates
      • Éditer le RNB
        • Guide d'édition du RNB
    • 🏗️API ADS
    • 🏙️Export national et départemental
    • 🏖️Bac à sable
  • Exemples
    • 🗃️Obtenir des attributs métier à partir d'un identifiant RNB (ID-RNB)
    • 🏪Sélecteur de bâtiments
  • Lexique et définitions
    • 📐Propriétés d'un bâtiment
      • Parcelles cadastrales
  • 📝Lexique du RNB
  • 🪡Cycle de vie de la donnée
  • A propos
    • 🪙Budget
  • 📞Contacter le RNB
Propulsé par GitBook
Sur cette page

Cet article vous a-t-il été utile ?

  1. API et Outils
  2. API Bâtiments

Listing de bâtiments

PrécédentConsultation d'un bâtimentSuivantIdentification de bâtiment

Dernière mise à jour il y a 4 mois

Cet article vous a-t-il été utile ?

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=xxx@exemple.fr

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
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
        }
      ]
    }
  ]
}