Base gravier paves: yards cubes selon surface et profondeur

Une surface ou une profondeur nulle ou négative est rejetée avec une erreur invalid_input claire au lieu d’inventer un bon de livraison à partir de tailles impossibles. Le chemin est purement mathématique et déterministe — sans réseau, sans graine aléatoire, sans horloge — de sorte que l’exécuteur gratuit du navigateur et l’API prépayée renvoient le même JSON après l’arrondi décimal fixe à chaque appel.

Comment les yards cubes de base en gravier sont calculés

En cas de succès la réponse répète les entrées arrondies, publie cubic_feet et cubic_yards, les champs de perte, cubic_yards_order pour le bon d’achat, formula comme la chaîne yd3 égale surface fois profondeur sur trois cent vingt-quatre, message comme un court résumé en anglais de l’API, et steps comme un tableau ordonné de lignes de substitution que vous pouvez affirmer dans des tests ou montrer au client.

Comment appeler l’API et ce qui revient

Tous les champs numériques doivent être finis ; les formes en chaîne de nombres sont acceptées lorsqu’elles correspondent à un motif numérique fini strict. Préférez envoyer des nombres plutôt que des chaînes préformatées lorsque vous contrôlez le client ; si vous devez envoyer des chaînes, évitez les suffixes d’unité ou séparateurs de milliers qui feraient échouer le motif de nombre fini. Les profondeurs typiques de base compactée pour des terrasses piétonnes en pavés se situent environ entre quatre et six pouces ; les entrées et dalles pour véhicules légers demandent souvent six à huit pouces ou plus — suivez toujours le code local et la fiche du fabricant de pavés, pas une valeur générique du web. Envoyez un corps JSON avec deux champs obligatoires : area en pieds carrés (alias plan_area, patio_area, surface, sq_ft, square_feet, A) et depth en pouces de base compactée (alias base_depth, compacted_depth, depth_inches, thickness, base_inches, D). Incluez éventuellement waste_percent dans l’intervalle fermé de zéro à cent (alias waste, overage, waste_allowance, spoil) ; s’il est omis, la valeur par défaut est zéro pour que le volume commandé coïncide avec les yards géométriques nets. En cas de succès la réponse fixe area, depth, depth_ft comme depth divisé par douze, waste_percent et waste_factor, cubic_feet, cubic_yards, waste_cubic_yards, cubic_yards_order, les libellés d’unité pour surface profondeur et volume, formula et message comme ci-dessus, et steps comme le journal de substitution. Une validation échouée — champs manquants, nombres non finis, surface ou profondeur nulle ou négative, perte hors de zéro à cent, ou valeurs hors des limites absolues — renvoie invalid_input et n’est jamais facturée. Le tarif est un forfait $0.002 par requête réussie avec unité item et prix unitaire marginal nul.

Conseils pratiques, limites et recherches associées

Si la carrière cotise la pierre à la tonne, multipliez cubic_yards_order par la densité apparente qu’elle publie après l’appel ; cet outil renvoie des yards à dessein pour que les devis restent transparents dans l’unité des tickets de granulat en vrac. Pour enseigner ou écrire des tests, associez une terrasse simple de deux cents pieds carrés à quatre pouces à un second cas avec dix pour cent de perte, et incluez une profondeur délibérément nulle pour prouver le chemin invalid_input. Les tâches en échec qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient peu coûteux les scripts exploratoires lorsque vous envoyez volontairement une surface nulle pour vérifier la gestion d’erreur. Les contrôles aller-retour sont simples : recalculez à la main surface fois profondeur sur trois cent vingt-quatre et confirmez que cubic_yards concorde avec le même arrondi à douze décimales utilisé pour tous les champs numériques.