Volume de concreto em sapata corrida

Comprimento, largura ou profundidade não positivos—e um rendimento de saco não positivo quando informado—são rejeitados com um erro claro invalid_input em vez de inventar uma concretagem a partir de medidas nulas ou negativas. O caminho é matemática determinística pura—sem rede, sem sementes aleatórias, sem dependência de relógio—de modo que o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON após o arredondamento decimal fixo cada vez que você chama.

Como o volume e os sacos de uma sapata corrida contínua são calculados

Para estimar pré-mistura em saco, divida o volume por bag_volume (o rendimento de um saco em unidades cúbicas coerentes) para obter bags_exact e depois tome o teto para nunca pedir a menos por uma fração de saco. Quando bag_volume é omitido, a calculadora usa o padrão documentado de zero vírgula zero um cinco unidades cúbicas, que corresponde a um saco típico de cerca de vinte e cinco quilogramas em metros cúbicos se suas cotas estão em metros; se você trabalha em pés, envie um rendimento imperial como zero vírgula seis pés cúbicos para um saco comum de oitenta libras. Em caso de sucesso a resposta ecoa as entradas arredondadas, publica plan_area como comprimento vezes largura, volume como o produto do prisma, bag_volume e bag_volume_defaulted, bags_exact e bags inteiros, spare_volume como o rendimento extra do arredondamento para cima, strings formula e unit_note, message como resumo breve, e steps como array ordenado de linhas de substituição que você pode assertar em testes ou mostrar a um cliente.

Como chamar a API e o que volta

Formas em string de números são aceitas quando batem com um padrão numérico finito estrito. Prefira enviar números em vez de strings pré-formatadas quando controla o cliente; quando precisar enviar strings, evite símbolos de moeda, sufixos de unidade ou separadores de milhar que fariam falhar o padrão de número finito. Envie um corpo JSON com três campos obrigatórios e um opcional: length (aliases footing_length, L, len, long, run), width (aliases footing_width, W, w, breadth, trench_width), depth (aliases footing_depth, thickness, height, D, d, thick, pour_depth) e opcional bag_volume (aliases bag_yield, yield_per_bag, bag_size). Length, width e depth devem ser números finitos positivos dentro da faixa absoluta publicada para que produtos intermediários permaneçam finitos em precisão dupla IEEE no Worker e no navegador. Bag_volume, quando fornecido, deve ser igualmente um número finito positivo; quando omitido aplica-se o padrão zero vírgula zero um cinco e bag_volume_defaulted é true. Em sucesso a resposta define plan_area, volume, campos de saco, bags como contagem inteira de compra, spare_volume, formula como a string V igual a length vezes width vezes depth com bags igual ao teto de V sobre bag_volume, unit_note lembrando um único sistema de unidades, message como descrito acima, e steps como o log de substituição. Validação falha—campos ausentes, números não finitos, dimensões não positivas, bag_volume não positivo ou valores fora dos limites absolutos—retorna invalid_input e nunca é cobrada. O preço é um US$ 0,002 fixo por pedido bem-sucedido com unidade item e preço marginal unitário zero. Combine este endpoint com o seu próprio multiplicador de desperdício após a chamada se o engenheiro exigir cinco ou dez por cento a mais; a ferramenta devolve de propósito geometria pura e um teto de sacos transparente para que orçamentos permaneçam auditáveis.

Dicas práticas, limites e buscas relacionadas

Ao ensinar ou escrever testes, emparelhe um caso métrico com o rendimento de saco padrão com um caso imperial que sobrescreve bag_volume, e inclua profundidade ou largura deliberadamente nula para provar o caminho invalid_input. Tarefas falhas que retornam invalid_input não consomem saldo pré-pago, o que mantém baratos scripts exploratórios quando você envia de propósito largura zero para verificar o tratamento de erro. Checagens de ida e volta são fáceis: recalcule à mão comprimento vezes largura vezes profundidade, divida por bag_volume, aplique teto a sacos inteiros e confirme que volume e bags publicados coincidem com o mesmo arredondamento a doze casas usado em todos os campos numéricos.