Profondeur d'enfouissement du poteau

La même arithmétique déterministe s'exécute gratuitement dans le navigateur et à $0.002 par appel API réussi. La longueur du poteau doit être un nombre positif ; les longueurs nulles, négatives ou non finies échouent avec invalid_input et ne sont pas facturées.

Ce que la règle du tiers et la ligne de gel décident ensemble

Ce calculateur prend donc le maximum de post_length divisé par trois et de frost_line, puis soustrait cette profondeur de trou au poteau pour indiquer la hauteur restante hors sol. La réponse renvoie les longueurs nettoyées, publie third_rule_depth, hole_depth, above_ground_height, un indicateur controlling qui dit quelle règle a gagné, le bury_ratio du trou au poteau et une courte chaîne de formule que vous pouvez imprimer à côté d'un devis. Les cas rejetés comprennent une longueur de poteau manquante ou non positive, une ligne de gel négative et une ligne de gel qui enterrerait tout le poteau de sorte que rien ne reste hors sol.

Contrat d'entrée, forme de la réponse et erreurs

La longueur du poteau doit être un nombre positif strictement supérieur à zéro : c'est le chemin d'erreur documenté, et une longueur nulle ou négative n'est jamais rabotée vers un trou inventé. La ligne de gel doit être non négative ; zéro est admis dans les climats sans gel, où la règle du tiers seule fixe le trou. Un poteau de huit unités avec un gel de deux unités est gouverné par la règle du tiers et laisse environ cinq unités et un tiers hors sol ; le même poteau avec un gel de quatre unités est gouverné par le climat et laisse quatre unités hors sol. Une validation en échec n'est pas facturée. Envoyez un corps JSON en POST avec deux nombres finis obligatoires dans une seule unité linéaire : post_length, la longueur totale de la pièce que vous scellez, et frost_line, la profondeur locale de la ligne de gel d'après une carte communale, une étude de sol ou un inspecteur. Préférez post_length avec les alias length, post, total_length et L afin que formulaires et chaînes de requête réutilisent le même contrat. Préférez frost_line avec les alias frost_line_depth, frost et frost_depth. Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique ; les chaînes vides, les objets et les valeurs non finies échouent avec invalid_input en nommant le champ pour qu'un formulaire mette ce contrôle en évidence. Si frost_line est supérieur ou égal à post_length, la requête est rejetée, car le trou avalerait tout le poteau et ne laisserait aucune hauteur hors sol. En cas de succès le corps inclut l'écho de post_length et frost_line, third_rule_depth comme post_length divisé par trois, hole_depth comme le maximum de ce tiers et de la ligne de gel, above_ground_height comme le reste, bury_ratio comme trou sur poteau, controlling égal à third_rule ou frost_line, et la chaîne de formule. Les résultats sont arrondis à douze décimales pour que goldens, widgets et clients API ne divergent jamais. Les appels API réussis utilisent la base publiée de $0.002 par item.

Où un contrôle de profondeur d'enfouissement de poteau gagne sa place

Sur cette page le travail s'exécute entièrement dans votre navigateur ; via l'API chaque consultation réussie coûte $0.002, une validation en échec n'est pas débitée et rien n'est conservé après le renvoi de la réponse. Cette séparation — exploration interactive gratuite et API payante identique — correspond au reste du catalogue de niveau A et vous permet de passer d'une vérification sur téléphone au chantier à un pipeline automatisé sans changer le résultat mathématique.