Aller au contenu

Documentation

Démarches et dossiers

De la formalité au dossier de dépôt complet : démarche, croquis, coupes, Cerfa, échéances, rendu. 8 opérations servies.

Démarche d'urbanisme d'un projet

Essayer en direct
POST/api/v1/urbanisme/demarche

Démarche d'urbanisme d'un projet de travaux décrit, sans adresse : formalité (aucune, déclaration préalable, permis de construire, d'aménager ou de démolir), formulaire Cerfa, architecte obligatoire ou non, pièces du dossier avec l'opération qui les prépare, délai d'instruction et valeur du silence de la mairie, taxe d'aménagement estimée (aux taux votés par la commune quand son code INSEE est donné, sinon en fourchette du barème légal) et redevance d'archéologie préventive, chaque conclusion avec sa règle et sa source, et la date de la base de règles. Un fait manquant revient en question, jamais en supposition. La zone du PLU et les servitudes ne sont pas lues : les protections du terrain se déclarent en paramètres (urbanisme_adresse les donne pour une adresse). Information générale, ni conseil juridique ni décision de la mairie.

Coût
1 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
urbanisme
Outil MCP
demarche_urbanisme
Bac à sable
Oui, sans débit, sur un jeu figé
Cache serveur
24 h
Délai maximal
3 s

Paramètres

  • type_travauxtexteobligatoire

    Nature des travaux. Une annexe séparée est une construction_nouvelle ; une extension ou une véranda accolée, des travaux_existant.

    Valeurs : construction_nouvelle, travaux_existant, transformation_garage, piscine, cloture, mur, aspect_exterieur, pompe_a_chaleur, ravalement, changement_destination, division, demolition

  • emprise_au_sol_creee_m2nombre

    Emprise au sol créée, en m² (un carport ou un garage compte même sans surface de plancher).

    de 0 à 1 000 000

  • surface_plancher_creee_m2nombre

    Surface de plancher créée, ou surface close transformée pour un garage, en m².

    de 0 à 1 000 000

  • hauteur_mnombre

    Hauteur de la construction ou du mur, en mètres.

    de 0 à 1 000 000

  • surface_plancher_existante_m2nombre

    Surface de plancher du bâtiment existant, en m².

    de 0 à 1 000 000

  • emprise_au_sol_existante_m2nombre

    Emprise au sol du bâtiment existant, en m².

    de 0 à 1 000 000

  • modifie_aspect_exterieurbooléen
  • modifie_volumebooléen
  • visible_espace_publicbooléen
  • bassin_m2nombre

    Piscine : surface du bassin, en m².

    de 0 à 1 000 000

  • hauteur_couverture_mnombre

    Piscine : hauteur de la couverture en mètres, 0 si non couverte.

    de 0 à 1 000 000

  • piscine_demontablebooléen
  • duree_installation_moisnombre

    Piscine démontable : mois d'installation par an.

    de 0 à 1 000 000

  • duree_installation_joursnombre

    Piscine démontable en espace protégé : jours d'installation par an.

    de 0 à 1 000 000

  • deliberation_communalebooléen

    La commune a soumis clôtures ou ravalements à déclaration par délibération.

  • secteur_cloture_plubooléen

    Clôture dans un secteur délimité par le PLU.

  • reparation_a_l_identiquebooléen
  • pac_visiblebooléen

    Pompe à chaleur visible depuis l'espace public, la voie ou les autres bâtiments.

  • date_debut_travauxtexte

    Date de début des travaux, si elle est passée.

  • ravalement_change_couleursbooléen
  • changementtexte

    Valeurs : destination, sous_destination

  • travaux_structure_ou_facadebooléen
  • equipements_communsbooléen

    Division : création de voies, espaces ou équipements communs.

  • date_depottexte

    Division : date de dépôt prévue (par défaut, aujourd'hui).

  • permis_demolir_instituebooléen
  • restauration_immobilierebooléen
  • inclut_demolitionbooléen
  • demandeurtexte

    Qui dépose la demande (une SCI est une société).

    Valeurs : personne_physique, exploitation_agricole, societe

  • maison_individuellebooléen
  • serre_productionbooléen
  • hauteur_pied_droit_mnombre

    Serre : hauteur du pied-droit, en mètres.

    de 0 à 1 000 000

  • erp_ou_ighbooléen

    Établissement recevant du public ou immeuble de grande hauteur.

  • participation_du_publicbooléen
  • evaluation_environnementalebooléen
  • sprbooléen

    Terrain en site patrimonial remarquable.

  • abords_monument_historiquebooléen

    Terrain aux abords d'un monument historique.

  • site_classebooléen
  • site_inscritbooléen
  • reserve_naturellebooléen
  • element_protege_plubooléen

    Bâtiment ou élément protégé par le PLU.

  • monument_historiquebooléen

    Travaux sur un monument historique.

  • coeur_parc_nationalbooléen
  • document_urbanismetexte

    Document d'urbanisme de la commune.

    Valeurs : plu, carte_communale, rnu

  • zone_urbainebooléen

    Terrain en zone urbaine du PLU.

  • surface_taxable_creee_m2nombre

    Taxe d'aménagement : surface taxable créée, en m².

    de 0 à 1 000 000

  • surface_taxable_existante_m2nombre

    Taxe d'aménagement : surface taxable existante, en m².

    de 0 à 1 000 000

  • places_stationnement_exterieuresnombre

    Taxe d'aménagement : places de stationnement extérieures créées.

    de 0 à 1 000 000

  • residence_principalebooléen

    Taxe d'aménagement : le projet porte sur la résidence principale ou ses annexes (abattement).

  • affecte_sous_solbooléen

    Redevance d'archéologie préventive : les travaux affectent le sous-sol.

  • code_inseetexte

    Commune du terrain, pour ses taux de taxe d'aménagement ; sans elle, l'estimation reste une fourchette du barème légal.

  • taux_communal_pctnombre

    Taux communal de la taxe d'aménagement, en %, s'il est connu (il prime sur celui de la commune).

    de 0 à 20

  • taux_departemental_pctnombre

    Taux départemental de la taxe d'aménagement, en %, s'il est connu.

    de 0 à 5

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/urbanisme/demarche \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"type_travaux":"construction_nouvelle","emprise_au_sol_creee_m2":18,"surface_plancher_creee_m2":18}'

Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.

Réponse du bac à sable

{
  "statut": "faits_manquants",
  "regles_a_jour_le": "2026-09-17",
  "projet": {
    "type_travaux": "construction_nouvelle",
    "libelle": "Construction nouvelle (abri, garage, carport, annexe séparée)",
    "faits": [
      "Emprise au sol créée : 18 m²",
      "Surface de plancher créée : 18 m²"
    ]
  },
  "contexte": {
    "document": null,
    "zone_urbaine": null,
    "protections": {
      "spr": null,
      "abords_monument_historique": null,
      "site_classe": null,
      "site_inscrit": null,
      "reserve_naturelle": false,
      "element_protege_plu": null,
      "monument_historique": false,
      "coeur_parc_national": false
    },
    "detection": "Sans adresse : la zone du PLU et les servitudes ne sont pas lues. Les protections prises en compte sont celles déclarées dans les paramètres.",
    "details": []
  },
  "faits_manquants": [
    "Quelle sera sa hauteur, en mètres ?"
  ],
  "questions": [
    {
      "fait": "hauteur_m",
      "question": "Quelle sera sa hauteur, en mètres ?",
      "options": null,
      "choix_multiple": false
    }
  ],
  "formalite": null,
  "formalites_associees": [],
  "cerfa": null,
  "architecte": null,
  "pieces": [],
  "delai": null,
  "apres_decision": [],
  "depot_en_ligne": [],
  "taxe_amenagement": null,
  "a_confirmer": false,
  "notes_a_confirmer": [],
  "limites": [
    "Information générale établie d'après les textes en vigueur au 17 septembre 2026 : ni un conseil juridique, ni une décision de l'administration.",
    "Le résultat dépend des informations que vous avez données ; vous restez responsable de votre demande et de l'exactitude du dossier déposé.",
    "Le PLU, une délibération communale ou une protection (monument historique, site, risques) peuvent imposer une autre formalité : faites confirmer par le service urbanisme de votre mairie avant tout dépôt.",
    "Pour une réponse qui engage l'administration, demandez un certificat d'urbanisme : les règles sont figées si votre demande est déposée dans les 18 mois.",
    "Les croquis générés sont des brouillons indicatifs : vérifiez chaque cote, ils ne remplacent ni un relevé ni des plans établis par un professionnel.",
    "Au-delà de 150 m² de surface de plancher après travaux, ou si le demandeur est une société, un architecte est obligatoire pour le permis de construire : Pillr ne produit pas ces plans."
  ],
  "sources": [],
  "credits": {
    "debites": 0,
    "restants": null
  }
}

Réponse réelle de l'API à cette entrée, obtenue avec le moteur du bac à sable, donnée du 17/09/2026.

Réponse

  • statuttexte

    faits_manquants : la formalité ou le permis ne peuvent pas être établis sans les réponses de questions.

    Valeurs : conclusion, faits_manquants

  • regles_a_jour_letexte

    Date de vérification de la base de règles.

  • projetobjet
    Afficher les 3 champs
    • type_travauxtexte

      Valeurs : construction_nouvelle, travaux_existant, transformation_garage, piscine, cloture, mur, aspect_exterieur, pompe_a_chaleur, ravalement, changement_destination, division, demolition

    • libelletexte
    • faitsliste de textes
  • contexteobjet
    Afficher les 5 champs
    • documenttexte ou null

      Valeurs : plu, carte_communale, rnu

    • zone_urbainebooléen ou null
    • protectionsobjet
      Afficher les 8 champs
      • sprbooléen ou null
      • abords_monument_historiquebooléen ou null
      • site_classebooléen ou null
      • site_inscritbooléen ou null
      • reserve_naturellebooléen ou null
      • element_protege_plubooléen ou null
      • monument_historiquebooléen ou null
      • coeur_parc_nationalbooléen ou null
    • detectiontexte
    • detailsliste de textes
  • faits_manquantsliste de textes
  • questionsliste d'objets
    Afficher les 4 champs
    • faittexte

      Le paramètre qui reçoit la réponse.

    • questiontexte
    • optionsliste d'objets ou null
      Afficher les 2 champs
      • libelletexte
      • descriptiontexte ou null
    • choix_multiplebooléen
  • formaliteobjet ou null
    Afficher les 6 champs
    • codetexte

      Valeurs : aucune, declaration_prealable, permis_de_construire, permis_d_amenager, permis_de_demolir

    • libelletexte
    • regletexte
    • sourcesliste de textes
    • a_confirmerbooléen
    • notesliste de textes
  • formalites_associeesliste d'objets
    Afficher les 4 champs
    • regletexte
    • sourcesliste de textes
    • a_confirmerbooléen
    • notesliste de textes
  • cerfaobjet ou null
    Afficher les 4 champs
    • numerotexte
    • libelletexte
    • notesliste de textes
    • sourcesliste de textes
  • architecteobjet ou null
    Afficher les 6 champs
    • obligatoirebooléen ou null

      null : ne se prononce pas (faits manquants ou cas hors de la base de règles).

    • manqueliste de textes
    • regletexte
    • sourcesliste de textes
    • a_confirmerbooléen
    • notesliste de textes
  • piecesliste d'objets
    Afficher les 7 champs
    • codetexte ou null
    • libelletexte
    • conditiontexte
    • exigeetexte

      Valeurs : oui, selon_le_projet

    • sourcesliste de textes
    • a_confirmerbooléen
    • operationtexte ou null

      L'opération de Pillr Data qui prépare la pièce ; null quand Pillr ne la prépare pas (photos, insertion).

      Valeurs : croquis_projet, coupes_facades, generer_document

  • delaiobjet ou null
    Afficher les 8 champs
    • moisnombre ou null
    • base_moisnombre ou null
    • detailliste de textes
    • prolongations_possiblesliste de textes
    • silencetexte

      Ce que vaut le silence de la mairie au terme du délai.

      Valeurs : acceptation, refus

    • refus_tacite_siliste de textes
    • sourcesliste de textes
    • a_confirmerbooléen
  • apres_decisionliste d'objets
    Afficher les 3 champs
    • etapetexte
    • sourcesliste de textes
    • a_confirmerbooléen
  • depot_en_ligneliste d'objets
    Afficher les 3 champs
    • etapetexte
    • sourcesliste de textes
    • a_confirmerbooléen
  • taxe_amenagementobjet ou null

    Taxe d'aménagement estimée, avec la redevance d'archéologie préventive ; null tant que la formalité n'est pas établie.

    Afficher les 20 champs
    • statuttexte

      Valeurs : estimee, non_due, hors_calcul, faits_manquants

    • regletexte
    • annee_valeursentier
    • a_jour_letexte
    • formuletexte
    • valeursliste d'objets
      Afficher les 3 champs
      • libelletexte
      • valeurtexte
      • sourcesliste de textes
    • assietteliste d'objets
      Afficher les 5 champs
      • libelletexte
      • calcultexte
      • minnombre
      • maxnombre
      • sourcesliste de textes
    • assiette_minnombre
    • assiette_maxnombre
    • partsliste d'objets
      Afficher les 9 champs
      • parttexte

        Valeurs : communale, departementale, regionale

      • libelletexte
      • tauxtexte
      • taux_minnombre
      • taux_maxnombre
      • montant_minnombre
      • montant_maxnombre
      • sourcetexte
      • a_confirmerbooléen
    • total_minnombre

      Taxe estimée, borne basse, en euros.

    • total_maxnombre

      Taxe estimée, borne haute, en euros.

    • archeologieobjet ou null
      Afficher les 6 champs
      • statuttexte

        Valeurs : due, si_sous_sol, non_due

      • taux_pctnombre
      • montant_minnombre
      • montant_maxnombre
      • regletexte
      • sourcesliste de textes
    • faits_manquantsliste de textes
    • notesliste de textes
    • a_confirmerbooléen
    • declarationliste d'objets
      Afficher les 2 champs
      • etapetexte
      • sourcesliste de textes
    • sourcesliste de textes
    • limitesliste de textes
    • qualiteobjet

      Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

      Afficher les 7 champs
      • nentier ou null

        Nombre d'observations derrière la valeur ; null si sans objet.

        0 au moins

      • provenancetexte ou null

        mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

        Valeurs : mesure, estime

      • incertitudeobjet ou null

        Incertitude de la valeur : fourchette et demi-largeur.

        Afficher les 3 champs
        • demi_largeur_pctnombre ou null

          Demi-largeur de la fourchette, en % de la valeur.

        • basnombre ou null
        • hautnombre ou null
      • drapeauxliste de textes

        Ce qui doit faire lire la valeur avec prudence ; vide si rien.

        Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

      • methodetexte ou null

        Méthode de calcul ou de rattachement, en clair.

      • donnees_dutexte ou null

        Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

      • sourcetexte

        Source publique ou moteur Pillr, en clair.

  • a_confirmerbooléen

    Vrai si une conclusion est à faire confirmer par le service urbanisme de la mairie.

  • notes_a_confirmerliste de textes
  • limitesliste de textes
  • sourcesliste de textes
  • creditsobjet

    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).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Plan de situation, plan de masse et implantation

