Calculadora de tonelagem HVAC

Uma área condicionada não positiva é rejeitada com um erro invalid_input claro, em vez de inventar uma carga a partir de pés quadrados zero ou negativos. O caminho é matemática pura e determinística — sem rede, sem sementes aleatórias, sem dependência do 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 em cada chamada.

Como a tonelagem de AC de toda a casa é estimada a partir da área e do clima

Quando você já conhece um fator climático personalizado de uma tabela de código local ou de uma planilha de carga anterior, envie climate_factor diretamente e ele substitui a tabela de zonas. A resposta informa cooling_btu como a área vezes o fator, tons como cooling_btu dividido por doze mil, recommended_tons como esse valor arredondado para cima até o próximo degrau de meia tonelada para que você possa combinar tamanhos nominais comuns de duas, duas e meia, três toneladas e maiores, e sqft_per_ton como doze mil dividido pelo fator, para confrontar com regras de empreiteiros como uma tonelada por quinhentos a seiscentos pés quadrados.

Como chamar a API e o que retorna

Prefira enviar números em vez de strings pré-formatadas quando você controla o cliente; quando precisar enviar strings, evite sufixos de unidade ou separadores de milhar que fariam falhar o padrão de número finito. Envie um corpo JSON com o sqft obrigatório em pés quadrados condicionados (aliases area, conditioned_sqft, square_feet, floor_area, conditioned_area) e o climate_zone opcional como inteiro de um a oito (aliases zone, iecc_zone, climate; padrão quatro para clima misto quando nem zona nem fator são informados) ou o climate_factor opcional como intensidade positiva em BTU por pé quadrado (aliases btu_per_sqft, factor, load_factor, btu_factor). Quando climate_factor está presente, ele prevalece; climate_zone ainda é ecoado se você enviar ambos, para que auditorias registrem a zona que você tinha em mente. Os pés quadrados devem ser um número finito e positivo dentro da faixa absoluta publicada, para que produtos intermediários permaneçam finitos em precisão dupla IEEE no Worker e no navegador. Um sqft não positivo é o principal erro grave que esta capacidade anuncia: área condicionada zero ou negativa não pode definir a carga de refrigeração de toda a casa e retorna invalid_input. A zona climática deve ser um número inteiro de um a oito; climate_factor deve ser positivo e estar dentro dos limites absolutos. Em caso de sucesso, a resposta ecoa sqft e climate_factor arredondados, publica factor_source como climate_zone ou climate_factor, climate_zone e climate_label quando a zona é conhecida, cooling_btu e btu (o mesmo total), tons, recommended_tons, sqft_per_ton, btu_per_ton como doze mil, unit como tons, formula como a string legível da equação, message como um breve resumo e steps como um array ordenado de linhas de substituição. Validação falha — sqft ausente, números não finitos, área não positiva, zonas inválidas ou valores fora dos limites absolutos — retorna invalid_input e nunca é cobrada. O preço é uma taxa fixa de US$ 0,002 por solicitação bem-sucedida com unidade item.

Dicas práticas, limites e buscas relacionadas

Escolha a zona climática em um mapa IECC ou no código energético local do seu sítio, ou cole um climate_factor personalizado quando um empreiteiro ou um Manual J prévio já indicar BTU por pé quadrado. Ao ensinar ou escrever testes, combine uma casa de dois mil pés quadrados na zona quatro padrão com um caso de zona quente e outro de fator personalizado, e inclua um sqft zero ou negativo deliberado para provar o caminho de 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 deliberadamente sqft zero para verificar o tratamento de erros. Checagens de ida e volta são fáceis: recalcule sqft vezes o climate_factor publicado, divida por doze mil, arredonde para cima até a próxima meia tonelada e confirme que tons e recommended_tons publicados coincidem com o mesmo arredondamento de doze casas usado em todos os campos numéricos.