Base de cascalho para paves: jardas de area e profundidade

Área ou profundidade zero ou negativa são rejeitadas com um erro invalid_input claro em vez de inventar um ticket a partir de tamanhos impossíveis. O caminho é matemática pura e determinística —sem rede, sem sementes aleatórias, sem 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ê a chama.

Como as jardas cúbicas de base de cascalho são calculadas

Em sucesso a resposta ecoa as entradas arredondadas, publica cubic_feet e cubic_yards, campos de desperdício, cubic_yards_order para o ticket de compra, formula como a string yd3 igual a área vezes profundidade sobre trezentos e vinte e quatro, message como um resumo curto em inglês da API, e steps como um array ordenado de linhas de substituição que você pode afirmar em testes ou mostrar ao cliente.

Como chamar a API e o que volta

Todos os campos numéricos devem ser finitos; 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 você controla o cliente; se precisar enviar strings, evite sufixos de unidade ou separadores de milhar que fariam falhar o padrão de número finito. As profundidades típicas de base compactada para pátios peatonais de pavés ficam entre cerca de quatro e seis polegadas; entradas e lajes de veículos leves costumam pedir seis a oito polegadas ou mais — siga sempre o código local e a ficha do fabricante de pavés, não um valor genérico da web. Envie um corpo JSON com dois campos obrigatórios: area em pés quadrados (aliases plan_area, patio_area, surface, sq_ft, square_feet, A) e depth em polegadas de base compactada (aliases base_depth, compacted_depth, depth_inches, thickness, base_inches, D). Opcionalmente inclua waste_percent no intervalo fechado de zero a cem (aliases waste, overage, waste_allowance, spoil); quando omitido, o padrão é zero para que o volume de pedido coincida com as jardas geométricas líquidas. Em sucesso a resposta define area, depth, depth_ft como depth dividido por doze, waste_percent e waste_factor, cubic_feet, cubic_yards, waste_cubic_yards, cubic_yards_order, rótulos de unidade para área profundidade e volume, formula e message como descrito acima, e steps como o log de substituição. Validação falha —campos ausentes, números não finitos, área ou profundidade zero ou negativa, desperdício fora de zero a cem, ou valores fora dos limites absolutos— devolve invalid_input e nunca é cobrada. O preço é um valor fixo US$ 0,002 por pedido bem-sucedido com unidade item e preço unitário marginal zero.

Dicas práticas, limites e buscas relacionadas

Se a pedreira cotar pedra por tonelada, multiplique cubic_yards_order pela densidade aparente que publicarem depois da chamada; esta ferramenta devolve jardas de propósito para que orçamentos fiquem transparentes na unidade que os fornecedores usam em tickets de agregado solto. Ao ensinar ou escrever testes, combine um pátio simples de duzentos pés quadrados a quatro polegadas com um segundo caso que inclua dez por cento de desperdício, e inclua uma profundidade deliberadamente zero para provar o caminho invalid_input. Tarefas falhas que devolvem invalid_input não consomem saldo pré-pago, o que mantém baratos scripts exploratórios quando você envia de propósito uma área zero para verificar o tratamento de erro. Checagens de ida e volta são fáceis: recalcule à mão área vezes profundidade sobre trezentos e vinte e quatro e confirme que cubic_yards coincide com o mesmo arredondamento de doze decimais usado em todos os campos numéricos.