Essayer en direct
POST/api/v1/urbanisme/croquis

Le plan de situation et le plan de masse coté d'un projet (extension, annexe, abri, garage, carport, piscine, terrasse, véranda) sur la parcelle cadastrale et les bâtiments de la BD TOPO de l'IGN, lus en direct, pour une adresse, un identifiant de parcelle ou un point. Les projets se placent contre un côté du bâtiment principal, à une distance d'une limite, par un contour donné, ou automatiquement : trois emplacements notés sur l'ensoleillement au 21 juin et au 21 mars, les distances, le relief et les limites. La réponse donne les emprises et les mesures, les alertes (débord, chevauchement), la formalité établie depuis les projets dessinés, la zone du PLU et les servitudes lues en un point de la parcelle, les règles du règlement déjà lu (reculs, emprise, hauteur) et les vues du plan de situation. Le plan de masse n'est pas dessiné quand un architecte est obligatoire ou que des faits manquent : la réponse le dit, avec les questions. Croquis indicatif, à vérifier avant dépôt.

Coût
20 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
urbanisme
Outil MCP
croquis_projet
Bac à sable
Non
Cache serveur
1 h
Délai maximal
45 s

Paramètres

  • adressetexte

    Adresse en texte, numéro compris, géocodée par la Base Adresse Nationale.

    de 5 à 200 caractères

  • code_postaltexte

    Code postal, pour départager une adresse homonyme (avec adresse).

  • idutexte

    Identifiant de la parcelle cadastrale à 14 caractères (ex. 69382000AB0050).

    de 14 à 24 caractères

  • latnombre

    de -90 à 90

  • lonnombre

    de -180 à 180

  • recul_limites_mnombre

    Implantation automatique : recul aux limites, en mètres (sinon celui du règlement lu, ou le défaut).

    de 0 à 50

  • distance_min_batiments_mnombre

    de 0 à 50

  • distance_max_maison_mnombre

    de 1 à 200

  • choix_implantationtexte

    Implantation automatique : l'emplacement retenu, A, B ou C.

    Valeurs : A, B, C

  • formalitetexte

    Formalité annoncée : jamais crue, comparée à celle que le croquis établit.

    Valeurs : aucune, declaration_prealable, permis_de_construire, permis_d_amenager, permis_de_demolir

  • demandeurtexte

    Valeurs : personne_physique, exploitation_agricole, societe

  • surface_plancher_creee_m2nombre

    de 0 à 1 000 000

  • surface_plancher_totale_apres_travaux_m2nombre

    de 0 à 1 000 000

  • emprise_au_sol_totale_apres_travaux_m2nombre

    de 0 à 1 000 000

  • annotationsliste d'objets

    Éléments du plan : arbres, accès, stationnement, réseaux, points de vue des photos.

    60 éléments au plus

    Afficher les 12 champs
    • typetexteobligatoire

      Valeurs : arbre, acces, stationnement, reseau, vue_photo

    • position_wgs84liste
    • etattexte

      Valeurs : conserve, abattu, plante

    • diametre_mnombre

      de 0 à 100

    • azimut_degnombre

      Orientation, 0 au nord, 90 à l'est.

      de -360 à 720

    • naturetexte

      Valeurs : vehicule, pieton

    • largeur_mnombre

      de 0 à 100

    • longueur_mnombre

      de 0 à 100

    • reseautexte

      Valeurs : eau, electricite, assainissement

    • trace_wgs84liste de listes

      50 éléments au plus

    • numeroentier

      de 0 à 1 000

    • piecetexte

      Valeurs : proche, lointain

  • projetsliste d'objetsobligatoire

    Les projets à placer sur la parcelle.

    1 éléments au moins ; 6 éléments au plus

    Afficher les 13 champs
    • naturetexteobligatoire

      Nature du projet.

      Valeurs : extension, annexe, abri, garage, carport, piscine, terrasse, veranda, autre

    • libelletexte

      60 caractères au plus

    • largeur_mnombre

      Largeur, le long du côté de référence, en mètres.

      de 0,5 à 200

    • profondeur_mnombre

      Profondeur, en mètres.

      de 0,5 à 200

    • hauteur_mnombre

      Hauteur totale en mètres ; 0 pour un ouvrage au niveau du sol.

      de 0 à 50

    • ancragetexte

      accole_batiment : contre un côté du bâtiment principal ; depuis_limite : à une distance d'une limite ; auto : trois emplacements proposés ; libre : contour donné.

      Valeurs : accole_batiment, depuis_limite, auto, libre

    • cotetexte

      Côté visé (bâtiment ou limite) : nord, sud, est, ouest.

      Valeurs : nord, sud, est, ouest

    • distance_limite_mnombre

      Distance à la limite, en mètres (ancrage depuis_limite).

      de 0 à 500

    • decalage_mnombre

      Décalage le long du côté, en mètres.

      de -500 à 500

    • calagetexte

      Valeurs : centre, extremite_ouest_sud, extremite_est_nord

    • hauteur_couverture_mnombre

      Piscine : hauteur de la couverture en mètres, 0 si non couverte.

      de 0 à 10

    • demontablebooléen

      Piscine démontable (hors sol).

    • contour_wgs84liste de listes

      Ancrage libre : les quatre coins [lon, lat], tels que le croquis les rend.

      4 éléments au moins ; 5 éléments au plus

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/urbanisme/croquis \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"idu":"76451000AW0069","demandeur":"personne_physique","surface_plancher_creee_m2":6,"surface_plancher_totale_apres_travaux_m2":120,"projets":[{"nature":"abri","largeur_m":3,"profondeur_m":2,"hauteur_m":2.2,"ancrage":"auto"}]}'

