Calculateur de pavés

La même fonction pure alimente l’outil navigateur gratuit et l’API payante, de sorte qu’un devis généré sur téléphone correspond à la ligne qu’un script publie ensuite. Les tailles de pavé nulles ou négatives sont rejetées avec un message clair invalid_input plutôt qu’une division silencieuse par zéro.

Comment fonctionne la formule de décompte des pavés de terrasse

Partez de l’identité de couverture utilisée par tout estimateur hardscape en magasin : le nombre de pavés nécessaires est la surface à couvrir divisée par la face d’un pavé, puis arrondie à l’entier supérieur car les fournisseurs vendent des pièces entières. La surface du patio doit aussi être positive ; le pourcentage de pertes doit être non négatif pour qu’un rectangle parfait à zéro de pertes reste exprimable sans inventer de matériau négatif. Écrivez paver_area égal à paver_length multiplié par paver_width, en utilisant la même unité linéaire que celle qui sous-tend votre patio_area en unités de surface, de sorte que les mètres s’apparient aux mètres carrés et les pieds aux pieds carrés. Appliquez ensuite la marge de pertes comme facteur multiplicatif : waste_factor égal à un plus waste_percent divisé par cent, ainsi dix pour cent de pertes signifie planifier cent dix pour cent du patio nu. Multipliez patio_area par ce facteur pour obtenir area_with_waste — la cible de couverture effective après découpes de bord, courbes autour des jardinières, pièces cassées et extras de lot. Divisez area_with_waste par paver_area pour produire pavers_exact, un nombre réel pouvant avoir une partie fractionnaire. La quantité d’achat pavers_needed est le plafond de pavers_exact. La réponse renvoie aussi les intermédiaires (paver_area, waste_factor, waste_area, area_with_waste, pavers_exact), coverage_area de l’ensemble acheté et spare_area_vs_patio pour auditer le calcul face à un calcul manuel sur le bordereau. Le pipeline est une arithmétique flottante déterministe, sans graines aléatoires, sans horloge murale et sans appels réseau, de sorte que des entrées identiques produisent toujours un JSON identique. La longueur et la largeur du pavé doivent être strictement positives : une taille nulle ou négative est rejetée avec invalid_input car une empreinte nulle rendrait le ratio indéfini et une empreinte négative n’est pas physique.

Ce que vous envoyez et ce que vous recevez

Les quatre champs sont obligatoires. Envoyez quatre nombres finis : patio_area pour la couverture du plan hardscape en unités de surface, paver_length et paver_width pour la paire d’arêtes d’un pavé en unités linéaires correspondantes, et waste_percent comme le pourcentage de matériau extra (par exemple dix pour une marge de dix pour cent). Champs manquants, chaînes non numériques, NaN et Infinity échouent avec invalid_input et ne sont pas facturés. Lorsque paver_length ou paver_width est zéro ou négatif, la requête échoue avec un message indiquant que la taille du pavé doit être positive, afin que le client corrige les dimensions avant de réessayer au lieu de recevoir des pièces Infinity. En cas de succès la réponse renvoie les entrées nettoyées, paver_area, waste_factor, waste_area, area_with_waste, pavers_exact, l’entier pavers_needed, coverage_area, spare_area_vs_patio (combien de surface l’ensemble acheté couvre au-delà du patio nu), un unit_note rappelant de garder un seul système d’unités, et une courte chaîne formula pour la documentation. Les contrôles classiques incluent un patio de vingt-cinq mètres carrés avec des pavés de zéro virgule deux sur zéro virgule un mètre et dix pour cent de pertes : la surface du pavé est 0.02, la surface avec pertes est 27.5, pavers_exact vaut mille trois cent soixante-quinze, et pavers_needed vaut mille trois cent soixante-quinze. Le prix des appels API réussis est la base publiée de $0.002 par élément ; les échecs de validation ne consomment pas le solde prépayé.

Où les calculateurs de pavés apparaissent dans le travail réel

Les propriétaires qui construisent des terrasses, des allées de jardin et des tabliers d’entrée ont besoin d’un décompte de pièces fiable avant de commander en dépôt ou d’envoyer une palette en ligne, surtout lorsque les pavés en béton ou en pierre naturelle ont un prix unitaire élevé et un long délai. Si vous avez plus tard besoin de carrelage intérieur avec emballage en boîtes, de lames de terrasse avec espacement de joints, de volume de mortier pour assises de brique ou de profondeurs de sable et base sous un patio, traitez-les comme des intentions de recherche et des pages d’atterrissage séparées plutôt que de surcharger cette page de calculateur de pavés extérieurs. Les entrepreneurs hardscape construisent des plannings à partir de surfaces de patio mesurées et de formats fabricant ; un unique endpoint déterministe qui plafonne le décompte réduit la dérive de tableur entre l’estimateur et l’acheteur. Les paysagistes comparant trois SKU de pavés pour le même plan peuvent n’échanger que paver_length et paver_width en maintenant patio_area et waste_percent fixes, puis classer pièces totales et couverture de réserve sans redériver la mathématique des pertes à chaque fois. Les gestionnaires immobiliers qui planifient des rafraîchissements de cours multi-logements envoient un lot de surfaces de patio via l’API et joignent pavers_needed aux bons de commande pour que le surstock reste intentionnel plutôt qu’accidentel. Comme cette capacité est un moteur de parse pur, le prix API est la base publiée de $0.002 par élément réussi et l’échec de validation ne consomme pas le solde.