Base de grava para adoquines: yardas desde area y profundidad

Un área o una profundidad nula o negativa se rechazan con un error invalid_input claro en lugar de inventar un albarán a partir de tamaños imposibles. El camino es matemática pura y determinista —sin red, sin semillas aleatorias, sin reloj— de modo que el ejecutor gratuito del navegador y la API de prepago devuelven el mismo JSON tras el redondeo decimal fijo cada vez que la invoca.

Cómo se calculan las yardas cúbicas de base de grava

En caso de éxito la respuesta repite las entradas redondeadas, publica cubic_feet y cubic_yards, los campos de merma, cubic_yards_order para el ticket de compra, formula como la cadena yd3 igual a área por profundidad entre trescientos veinticuatro, message como un resumen breve en inglés de la API, y steps como un arreglo ordenado de líneas de sustitución que puede afirmar en pruebas o mostrar al cliente.

Cómo llamar a la API y qué devuelve

Todos los campos numéricos deben ser finitos; se aceptan formas de cadena de números cuando coinciden con un patrón numérico finito estricto. Prefiera enviar números en lugar de cadenas preformateadas cuando controle el cliente; si debe enviar cadenas, evite sufijos de unidad o separadores de miles que harían fallar el patrón de número finito. Las profundidades típicas de base compactada para patios peatonales de adoquines rondan entre cuatro y seis pulgadas; las entradas y losas de vehículos ligeros suelen pedir seis a ocho pulgadas o más: siga siempre el código local y la ficha del fabricante de adoquines, no un valor genérico de la web. Envíe un cuerpo JSON con dos campos obligatorios: area en pies cuadrados (alias plan_area, patio_area, surface, sq_ft, square_feet, A) y depth en pulgadas de base compactada (alias base_depth, compacted_depth, depth_inches, thickness, base_inches, D). Opcionalmente incluya waste_percent en el intervalo cerrado de cero a cien (alias waste, overage, waste_allowance, spoil); si se omite, por defecto es cero para que el volumen de pedido coincida con las yardas geométricas netas. En caso de éxito la respuesta fija area, depth, depth_ft como depth dividido entre doce, waste_percent y waste_factor, cubic_feet, cubic_yards, waste_cubic_yards, cubic_yards_order, etiquetas de unidad para área profundidad y volumen, formula y message como se describe arriba, y steps como el registro de sustitución. La validación fallida —campos ausentes, números no finitos, área o profundidad nula o negativa, merma fuera de cero a cien, o valores fuera de los límites absolutos— devuelve invalid_input y nunca se cobra. El precio es un fijo $0.002 por petición exitosa con unidad item y precio unitario marginal cero.

Consejos prácticos, límites y búsquedas relacionadas

Si la cantera cotiza la piedra por tonelada, multiplique cubic_yards_order por la densidad aparente que publiquen después de la llamada; esta herramienta devuelve yardas a propósito para que los presupuestos sigan transparentes en la unidad que usan los proveedores en albaranes de árido suelto. Al enseñar o escribir pruebas, combine un patio sencillo de doscientos pies cuadrados a cuatro pulgadas con un segundo caso que incluya un diez por ciento de merma, e incluya una profundidad deliberadamente nula para demostrar la ruta invalid_input. Las tareas fallidas que devuelven invalid_input no consumen saldo prepago, lo que mantiene baratos los scripts exploratorios cuando envía a propósito un área nula para verificar el manejo de errores. Las comprobaciones de ida y vuelta son sencillas: recalcule a mano área por profundidad entre trescientos veinticuatro y confirme que cubic_yards coincide con el mismo redondeo a doce decimales usado en todos los campos numéricos.