Réponse

  • adresseobjet ou null
    Afficher les 4 champs
    • libelletexte
    • latnombre
    • lonnombre
    • precisiontexte
  • origineobjet

    Origine du plan local (mètres, x vers l'est, y vers le nord).

    Afficher les 2 champs
    • latnombre
    • lonnombre
  • parcelleobjet
    Afficher les 9 champs
    • idutexte
    • sectiontexte ou null
    • numerotexte ou null
    • communetexte ou null
    • code_inseetexte ou null
    • contenance_m2nombre ou null
    • surface_calculee_m2nombre
    • contourliste de liste de liste de nombresss

      Anneaux de la parcelle, en mètres du plan local.

    • cotesliste d'objets
  • batimentsliste d'objets

    Bâtiments de la BD TOPO sur la parcelle : contour, surface, hauteur, étages, usage, principal.

  • projetsliste d'objets

    Projets placés : contour (plan local) et contour_wgs84, surface, distances aux limites et aux bâtiments, alertes.

  • projets_non_placesliste d'objets
    Afficher les 2 champs
    • libelletexte
    • raisontexte
  • mesuresobjet
    Afficher les 8 champs
    • surface_parcelle_cadastre_m2nombre ou null
    • surface_parcelle_calculee_m2nombre
    • emprise_existante_m2nombre
    • emprise_projets_m2nombre
    • emprise_totale_m2nombre
    • part_emprise_totale_pctnombre ou null
    • base_parttexte

      Valeurs : contenance_cadastrale, surface_calculee

    • distance_min_limite_projets_mnombre ou null
  • plan_de_masseobjet
    Afficher les 6 champs
    • echellenombre
    • echelle_usuellebooléen
    • cadre_mmobjet
      Afficher les 2 champs
      • largeurnombre
      • hauteurnombre
    • centreliste de nombres
    • refusobjet ou null

      Plan de masse non dessiné : architecte obligatoire, ou faits manquants pour l'établir.

      Afficher les 3 champs
      • raisontexte
      • a_confirmerbooléen
      • questionsliste d'objets
    • formalite_deriveetexte ou null

      Formalité établie par la base de règles depuis les projets dessinés ; null : non établie.

      Valeurs : aucune, declaration_prealable, permis_de_construire, permis_d_amenager, permis_de_demolir

  • plan_de_situationobjet
  • urbanismeobjet ou null

    Zone du PLU et servitudes lues en un point intérieur de la parcelle.

  • urbanisme_indisponibletexte ou null
  • implantationobjet ou null

    Implantation automatique : trois emplacements notés (soleil, distances, relief, limites).

  • annotationsliste d'objets
  • contraintes_pluobjet ou null

    Règles du règlement déjà lu (reculs, emprise, hauteur), avec leur source.

  • constatsliste de textes
  • sourcesliste de textes
  • limitesliste de textes
  • mentiontexte
  • genere_letexte
  • qualiteobjet

    Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

    Afficher les 7 champs
    • nentier ou null

      Nombre d'observations derrière la valeur ; null si sans objet.

      0 au moins

    • provenancetexte ou null

      mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

      Valeurs : mesure, estime

    • incertitudeobjet ou null

      Incertitude de la valeur : fourchette et demi-largeur.

      Afficher les 3 champs
      • demi_largeur_pctnombre ou null

        Demi-largeur de la fourchette, en % de la valeur.

      • basnombre ou null
      • hautnombre ou null
    • drapeauxliste de textes

      Ce qui doit faire lire la valeur avec prudence ; vide si rien.

      Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

    • methodetexte ou null

      Méthode de calcul ou de rattachement, en clair.

    • donnees_dutexte ou null

      Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

    • sourcetexte

      Source publique ou moteur Pillr, en clair.

  • creditsobjet

    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).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Coupes, façades et toitures

Essayer en direct
POST/api/v1/urbanisme/coupes

Le plan en coupe et le plan des façades et des toitures des projets d'un croquis, à l'échelle : terrain naturel lu en direct sur le RGE ALTI de l'IGN (altitudes NGF), hauteur maximale au-dessus du terrain, distances aux limites, surfaces de déblai et de remblai, toitures (plate, un ou deux pans), ouvertures et matériaux, silhouettes des bâtiments existants accolés. Les projets se décrivent comme pour croquis_projet, avec leurs niveaux, leur toiture et leurs ouvertures. Un fait manquant revient en question et le projet n'est pas dessiné ; si l'altimétrie de l'IGN ne répond pas, rien n'est dessiné ni débité.

Coût
20 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
urbanisme
Outil MCP
coupes_facades
Bac à sable
Non
Cache serveur
1 h
Délai maximal
60 s

