Calculadora de tonelaje HVAC

Un área acondicionada no positiva se rechaza con un error invalid_input claro, en lugar de inventar una carga a partir de pies cuadrados cero o negativos. El recorrido es matemática pura y determinista —sin red, sin semillas aleatorias, sin dependencia del reloj—, de modo que el ejecutor gratuito del navegador y la API de prepago devuelven el mismo JSON tras el redondeo decimal fijo en cada llamada.

Cómo se estima el tonelaje de AC de toda la vivienda a partir del área y el clima

Cuando ya conoce un factor climático personalizado de una tabla de código local o de una hoja de carga previa, envíe climate_factor directamente y anula la tabla de zonas. La respuesta informa cooling_btu como el área por el factor, tons como cooling_btu dividido entre doce mil, recommended_tons como ese valor redondeado al alza al siguiente escalón de media tonelada para que pueda igualar tamaños nominales habituales de dos, dos y media, tres toneladas y mayores, y sqft_per_ton como doce mil dividido entre el factor, para contrastarlo con reglas de contratistas como una tonelada por cada quinientos a seiscientos pies cuadrados.

Cómo llamar a la API y qué devuelve

Es preferible enviar números en lugar de cadenas preformateadas cuando usted controla el cliente; cuando deba enviar cadenas, evite sufijos de unidad o separadores de miles que harían fallar el patrón de número finito. Envíe un cuerpo JSON con el sqft obligatorio en pies cuadrados acondicionados (alias area, conditioned_sqft, square_feet, floor_area, conditioned_area) y el climate_zone opcional como entero del uno al ocho (alias zone, iecc_zone, climate; por defecto cuatro para clima mixto cuando no se da ni zona ni factor) o el climate_factor opcional como intensidad positiva en BTU por pie cuadrado (alias btu_per_sqft, factor, load_factor, btu_factor). Cuando climate_factor está presente, prevalece; climate_zone se sigue devolviendo si envía ambos, para que las auditorías registren la zona que tenía en mente. Los pies cuadrados deben ser un número finito y positivo dentro del rango absoluto publicado, de modo que los productos intermedios sigan siendo finitos en doble precisión IEEE en el Worker y en el navegador. Un sqft no positivo es el principal error grave que anuncia esta capacidad: un área acondicionada cero o negativa no puede definir la carga de refrigeración de toda la vivienda y devuelve invalid_input. La zona climática debe ser un entero del uno al ocho; climate_factor debe ser positivo y estar dentro de los límites absolutos. En caso de éxito, la respuesta devuelve sqft y climate_factor redondeados, publica factor_source como climate_zone o climate_factor, climate_zone y climate_label cuando se conoce la zona, cooling_btu y btu (el mismo total), tons, recommended_tons, sqft_per_ton, btu_per_ton como doce mil, unit como tons, formula como la cadena legible de la ecuación, message como un breve resumen y steps como un array ordenado de líneas de sustitución. Una validación fallida —sqft ausente, números no finitos, área no positiva, zonas no válidas o valores fuera de los límites absolutos— devuelve invalid_input y nunca se cobra. El precio es una tarifa plana de $0.002 por solicitud correcta con unidad item.

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

Elija la zona climática en un mapa IECC o en el código energético local de su emplazamiento, o pegue un climate_factor personalizado cuando un contratista o un Manual J previo ya indique BTU por pie cuadrado. Al enseñar o escribir pruebas, combine una casa de dos mil pies cuadrados en zona cuatro por defecto con un caso de zona calurosa y otro de factor personalizado, e incluya un sqft cero o negativo deliberado para comprobar la ruta de invalid_input. Las tareas fallidas que devuelven invalid_input no consumen saldo de prepago, lo que mantiene baratos los scripts exploratorios cuando envía deliberadamente sqft cero para verificar la gestión de errores. Las comprobaciones de ida y vuelta son fáciles: recalcule sqft por el climate_factor publicado, divida entre doce mil, redondee al alza a la siguiente media tonelada y confirme que tons y recommended_tons publicados coinciden con el mismo redondeo de doce decimales usado en todos los campos numéricos.