Listing de bâtiments

Ce endpoint permet de récupérer une liste paginée de bâtiments. Des filtres, notamment par code INSEE de la commune sont disponibles.

Endpoint

GET https://rnb-api.beta.gouv.fr/api/alpha/buildings/

Filtres de recherche

Les filtres de recherche sont à transmettre sous forme de paramètres d’url.

Exemple :

GET https://rnb-api.beta.gouv.fr/api/alpha/buildings/?insee_code=83071

Détails des filtres disponibles

Paramètre	Format	Défaut	Commentaire
bb	string	null	Recherche tous les bâtiments à contenus dans la bounding box demandée. Le format est nw_lat,nw_lng,se_lat,se_lng où : • nw_lat : latitude du point Nord Ouest de la bounding box • nw_lng : longitude du point Nord Ouest de la bounding box • se_lat : latitude du point Sud Est de la bounding box • se_lng : longitude du point Sud Est de la bounding box Les 4 valeurs sont des floats séparés par une virgule. Exemple : ”48.845782,2.424525,48.839201,2.434158”
status	string parmi choix restreint	ongoingConstruction,constructed,ongoingChange,notUsable	Récupère tous les bâtiments dont le statut actuel est un des statuts spécifiés. Choix possibles de statuts : Statuts réservés aux instructeurs d’autorisation du droit des sols. • constructionProject : Bâtiment en projet • canceledConstructionProject : Projet de bâtiment annulé Statuts publics • constructed : Bâtiment construit • ongoingChange : En cours de modification • notUsable : Non utilisable (ex : une ruine) • demolished : Démoli Vous pouvez spécifier plusieurs statuts en les séparant par des virgules.
insee_code	string	null	Recherche tous les bâtiments présents sur le territoire de la commune indiquée.
cursor	string	null	La chaîne de caractère permettant d'identifier la prochaine page de résultats. Le paramètre cursor est disponible dans les résultats de recherche au sein des urls contenues dans les attributs next et previous. Chaque page de résultat contient 20 bâtiments.

Exemple de réponse

{
    "next": "https://rnb-api.beta.gouv.fr/api/alpha/buildings/?cursor=cD02MzQ3OTk1", # Url d'accès à la proche page de résultats
    "previous": null,
    "results": [
        {
            "rnb_id": "QBAAG16VCJWA",
            "status": "constructed",
            "point": {
                "type": "Point",
                "coordinates": [
                    3.584410393780201,
                    49.52799819019749
                ]
            },
            "addresses": [
                {
                    "id": "02191_0020_00003", # Identifiant de l'adresse au sein de la Base Adresse Nationale (BAN)
                    "source": "bdnb",
                    "street_number": "3",
                    "street_rep": "",
                    "street_name": "de l'eglise",
                    "street_type": "rue",
                    "city_name": "Chivy-lès-Étouvelles",
                    "city_zipcode": "02000",
                    "city_insee_code": "02191"
                }
            ],
            "ext_ids": [ # Le ou les identifiants de ce bâtiments au sein de la BD Topo et de la BDNB
                {
                    "id": "bdnb-bc-3B85-TYM9-FDSX",
                    "source": "bdnb",
                    "created_at": "2023-12-07T13:20:58.310444+00:00",
                    "source_version": "2023_01"
                }
            ]
        },
        // ... tous les autres résultats de cette page
    ]
}