Paramètres

  • adressetexte

    Adresse en texte, numéro compris, géocodée par la Base Adresse Nationale.

    de 5 à 200 caractères

  • code_postaltexte

    Code postal, pour départager une adresse homonyme (avec adresse).

  • idutexte

    Identifiant de la parcelle cadastrale à 14 caractères (ex. 69382000AB0050).

    de 14 à 24 caractères

  • latnombre

    de -90 à 90

  • lonnombre

    de -180 à 180

  • recul_limites_mnombre

    Implantation automatique : recul aux limites, en mètres (sinon celui du règlement lu, ou le défaut).

    de 0 à 50

  • distance_min_batiments_mnombre

    de 0 à 50

  • distance_max_maison_mnombre

    de 1 à 200

  • choix_implantationtexte

    Implantation automatique : l'emplacement retenu, A, B ou C.

    Valeurs : A, B, C

  • formalitetexte

    Formalité annoncée : jamais crue, comparée à celle que le croquis établit.

    Valeurs : aucune, declaration_prealable, permis_de_construire, permis_d_amenager, permis_de_demolir

  • demandeurtexte

    Valeurs : personne_physique, exploitation_agricole, societe

  • surface_plancher_creee_m2nombre

    de 0 à 1 000 000

  • surface_plancher_totale_apres_travaux_m2nombre

    de 0 à 1 000 000

  • emprise_au_sol_totale_apres_travaux_m2nombre

    de 0 à 1 000 000

  • annotationsliste d'objets

    Éléments du plan : arbres, accès, stationnement, réseaux, points de vue des photos.

    60 éléments au plus

    Afficher les 12 champs
    • typetexteobligatoire

      Valeurs : arbre, acces, stationnement, reseau, vue_photo

    • position_wgs84liste
    • etattexte

      Valeurs : conserve, abattu, plante

    • diametre_mnombre

      de 0 à 100

    • azimut_degnombre

      Orientation, 0 au nord, 90 à l'est.

      de -360 à 720

    • naturetexte

      Valeurs : vehicule, pieton

    • largeur_mnombre

      de 0 à 100

    • longueur_mnombre

      de 0 à 100

    • reseautexte

      Valeurs : eau, electricite, assainissement

    • trace_wgs84liste de listes

      50 éléments au plus

    • numeroentier

      de 0 à 1 000

    • piecetexte

      Valeurs : proche, lointain

  • projetsliste d'objetsobligatoire

    1 éléments au moins ; 6 éléments au plus

    Afficher les 29 champs
    • naturetexteobligatoire

      Nature du projet.

      Valeurs : extension, annexe, abri, garage, carport, piscine, terrasse, veranda, autre

    • libelletexte

      60 caractères au plus

    • largeur_mnombre

      Largeur, le long du côté de référence, en mètres.

      de 0,5 à 200

    • profondeur_mnombre

      Profondeur, en mètres.

      de 0,5 à 200

    • hauteur_mnombre

      Hauteur totale en mètres ; 0 pour un ouvrage au niveau du sol.

      de 0 à 50

    • ancragetexte

      accole_batiment : contre un côté du bâtiment principal ; depuis_limite : à une distance d'une limite ; auto : trois emplacements proposés ; libre : contour donné.

      Valeurs : accole_batiment, depuis_limite, auto, libre

    • cotetexte

      Côté visé (bâtiment ou limite) : nord, sud, est, ouest.

      Valeurs : nord, sud, est, ouest

    • distance_limite_mnombre

      Distance à la limite, en mètres (ancrage depuis_limite).

      de 0 à 500

    • decalage_mnombre

      Décalage le long du côté, en mètres.

      de -500 à 500

    • calagetexte

      Valeurs : centre, extremite_ouest_sud, extremite_est_nord

    • hauteur_couverture_mnombre

      Piscine : hauteur de la couverture en mètres, 0 si non couverte.

      de 0 à 10

    • demontablebooléen

      Piscine démontable (hors sol).

    • contour_wgs84liste de listes

      Ancrage libre : les quatre coins [lon, lat], tels que le croquis les rend.

      4 éléments au moins ; 5 éléments au plus

    • sens_coupetexte

      Valeurs : perpendiculaire_au_cote, parallele_au_cote, nord_sud, est_ouest

    • facadestexte

      Valeurs : principale_et_laterale, toutes

    • profondeur_bassin_mnombre

      de 0 à 10

    • niveau_margelle_mnombre

      de -10 à 10

    • largeur_margelle_mnombre

      de 0 à 5

    • largeur_plage_mnombre

      de 0 à 50

    • niveau_terrasse_mnombre

      de -10 à 10

    • niveau_plancher_mnombre

      de -10 à 10

    • toituretexte

      Valeurs : plate, un_pan, deux_pans

    • hauteur_murs_mnombre

      de 0 à 50

    • hauteur_faitage_mnombre

      de 0 à 50

    • pente_toiture_degnombre

      de 0 à 90

    • sens_faitagetexte

      Valeurs : parallele_au_cote, perpendiculaire_au_cote

    • pan_hauttexte

      Valeurs : cote_reference, cote_oppose

    • materiauxobjet
      Afficher les 3 champs
      • murstexte

        60 caractères au plus

      • toituretexte

        60 caractères au plus

      • menuiseriestexte

        60 caractères au plus

    • ouverturesliste d'objets

      30 éléments au plus

      Afficher les 9 champs
      • typetexteobligatoire

        Valeurs : porte, fenetre, baie, porte_garage

      • facadetexteobligatoire

        Valeurs : nord, sud, est, ouest

      • largeur_mnombre

        de 0 à 20

      • hauteur_mnombre

        de 0 à 10

      • position_mnombre

        Position depuis l'extrémité gauche de la façade vue de l'extérieur, en mètres.

        de 0 à 500

      • allege_mnombre

        Hauteur d'allège depuis le plancher, en mètres.

        de 0 à 10

      • libelletexte

        40 caractères au plus

      • materiautexte

        60 caractères au plus

      • couleurtexte

        40 caractères au plus

  • piecesliste de textes

    Pièces à dessiner : coupe, facades, ou les deux (défaut).

    Valeurs : coupe, facades

    1 éléments au moins ; 2 éléments au plus

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/urbanisme/coupes \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"idu":"76451000AW0069","demandeur":"personne_physique","surface_plancher_creee_m2":6,"surface_plancher_totale_apres_travaux_m2":120,"projets":[{"nature":"abri","largeur_m":3,"profondeur_m":2,"hauteur_m":2.2,"ancrage":"auto"}]}'

Réponse

  • adresseobjet ou null
    Afficher les 4 champs
    • libelletexte
    • latnombre
    • lonnombre
    • precisiontexte
  • origineobjet
    Afficher les 2 champs
    • latnombre
    • lonnombre
  • parcelleobjet
    Afficher les 6 champs
    • idutexte
    • sectiontexte ou null
    • numerotexte ou null
    • communetexte ou null
    • code_inseetexte ou null
    • contourliste de liste de liste de nombresss
  • batimentsliste d'objets
  • projetsliste d'objets

    Projets et leurs altitudes NGF, toitures, ouvertures et mesures.

  • coupesliste d'objets

    Plans en coupe : terrain naturel (RGE ALTI), projet, hauteur maximale au-dessus du terrain, distances aux limites, déblai et remblai.

  • facadesliste d'objets

    Façades et toitures, ouvertures et matériaux.

  • feuillesliste d'objets

    Feuilles à l'échelle, prêtes à imprimer.

  • refusobjet ou null
    Afficher les 2 champs
    • raisontexte
    • a_confirmerbooléen
  • formalite_deriveetexte ou null

    Valeurs : aucune, declaration_prealable, permis_de_construire, permis_d_amenager, permis_de_demolir

  • faits_manquantsliste de textes
  • questionsliste d'objets
  • constatsliste de textes
  • a_confirmerliste de textes
  • sourcesliste de textes
  • limitesliste de textes
  • mentiontexte
  • genere_letexte
  • qualiteobjet

    Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

    Afficher les 7 champs
    • nentier ou null

      Nombre d'observations derrière la valeur ; null si sans objet.

      0 au moins

    • provenancetexte ou null

      mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

      Valeurs : mesure, estime

    • incertitudeobjet ou null

      Incertitude de la valeur : fourchette et demi-largeur.

      Afficher les 3 champs
      • demi_largeur_pctnombre ou null

        Demi-largeur de la fourchette, en % de la valeur.

      • basnombre ou null
      • hautnombre ou null
    • drapeauxliste de textes

      Ce qui doit faire lire la valeur avec prudence ; vide si rien.

      Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

    • methodetexte ou null

      Méthode de calcul ou de rattachement, en clair.

    • donnees_dutexte ou null

      Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

    • sourcetexte

      Source publique ou moteur Pillr, en clair.

  • creditsobjet

    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).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Dossier de dépôt

Essayer en direct
POST/api/v1/urbanisme/dossiers

Le dossier de dépôt en mairie d'un projet, établi dans l'appel : le croquis de la parcelle (comme croquis_projet), les coupes et façades quand les projets en portent les faits (comme coupes_facades), puis la formalité et le Cerfa retenus, les pièces dans l'ordre du bordereau avec leur code, leur rôle et leur état (prête, à produire par une opération, à fournir par le demandeur), ce qui manque, les alertes du croquis et les données du Cerfa à passer à l'opération cerfa. La réponse est une tâche (202) dont le résultat se lit ensuite. L'archive ZIP du dossier (pièces graphiques à l'échelle, Cerfa, bordereau) se fabrique dans le Hub : par l'API, chaque pièce se produit par son opération.

Coût
200 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
urbanisme
Outil MCP
preparer_dossier
Bac à sable
Non
Cache serveur
Jamais mis en cache
Délai maximal
150 s

