---
title: "Bâtiments autour d'un point ou sur une parcelle"
method: GET
path: "/parcelles/{id_parcelle}/batiments"
---

# Bâtiments autour d'un point ou sur une parcelle

`GET /parcelles/{id_parcelle}/batiments`

## Request

- Base URL: `https://pillr.fr/api/v1`
- URL: `https://pillr.fr/api/v1/parcelles/{id_parcelle}/batiments`
- Auth: HTTP bearer

Les bâtiments de la BD TOPO de l'IGN (service WFS de la Géoplateforme, en direct) autour d'un point, dans un rayon de 200 m au plus (50 m par défaut), ou sur une parcelle cadastrale : niveaux (estimés sur la hauteur quand la BD TOPO ne les donne pas, et la réponse le dit), hauteur, usage, nature, nombre de logements, emprise au sol et adresse BAN la plus proche. Avec un étage, chaque bâtiment dit s'il compte assez de niveaux. Coût : 2 crédits par appel réussi.

## Path parameters

- `id_parcelle` string, required: Identifiant cadastral de la parcelle sur 14 caractères : code INSEE, préfixe, section et numéro, ex. 35238000AB0123.

## Response `200`

Réponse servie et débitée (sauf réponse identique déjà servie dans les 24 h).

- object
  - `batiments` object[], required
    - `id` string, nullable, required: Identifiant BD TOPO du bâtiment.
    - `cle_ban` string, nullable, required: Clé BAN de l'adresse la plus proche (dans le bâtiment, sinon à 30 m au plus).
    - `adresse` string, nullable, required
    - `niveaux` integer, nullable, required: Nombre d'étages de la BD TOPO, sinon estimé sur la hauteur (3 m par niveau).
    - `niveaux_estimes` boolean, required: Vrai quand les niveaux sont estimés sur la hauteur.
    - `hauteur_m` number, nullable, required
    - `usage` string, nullable, required
    - `nature` string, nullable, required
    - `logements` integer, nullable, required
    - `emprise_m2` number, nullable, required: Emprise au sol, calculée sur la géométrie BD TOPO.
    - `compatible_etage` boolean, nullable, required: Avec le paramètre etage : vrai si le bâtiment compte au moins autant de niveaux que l'étage demandé (la BD TOPO peut sous-estimer les niveaux) ; null sans etage ou sans niveaux.
    - `distance_m` number, nullable, required: Distance du centre du bâtiment au point demandé (recherche par point).
    - `part_sur_parcelle` number, nullable, required: Part de l'emprise sur la parcelle, de 0 à 1 (recherche par parcelle).
    - `lat` number, nullable, required
    - `lon` number, nullable, required
  - `tronque` boolean, required: Vrai si la zone compte plus de bâtiments que ceux lus.
  - `qualite` object, required: Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.
    - `n` integer, nullable, required: Nombre d'observations derrière la valeur ; null si sans objet.
    - `provenance` 'mesure' | 'estime', nullable, required: mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.
    - `incertitude` object, nullable, required: Incertitude de la valeur : fourchette et demi-largeur.
      - `demi_largeur_pct` number, nullable, required: Demi-largeur de la fourchette, en % de la valeur.
      - `bas` number, nullable, required
      - `haut` number, nullable, required
    - `drapeaux` string[], required: Ce qui doit faire lire la valeur avec prudence ; vide si rien.
    - `methode` string, nullable, required: Méthode de calcul ou de rattachement, en clair.
    - `donnees_du` string, nullable, required: Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).
    - `source` string, required: Source publique ou moteur Pillr, en clair.
  - `credits` object, required: Crédits débités par cet appel (réservés, pour une tâche en cours), et crédits encore utilisables ce mois avant la coupure : crédits offerts, crédits inclus du mois et crédits facturables sous le plafond de dépense (null si inconnus ou en bac à sable).
    - `debites` integer, required
    - `restants` integer, nullable, required

## Other responses

- `304`: Non modifiée depuis l'ETag fourni : rien n'est débité.
- `400`: Paramètres invalides
- `401`: Clé d'API absente
- `402`: Crédits insuffisants ; Carte requise ; Plafond mensuel de dépense atteint
- `403`: Portée insuffisante
- `404`: Ressource absente : rien n'est débité
- `429`: Trop de requêtes par minute
- `500`: Erreur interne
- `503`: API indisponible ; Donnée momentanément indisponible

---

[API](https://skmtc.dev/pillr/apis/api-pillr.md) · [All operations](https://skmtc.dev/pillr/apis/api-pillr/llms.txt) · [OpenAPI document](https://skmtc.dev/pillr/apis/api-pillr/revisions/218b2866bd6c?raw)