Paramètres

  • adressetexte

    Adresse en texte, numéro compris, géocodée par la Base Adresse Nationale.

    de 5 à 200 caractères

  • code_postaltexte

    Code postal, pour départager une adresse homonyme (avec adresse).

  • idutexte

    Identifiant de la parcelle cadastrale à 14 caractères (ex. 69382000AB0050).

    de 14 à 24 caractères

  • latnombre

    de -90 à 90

  • lonnombre

    de -180 à 180

  • recul_limites_mnombre

    Implantation automatique : recul aux limites, en mètres (sinon celui du règlement lu, ou le défaut).

    de 0 à 50

  • distance_min_batiments_mnombre

    de 0 à 50

  • distance_max_maison_mnombre

    de 1 à 200

  • choix_implantationtexte

    Implantation automatique : l'emplacement retenu, A, B ou C.

    Valeurs : A, B, C

  • formalitetexte

    Formalité annoncée : jamais crue, comparée à celle que le croquis établit.

    Valeurs : aucune, declaration_prealable, permis_de_construire, permis_d_amenager, permis_de_demolir

  • demandeurtexte

    Valeurs : personne_physique, exploitation_agricole, societe

  • surface_plancher_creee_m2nombre

    de 0 à 1 000 000

  • surface_plancher_totale_apres_travaux_m2nombre

    de 0 à 1 000 000

  • emprise_au_sol_totale_apres_travaux_m2nombre

    de 0 à 1 000 000

  • annotationsliste d'objets

    Éléments du plan : arbres, accès, stationnement, réseaux, points de vue des photos.

    60 éléments au plus

    Afficher les 12 champs
    • typetexteobligatoire

      Valeurs : arbre, acces, stationnement, reseau, vue_photo

    • position_wgs84liste
    • etattexte

      Valeurs : conserve, abattu, plante

    • diametre_mnombre

      de 0 à 100

    • azimut_degnombre

      Orientation, 0 au nord, 90 à l'est.

      de -360 à 720

    • naturetexte

      Valeurs : vehicule, pieton

    • largeur_mnombre

      de 0 à 100

    • longueur_mnombre

      de 0 à 100

    • reseautexte

      Valeurs : eau, electricite, assainissement

    • trace_wgs84liste de listes

      50 éléments au plus

    • numeroentier

      de 0 à 1 000

    • piecetexte

      Valeurs : proche, lointain

  • projetsliste d'objetsobligatoire

    Les projets, décrits comme pour croquis_projet et, pour les coupes, comme pour coupes_facades.

    1 éléments au moins ; 6 éléments au plus

    Afficher les 29 champs
    • naturetexteobligatoire

      Nature du projet.

      Valeurs : extension, annexe, abri, garage, carport, piscine, terrasse, veranda, autre

    • libelletexte

      60 caractères au plus

    • largeur_mnombre

      Largeur, le long du côté de référence, en mètres.

      de 0,5 à 200

    • profondeur_mnombre

      Profondeur, en mètres.

      de 0,5 à 200

    • hauteur_mnombre

      Hauteur totale en mètres ; 0 pour un ouvrage au niveau du sol.

      de 0 à 50

    • ancragetexte

      accole_batiment : contre un côté du bâtiment principal ; depuis_limite : à une distance d'une limite ; auto : trois emplacements proposés ; libre : contour donné.

      Valeurs : accole_batiment, depuis_limite, auto, libre

    • cotetexte

      Côté visé (bâtiment ou limite) : nord, sud, est, ouest.

      Valeurs : nord, sud, est, ouest

    • distance_limite_mnombre

      Distance à la limite, en mètres (ancrage depuis_limite).

      de 0 à 500

    • decalage_mnombre

      Décalage le long du côté, en mètres.

      de -500 à 500

    • calagetexte

      Valeurs : centre, extremite_ouest_sud, extremite_est_nord

    • hauteur_couverture_mnombre

      Piscine : hauteur de la couverture en mètres, 0 si non couverte.

      de 0 à 10

    • demontablebooléen

      Piscine démontable (hors sol).

    • contour_wgs84liste de listes

      Ancrage libre : les quatre coins [lon, lat], tels que le croquis les rend.

      4 éléments au moins ; 5 éléments au plus

    • sens_coupetexte

      Valeurs : perpendiculaire_au_cote, parallele_au_cote, nord_sud, est_ouest

    • facadestexte

      Valeurs : principale_et_laterale, toutes

    • profondeur_bassin_mnombre

      de 0 à 10

    • niveau_margelle_mnombre

      de -10 à 10

    • largeur_margelle_mnombre

      de 0 à 5

    • largeur_plage_mnombre

      de 0 à 50

    • niveau_terrasse_mnombre

      de -10 à 10

    • niveau_plancher_mnombre

      de -10 à 10

    • toituretexte

      Valeurs : plate, un_pan, deux_pans

    • hauteur_murs_mnombre

      de 0 à 50

    • hauteur_faitage_mnombre

      de 0 à 50

    • pente_toiture_degnombre

      de 0 à 90

    • sens_faitagetexte

      Valeurs : parallele_au_cote, perpendiculaire_au_cote

    • pan_hauttexte

      Valeurs : cote_reference, cote_oppose

    • materiauxobjet
      Afficher les 3 champs
      • murstexte

        60 caractères au plus

      • toituretexte

        60 caractères au plus

      • menuiseriestexte

        60 caractères au plus

    • ouverturesliste d'objets

      30 éléments au plus

      Afficher les 9 champs
      • typetexteobligatoire

        Valeurs : porte, fenetre, baie, porte_garage

      • facadetexteobligatoire

        Valeurs : nord, sud, est, ouest

      • largeur_mnombre

        de 0 à 20

      • hauteur_mnombre

        de 0 à 10

      • position_mnombre

        Position depuis l'extrémité gauche de la façade vue de l'extérieur, en mètres.

        de 0 à 500

      • allege_mnombre

        Hauteur d'allège depuis le plancher, en mètres.

        de 0 à 10

      • libelletexte

        40 caractères au plus

      • materiautexte

        60 caractères au plus

      • couleurtexte

        40 caractères au plus

  • maison_individuellebooléen

    Pour un permis de construire : le projet porte-t-il sur une maison individuelle ou ses annexes ? Le formulaire et les codes des pièces en dépendent.

  • coupesbooléen

    Faux : ne pas dessiner les coupes et façades dans l'appel. Par défaut, elles le sont dès qu'un projet porte ses faits de toiture, de hauteur des murs ou de niveau.

  • attendreentier

    Secondes d'attente de la fin de la tâche avant de répondre (60 au plus).

    de 0 à 60 ; par défaut 0

  • webhooktexte

    URL https appelée à la fin de la tâche, signée (Pillr-Signature).

    500 caractères au plus

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/urbanisme/dossiers \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"idu":"76451000AW0069","demandeur":"personne_physique","surface_plancher_creee_m2":6,"surface_plancher_totale_apres_travaux_m2":120,"projets":[{"nature":"abri","largeur_m":3,"profondeur_m":2,"hauteur_m":2.2,"ancrage":"auto"}]}'

Réponse

  • tacheobjet

    La tâche asynchrone.

    Afficher les 7 champs
    • idtexte

      Identifiant de la tâche, à passer à l'opération de résultat.

    • operationtexte
    • statuttexte

      en_attente, en_cours, terminee (resultat rempli) ou echouee (erreur remplie, crédits rendus).

      Valeurs : en_attente, en_cours, terminee, echouee

    • cree_letexte
    • termine_letexte ou null
    • expire_letexte

      Date au-delà de laquelle le résultat n'est plus conservé.

    • resultat_urltexte

      Chemin de lecture du résultat (GET).

  • resultatobjet ou null

    La sortie de l'opération, quand la tâche est terminée ; null sinon.

    Afficher les 18 champs
    • statuttexte

      pret : la liste des pièces est établie ; sinon le message dit ce qui manque.

      Valeurs : pret, formalite_non_etablie, aucune_formalite, question_maison_individuelle

    • messagetexte ou null
    • formalitetexte ou null

      Valeurs : aucune, declaration_prealable, permis_de_construire, permis_d_amenager, permis_de_demolir

    • libelle_formalitetexte ou null
    • formalite_sourcetexte ou null

      Valeurs : croquis, demarche

    • cerfaobjet ou null

      Le formulaire retenu : il se pré-remplit par l'opération cerfa avec donnees_cerfa.

      Afficher les 4 champs
      • numerotexte
      • libelletexte
      • fichiertexte
      • url_officielletexte
    • donnees_cerfaobjet

      Les faits du dossier pour le Cerfa (terrain, références cadastrales, nature des travaux, emprise) : l'entrée donnees de l'opération cerfa.

    • cases_a_completerliste d'objets
      Afficher les 3 champs
      • rubriquetexte
      • libelletexte
      • raisontexte
    • terrainobjet
      Afficher les 4 champs
      • adressetexte ou null
      • parcelletexte
      • communetexte ou null
      • idutexte
    • piecesliste d'objets
      Afficher les 10 champs
      • codetexte ou null

        Code du bordereau (DPC1, PCMI2...).

      • libelletexte
      • roletexte

        Ce que la pièce doit montrer, d'après le bordereau du Cerfa.

      • etattexte

        prete : produite par Pillr depuis le croquis ou les coupes ; a_produire : par l'opération dite ; a_fournir : par le demandeur (photos, insertion).

        Valeurs : prete, a_completer, a_produire, a_fournir

      • exigeetexte

        Valeurs : oui, selon_le_projet

      • a_confirmerbooléen
      • complementbooléen

        Joint hors bordereau (vue aérienne).

      • consignetexte ou null
      • operationtexte ou null

        L'opération qui produit ou produirait la pièce.

        Valeurs : croquis_projet, coupes_facades, generer_document

      • fichiertexte ou null

        Nom du fichier de la pièce dans le dossier du Hub.

    • manquesliste de textes

      Ce qui manque au dossier, dit en clair.

    • alertesliste de textes

      Points à corriger dans le croquis avant tout dépôt.

    • notesliste de textes
    • maison_individuellebooléen ou null
    • coupesobjet

      Les coupes et façades dessinées dans l'appel, ou pourquoi elles ne l'ont pas été.

      Afficher les 2 champs
      • dessineesbooléen
      • refustexte ou null
    • archivetexte ou null

      Nom de l'archive du dossier dans le Hub (statut pret).

    • limitesliste de textes
    • genere_letexte
  • erreurobjet ou null

    Pourquoi la tâche a échoué ; null sinon.

    Afficher les 2 champs
    • codetexte
    • detailtexte
  • creditsobjet

    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).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Résultat : dossier de dépôt

Essayer en direct
GET/api/v1/urbanisme/dossiers/{tache}

État et résultat d'une tâche lancée par POST /urbanisme/dossiers (outil preparer_dossier) : statut, sortie complète quand elle est terminée, erreur quand elle a échoué (ses crédits sont alors rendus). Le paramètre attendre patiente jusqu'à 60 s.

Coût
0 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
urbanisme
Outil MCP
resultat_preparer_dossier
Bac à sable
Oui, sans débit, sur un jeu figé
Cache serveur
Jamais mis en cache
Délai maximal
5 s

Paramètres

  • tachetexteobligatoire

    Identifiant de la tâche rendu au lancement (tache.id).

  • attendreentier

    Secondes d'attente de la fin de la tâche avant de répondre (60 au plus).

    de 0 à 60 ; par défaut 0

Exemple d'appel

curl https://pillr.fr/api/v1/urbanisme/dossiers/00000000-0000-4000-8000-000000000001 \
  -H "Authorization: Bearer $PILLR_CLE"

Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.

Réponse

  • tacheobjet

    La tâche asynchrone.

    Afficher les 7 champs
    • idtexte

      Identifiant de la tâche, à passer à l'opération de résultat.

    • operationtexte
    • statuttexte

      en_attente, en_cours, terminee (resultat rempli) ou echouee (erreur remplie, crédits rendus).

      Valeurs : en_attente, en_cours, terminee, echouee

    • cree_letexte
    • termine_letexte ou null
    • expire_letexte

      Date au-delà de laquelle le résultat n'est plus conservé.

    • resultat_urltexte

      Chemin de lecture du résultat (GET).

  • resultatobjet ou null

    La sortie de l'opération, quand la tâche est terminée ; null sinon.

    Afficher les 18 champs
    • statuttexte

      pret : la liste des pièces est établie ; sinon le message dit ce qui manque.

      Valeurs : pret, formalite_non_etablie, aucune_formalite, question_maison_individuelle

    • messagetexte ou null
    • formalitetexte ou null

      Valeurs : aucune, declaration_prealable, permis_de_construire, permis_d_amenager, permis_de_demolir

    • libelle_formalitetexte ou null
    • formalite_sourcetexte ou null

      Valeurs : croquis, demarche

    • cerfaobjet ou null

      Le formulaire retenu : il se pré-remplit par l'opération cerfa avec donnees_cerfa.

      Afficher les 4 champs
      • numerotexte
      • libelletexte
      • fichiertexte
      • url_officielletexte
    • donnees_cerfaobjet

      Les faits du dossier pour le Cerfa (terrain, références cadastrales, nature des travaux, emprise) : l'entrée donnees de l'opération cerfa.

    • cases_a_completerliste d'objets
      Afficher les 3 champs
      • rubriquetexte
      • libelletexte
      • raisontexte
    • terrainobjet
      Afficher les 4 champs
      • adressetexte ou null
      • parcelletexte
      • communetexte ou null
      • idutexte
    • piecesliste d'objets
      Afficher les 10 champs
      • codetexte ou null

        Code du bordereau (DPC1, PCMI2...).

      • libelletexte
      • roletexte

        Ce que la pièce doit montrer, d'après le bordereau du Cerfa.

      • etattexte

        prete : produite par Pillr depuis le croquis ou les coupes ; a_produire : par l'opération dite ; a_fournir : par le demandeur (photos, insertion).

        Valeurs : prete, a_completer, a_produire, a_fournir

      • exigeetexte

        Valeurs : oui, selon_le_projet

      • a_confirmerbooléen
      • complementbooléen

        Joint hors bordereau (vue aérienne).

      • consignetexte ou null
      • operationtexte ou null

        L'opération qui produit ou produirait la pièce.

        Valeurs : croquis_projet, coupes_facades, generer_document

      • fichiertexte ou null

        Nom du fichier de la pièce dans le dossier du Hub.

    • manquesliste de textes

      Ce qui manque au dossier, dit en clair.

    • alertesliste de textes

      Points à corriger dans le croquis avant tout dépôt.

    • notesliste de textes
    • maison_individuellebooléen ou null
    • coupesobjet

      Les coupes et façades dessinées dans l'appel, ou pourquoi elles ne l'ont pas été.

      Afficher les 2 champs
      • dessineesbooléen
      • refustexte ou null
    • archivetexte ou null

      Nom de l'archive du dossier dans le Hub (statut pret).

    • limitesliste de textes
    • genere_letexte
  • erreurobjet ou null

    Pourquoi la tâche a échoué ; null sinon.

    Afficher les 2 champs
    • codetexte
    • detailtexte
  • creditsobjet

    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).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

  • 400parametres_invalidesUn paramètre manque ou ne passe pas son contrôle ; le détail est donné champ par champ
  • 403hors_bac_a_sableUne clé pk_test_ demande une entrée hors du jeu figé de l'opération
Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Cerfa d'urbanisme pré-rempli

Essayer en direct
POST/api/v1/urbanisme/cerfa/{numero}

Le PDF officiel d'un Cerfa d'urbanisme (lu sur formulaires.service-public.gouv.fr, dans la version vérifiée par Pillr), rempli des seules cases connues du dossier : adresse et superficie du terrain, références cadastrales, nature des travaux, annexes, emprise au sol créée, description du projet. L'identité, les coordonnées, l'engagement et la signature du demandeur ne sont jamais remplis : la réponse les liste avec les cases restées vides. En REST, la réponse est le PDF ; en MCP, la liste des cases remplies et vides, et le PDF en ressource. Si le formulaire officiel a changé depuis sa vérification, rien n'est rempli ni débité et les valeurs sont rendues pour une saisie à la main.

Coût
5 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
urbanisme
Outil MCP
cerfa
Bac à sable
Oui, sans débit, sur un jeu figé
Cache serveur
1 h
Délai maximal
25 s

Paramètres

  • numerotexteobligatoire

    Numéro du formulaire : 16702*03, 16703*03, 13406*17, 13409*17, 13405*15, 16297*05 (l'astérisque s'écrit aussi avec un tiret).

  • donneesobjetobligatoire

    Les faits du dossier, par clé de la table de correspondance.

    Afficher les 21 champs
    • terrain.numerotexte

      1 000 caractères au plus

    • terrain.voietexte

      1 000 caractères au plus

    • terrain.lieudittexte

      1 000 caractères au plus

    • terrain.localitetexte

      1 000 caractères au plus

    • terrain.code_postaltexte

      1 000 caractères au plus

    • parcelle.prefixetexte

      1 000 caractères au plus

    • parcelle.sectiontexte

      1 000 caractères au plus

    • parcelle.numerotexte

      1 000 caractères au plus

    • travaux.descriptiontexte

      1 000 caractères au plus

    • annexe.autres_precisiontexte

      1 000 caractères au plus

    • parcelle.superficie_m2nombre

      de 0 à 100 000 000

    • terrain.superficie_totale_m2nombre

      de 0 à 100 000 000

    • emprise.creee_m2nombre

      de 0 à 100 000 000

    • travaux.nouvellebooléen
    • travaux.existantebooléen
    • travaux.extensionbooléen
    • annexe.piscinebooléen
    • annexe.garagebooléen
    • annexe.verandabooléen
    • annexe.abribooléen
    • annexe.autresbooléen

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/urbanisme/cerfa/16702-03 \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"donnees":{"terrain.localite":"Rennes","emprise.creee_m2":18}}'

Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.

Réponse du bac à sable

{
  "numero": "16702*03",
  "libelle": "Déclaration préalable (maison individuelle ou autre projet)",
  "version_formulaire": "cerfa_16702-03.pdf",
  "verifie_le": "2026-09-29",
  "cases_remplies": [
    {
      "rubrique": "3.1",
      "libelle": "Adresse du terrain : localité",
      "valeur": "Rennes"
    },
    {
      "rubrique": "4.3",
      "libelle": "Emprise au sol créée (en m²)",
      "valeur": "18"
    }
  ],
  "cases_vides": [
    {
      "rubrique": "3.1",
      "libelle": "Adresse du terrain : code postal",
      "raison": "non établi par le dossier"
    },
    {
      "rubrique": "3.1",
      "libelle": "Références cadastrales : préfixe",
      "raison": "non établi par le dossier"
    },
    {
      "rubrique": "3.1",
      "libelle": "Références cadastrales : section",
      "raison": "non établi par le dossier"
    },
    {
      "rubrique": "3.1",
      "libelle": "Références cadastrales : numéro",
      "raison": "non établi par le dossier"
    },
    {
      "rubrique": "3.1",
      "libelle": "Superficie de la parcelle cadastrale (en m²)",
      "raison": "non établi par le dossier"
    },
    {
      "rubrique": "3.1",
      "libelle": "Superficie totale du terrain (en m²)",
      "raison": "non établi par le dossier"
    },
    {
      "rubrique": "4.1",
      "libelle": "Courte description de votre projet ou de vos travaux",
      "raison": "non établi par le dossier"
    },
    {
      "rubrique": "1",
      "libelle": "Identité du déclarant (particulier ou personne morale)",
      "raison": "à compléter par vous"
    },
    {
      "rubrique": "2",
      "libelle": "Coordonnées du déclarant (adresse, téléphone, courriel)",
      "raison": "à compléter par vous"
    },
    {
      "rubrique": "3.2",
      "libelle": "Situation juridique du terrain (certificat d'urbanisme, lotissement, ZAC…)",
      "raison": "à compléter par vous"
    },
    {
      "rubrique": "4.2",
      "libelle": "Logements créés, leur financement et leur usage, s'il y en a",
      "raison": "à compléter par vous"
    },
    {
      "rubrique": "4.3",
      "libelle": "Emprise au sol avant travaux et emprise supprimée",
      "raison": "à compléter par vous"
    },
    {
      "rubrique": "4.4",
      "libelle": "Tableau des surfaces de plancher (existante, créée, supprimée)",
      "raison": "à compléter par vous"
    },
    {
      "rubrique": "4.5",
      "libelle": "Stationnement",
      "raison": "à compléter par vous"
    },
    {
      "rubrique": "5",
      "libelle": "Informations pour l'application d'une législation connexe",
      "raison": "à compléter par vous"
    },
    {
      "rubrique": "6",
      "libelle": "Participation pour voirie et réseaux",
      "raison": "à compléter par vous"
    },
    {
      "rubrique": "7",
      "libelle": "Engagement du déclarant : lieu, date et signature",
      "raison": "à compléter par vous"
    },
    {
      "rubrique": "Bordereau",
      "libelle": "Cocher les pièces jointes et reporter leur numéro sur chacune",
      "raison": "à compléter par vous"
    }
  ],
  "fichier": "cerfa-16702-03-pre-rempli.pdf",
  "credits": {
    "debites": 0,
    "restants": null
  }
}

Réponse réelle de l'API à cette entrée, obtenue avec le moteur du bac à sable, donnée du 29/09/2026.

Réponse

  • numerotexte

    Valeurs : 16702*03, 16703*03, 13406*17, 13409*17, 13405*15, 16297*05

  • libelletexte
  • version_formulairetexte

    Fichier officiel vérifié par Pillr ; une autre version est refusée plutôt que remplie de travers.

  • verifie_letexte
  • cases_rempliesliste d'objets
    Afficher les 3 champs
    • rubriquetexte
    • libelletexte
    • valeurtexte

      Texte écrit, ou « coché » pour une case.

  • cases_videsliste d'objets

    Cases que le dossier ne sait pas remplir, puis les rubriques jamais remplies (identité, coordonnées, engagement, signature).

    Afficher les 3 champs
    • rubriquetexte
    • libelletexte
    • raisontexte
  • fichiertexte

    Nom du fichier PDF servi.

  • creditsobjet

    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).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Échéances d'un dossier après dépôt

Essayer en direct
POST/api/v1/urbanisme/echeances

Échéances datées d'un dossier d'urbanisme à partir de sa date de dépôt : courrier de pièces manquantes, fin du délai d'instruction (de droit commun et majoré), date à partir de laquelle le silence vaut accord ou refus, affichage et recours des tiers, retrait par la mairie, prorogation et fin de validité, recours contre un refus, puis DAACT, déclaration et paiement de la taxe d'aménagement à l'achèvement. Chaque échéance porte sa règle et sa source. La démarche se donne telle que demarche_urbanisme l'a établie, ou se calcule dans l'appel à partir des faits du projet. Les dates se comptent de quantième à quantième ; le récépissé et les courriers de la mairie font foi.

Coût
1 crédit par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
urbanisme
Outil MCP
echeances_depot
Bac à sable
Oui, sans débit, sur un jeu figé
Cache serveur
24 h
Délai maximal
3 s

Paramètres

  • date_depottexteobligatoire

    Date de dépôt du dossier complet en mairie (AAAA-MM-JJ, celle du récépissé).

  • demarcheobjet

    La démarche déjà établie par demarche_urbanisme. Donner demarche ou projet, pas les deux.

    Afficher les 9 champs
    • type_travauxtexteobligatoire

      Nature des travaux (projet.type_travaux de demarche_urbanisme).

      Valeurs : construction_nouvelle, travaux_existant, transformation_garage, piscine, cloture, mur, aspect_exterieur, pompe_a_chaleur, ravalement, changement_destination, division, demolition

    • formalitetexteobligatoire

      Formalité déposée (formalite.code de demarche_urbanisme).

      Valeurs : declaration_prealable, permis_de_construire, permis_d_amenager, permis_de_demolir

    • delai_base_moisentierobligatoire

      Délai d'instruction de droit commun, en mois (delai.base_mois).

      de 1 à 12

    • delai_moisentier

      Délai avec les majorations connues, en mois (delai.mois) ; par défaut, le droit commun.

      de 1 à 12

    • silencetexteobligatoire

      Ce que vaut le silence de la mairie au terme du délai (delai.silence).

      Valeurs : acceptation, refus

    • avis_abfbooléen

      Vrai si un avis défavorable de l'architecte des Bâtiments de France peut faire valoir le silence comme refus (delai.refus_tacite_si non vide).

    • delai_a_confirmerbooléen

      Délai à faire confirmer par la mairie (delai.a_confirmer).

    • taxe_min_eurnombre

      Taxe d'aménagement estimée, borne basse, en euros.

      de 0 à 1 000 000 000

    • taxe_max_eurnombre

      Taxe d'aménagement estimée, borne haute, en euros.

      de 0 à 1 000 000 000

  • projetobjet

    Les faits du projet, comme pour demarche_urbanisme : la démarche est établie dans l'appel.

    Afficher les 52 champs
    • type_travauxtexteobligatoire

      Nature des travaux. Une annexe séparée est une construction_nouvelle ; une extension ou une véranda accolée, des travaux_existant.

      Valeurs : construction_nouvelle, travaux_existant, transformation_garage, piscine, cloture, mur, aspect_exterieur, pompe_a_chaleur, ravalement, changement_destination, division, demolition

    • emprise_au_sol_creee_m2nombre

      Emprise au sol créée, en m² (un carport ou un garage compte même sans surface de plancher).

      de 0 à 1 000 000

    • surface_plancher_creee_m2nombre

      Surface de plancher créée, ou surface close transformée pour un garage, en m².

      de 0 à 1 000 000

    • hauteur_mnombre

      Hauteur de la construction ou du mur, en mètres.

      de 0 à 1 000 000

    • surface_plancher_existante_m2nombre

      Surface de plancher du bâtiment existant, en m².

      de 0 à 1 000 000

    • emprise_au_sol_existante_m2nombre

      Emprise au sol du bâtiment existant, en m².

      de 0 à 1 000 000

    • modifie_aspect_exterieurbooléen
    • modifie_volumebooléen
    • visible_espace_publicbooléen
    • bassin_m2nombre

      Piscine : surface du bassin, en m².

      de 0 à 1 000 000

    • hauteur_couverture_mnombre

      Piscine : hauteur de la couverture en mètres, 0 si non couverte.

      de 0 à 1 000 000

    • piscine_demontablebooléen
    • duree_installation_moisnombre

      Piscine démontable : mois d'installation par an.

      de 0 à 1 000 000

    • duree_installation_joursnombre

      Piscine démontable en espace protégé : jours d'installation par an.

      de 0 à 1 000 000

    • deliberation_communalebooléen

      La commune a soumis clôtures ou ravalements à déclaration par délibération.

    • secteur_cloture_plubooléen

      Clôture dans un secteur délimité par le PLU.

    • reparation_a_l_identiquebooléen
    • pac_visiblebooléen

      Pompe à chaleur visible depuis l'espace public, la voie ou les autres bâtiments.

    • date_debut_travauxtexte

      Date de début des travaux, si elle est passée.

    • ravalement_change_couleursbooléen
    • changementtexte

      Valeurs : destination, sous_destination

    • travaux_structure_ou_facadebooléen
    • equipements_communsbooléen

      Division : création de voies, espaces ou équipements communs.

    • date_depottexte

      Division : date de dépôt prévue (par défaut, aujourd'hui).

    • permis_demolir_instituebooléen
    • restauration_immobilierebooléen
    • inclut_demolitionbooléen
    • demandeurtexte

      Qui dépose la demande (une SCI est une société).

      Valeurs : personne_physique, exploitation_agricole, societe

    • maison_individuellebooléen
    • serre_productionbooléen
    • hauteur_pied_droit_mnombre

      Serre : hauteur du pied-droit, en mètres.

      de 0 à 1 000 000

    • erp_ou_ighbooléen

      Établissement recevant du public ou immeuble de grande hauteur.

    • participation_du_publicbooléen
    • evaluation_environnementalebooléen
    • sprbooléen

      Terrain en site patrimonial remarquable.

    • abords_monument_historiquebooléen

      Terrain aux abords d'un monument historique.

    • site_classebooléen
    • site_inscritbooléen
    • reserve_naturellebooléen
    • element_protege_plubooléen

      Bâtiment ou élément protégé par le PLU.

    • monument_historiquebooléen

      Travaux sur un monument historique.

    • coeur_parc_nationalbooléen
    • document_urbanismetexte

      Document d'urbanisme de la commune.

      Valeurs : plu, carte_communale, rnu

    • zone_urbainebooléen

      Terrain en zone urbaine du PLU.

    • surface_taxable_creee_m2nombre

      Taxe d'aménagement : surface taxable créée, en m².

      de 0 à 1 000 000

    • surface_taxable_existante_m2nombre

      Taxe d'aménagement : surface taxable existante, en m².

      de 0 à 1 000 000

    • places_stationnement_exterieuresnombre

      Taxe d'aménagement : places de stationnement extérieures créées.

      de 0 à 1 000 000

    • residence_principalebooléen

      Taxe d'aménagement : le projet porte sur la résidence principale ou ses annexes (abattement).

    • affecte_sous_solbooléen

      Redevance d'archéologie préventive : les travaux affectent le sous-sol.

    • code_inseetexte

      Commune du terrain, pour ses taux de taxe d'aménagement ; sans elle, l'estimation reste une fourchette du barème légal.

    • taux_communal_pctnombre

      Taux communal de la taxe d'aménagement, en %, s'il est connu (il prime sur celui de la commune).

      de 0 à 20

    • taux_departemental_pctnombre

      Taux départemental de la taxe d'aménagement, en %, s'il est connu.

      de 0 à 5

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/urbanisme/echeances \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"date_depot":"2026-06-01","projet":{"type_travaux":"construction_nouvelle","emprise_au_sol_creee_m2":18}}'

Cette entrée est dans le bac à sable : une clé pk_test_ obtient la réponse, sans débit.

Réponse du bac à sable

{
  "statut": "sans_suivi",
  "motif": "La formalité ne peut pas être établie sans les faits manquants : demarche_urbanisme pose les questions.",
  "faits_manquants": [
    "Quelle surface de plancher crée-t-elle, en m² (0 pour un carport ouvert) ?",
    "Quelle sera sa hauteur, en mètres ?"
  ],
  "date_depot": "2026-06-01",
  "demarche": null,
  "echeances": [],
  "prochaine": null,
  "regles_a_jour_le": "2026-09-29",
  "limites": [
    "Dates comptées de quantième à quantième à partir de la date de dépôt donnée : le récépissé de dépôt et les courriers de la mairie font foi.",
    "Un courrier de pièces manquantes ou de délai majoré, reçu dans le premier mois, décale toutes les dates suivantes.",
    "Information générale, ni conseil juridique ni décision de la mairie."
  ],
  "qualite": {
    "n": null,
    "provenance": null,
    "incertitude": null,
    "drapeaux": [],
    "methode": "Échéances calculées depuis la date de dépôt par les règles du Code de l'urbanisme, de quantième à quantième.",
    "donnees_du": "2026-09-29",
    "source": "Code de l'urbanisme et fiches de service-public.gouv.fr, règles vérifiées par Pillr"
  },
  "credits": {
    "debites": 0,
    "restants": null
  }
}

Réponse réelle de l'API à cette entrée, obtenue avec le moteur du bac à sable, donnée du 29/09/2026.

Réponse

  • statuttexte

    sans_suivi : la démarche du projet ne se suit pas après dépôt (aucune autorisation, ou faits manquants).

    Valeurs : echeances, sans_suivi

  • motiftexte ou null

    Pourquoi il n'y a rien à suivre (statut sans_suivi).

  • faits_manquantsliste de textes

    Projet : les faits sans lesquels la formalité ne peut pas être établie (voir demarche_urbanisme).

  • date_depottexte
  • demarcheobjet ou null

    La démarche suivie, telle qu'elle a servi au calcul.

    Afficher les 9 champs
    • type_travauxtexte

      Valeurs : construction_nouvelle, travaux_existant, transformation_garage, piscine, cloture, mur, aspect_exterieur, pompe_a_chaleur, ravalement, changement_destination, division, demolition

    • formalitetexte

      Valeurs : declaration_prealable, permis_de_construire, permis_d_amenager, permis_de_demolir

    • libelletexte

      Libellé court : formalité et nature des travaux.

    • delai_base_moisnombre
    • delai_moisnombre
    • silencetexte

      Valeurs : acceptation, refus

    • avis_abfbooléen
    • delai_a_confirmerbooléen
    • taxe_estimeeobjet ou null
      Afficher les 2 champs
      • minnombre
      • maxnombre
  • echeancesliste d'objets

    Les échéances datées par date croissante, puis celles relatives à l'achèvement.

    Afficher les 7 champs
    • cletexte

      Identifiant stable de l'échéance.

      Valeurs : pieces, fin_instruction, fin_instruction_majoree, silence, affichage, recours_tiers, retrait, prorogation, validite, recours_refus, daact, declaration_taxe, paiement_taxe

    • datetexte ou null

      AAAA-MM-JJ ; null pour une échéance relative à l'achèvement des travaux.

    • quandtexte ou null

      Pour une échéance sans date : quand elle tombe, en clair.

    • libelletexte
    • regletexte

      La règle qui fixe l'échéance, en clair.

    • sourcesliste de textes
    • a_confirmerbooléen
  • prochaineobjet ou null

    La prochaine échéance datée à partir d'aujourd'hui (heure de Paris), ou null.

    Afficher les 7 champs
    • cletexte

      Identifiant stable de l'échéance.

      Valeurs : pieces, fin_instruction, fin_instruction_majoree, silence, affichage, recours_tiers, retrait, prorogation, validite, recours_refus, daact, declaration_taxe, paiement_taxe

    • datetexte ou null

      AAAA-MM-JJ ; null pour une échéance relative à l'achèvement des travaux.

    • quandtexte ou null

      Pour une échéance sans date : quand elle tombe, en clair.

    • libelletexte
    • regletexte

      La règle qui fixe l'échéance, en clair.

    • sourcesliste de textes
    • a_confirmerbooléen
  • regles_a_jour_letexte

    Date de vérification des règles du suivi.

  • limitesliste de textes
  • qualiteobjet

    Ce qui permet de juger la valeur : nombre, provenance, incertitude, drapeaux, date et source.

    Afficher les 7 champs
    • nentier ou null

      Nombre d'observations derrière la valeur ; null si sans objet.

      0 au moins

    • provenancetexte ou null

      mesure : observé sur la donnée ; estime : modèle, barème ou imputation ; null : sans objet.

      Valeurs : mesure, estime

    • incertitudeobjet ou null

      Incertitude de la valeur : fourchette et demi-largeur.

      Afficher les 3 champs
      • demi_largeur_pctnombre ou null

        Demi-largeur de la fourchette, en % de la valeur.

      • basnombre ou null
      • hautnombre ou null
    • drapeauxliste de textes

      Ce qui doit faire lire la valeur avec prudence ; vide si rien.

      Valeurs : prix_atypique, surface_atypique, vente_en_bloc, doublon_probable, date_estimee, peu_d_observations, valeur_imputee, rattachement_incertain, donnee_ancienne

    • methodetexte ou null

      Méthode de calcul ou de rattachement, en clair.

    • donnees_dutexte ou null

      Date de la donnée (AAAA-MM-JJ ou horodatage ISO 8601).

    • sourcetexte

      Source publique ou moteur Pillr, en clair.

  • creditsobjet

    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).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs

Rendu réaliste d'un projet sur la vue aérienne

Essayer en direct
POST/api/v1/urbanisme/rendus

Une image réaliste du projet posé à l'échelle sur la photo aérienne de l'IGN : la photo est lue en direct, le dessin exact du projet y est composé, puis un modèle d'image rend le seul projet réaliste, sans rien ajouter ni déplacer. L'image est une illustration indicative : elle ne remplace pas le document graphique d'insertion du dossier. En REST, la réponse est l'image PNG ; en MCP, ses métadonnées, et l'image en ressource. Les rendus sont bornés par heure et par organisation, comme dans le Hub.

Coût
100 crédits par appel réussi
Accès
À l'usage ou avec l'abonnement Data
Portée
urbanisme
Outil MCP
rendu_aerien
Bac à sable
Non
Cache serveur
Jamais mis en cache
Délai maximal
90 s

Paramètres

  • empriselisteobligatoire

    Emprise de la vue [ouest, sud, est, nord] en degrés, 1500 m de côté au plus (vues.aerienne du plan de situation de croquis_projet).

  • projetsliste d'objetsobligatoire

    1 éléments au moins ; 6 éléments au plus

    Afficher les 5 champs
    • naturetexteobligatoire

      Valeurs : extension, annexe, abri, garage, carport, piscine, terrasse, veranda, autre

    • contourliste de listesobligatoire

      Les quatre coins [lon, lat] du projet (contour_wgs84 de croquis_projet).

      4 éléments au moins ; 4 éléments au plus

    • largeur_mnombreobligatoire

      de 0,5 à 200

    • profondeur_mnombreobligatoire

      de 0,5 à 200

    • hauteur_mnombre

      de 0 à 50

Exemple d'appel

curl -X POST https://pillr.fr/api/v1/urbanisme/rendus \
  -H "Authorization: Bearer $PILLR_CLE" \
  -H "Content-Type: application/json" \
  -d '{"emprise":[1.0679506,49.4690379,1.0729727,49.4708362],"projets":[{"nature":"abri","contour":[[1.07044043,49.46987927],[1.07047855,49.46988978],[1.07046779,49.46990634],[1.07042968,49.46989582]],"largeur_m":3,"profondeur_m":2,"hauteur_m":2.2}]}'

Réponse

  • mimetexte
  • modeletexte

    Modèle d'image qui a produit le rendu.

  • genere_letexte
  • avertissementtexte

    Ce que vaut l'image : une illustration indicative.

  • fichiertexte
  • creditsobjet

    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).

    Afficher les 2 champs
    • debitesentier

      0 au moins

    • restantsentier ou null

Erreurs possibles

Afficher les 11 erreurs communes à toute l'API

Une ressource absente répond par un code de la famille des ressources absentes, propre à l'opération, sans débit. Guide des erreurs