Conversor de ângulo

Nomes de unidade desconhecidos falham com um erro invalid_input claro em vez de inventar fatores errados em silêncio.

Quais unidades de ângulo plano são aceitas e como funciona a conversão

Aliases comuns são aceitos sem distinção de maiúsculas: degree e degrees para deg, radian e radians para rad, gon grade e gradians para grad, arc minute e minute of arc para arcmin, arc second e second of arc para arcsec, e rev revolution cycle ou full circle para turn. Se o nome não estiver nessa lista, o resolvedor rejeita a requisição com invalid_input, nomeando o campo inválido e listando as unidades aceitas, de modo que o cliente nunca precise adivinhar se um erro de digitação gerou um número errado. Ângulos negativos são permitidos para contextos de orientação dirigida; a magnitude absoluta deve permanecer dentro do limite publicado de um trilhão para que os produtos intermediários continuem finitos na precisão dupla IEEE tanto no Worker quanto no navegador.

Como chamar a API e ler a resposta

O value deve ser um número finito ou uma string numérica estrita dentro dos limites absolutos de um trilhão. Ligue isto a painéis, clientes móveis, auxiliares de CAD ou tarefas em lote que já possuem uma leitura de ângulo e só precisam de uma segunda unidade para exibição, conformidade com normas ou comparação de unidades mistas, sem embarcar tabelas de conversão flutuantes em cada binário de aplicativo. Envie um corpo JSON com três campos obrigatórios: value (aliases angle, amount e n), from (aliases from_unit, unit_from e source) e to (aliases to_unit, unit_to e target). O from e o to devem resolver para nomes de unidade aceitos após a normalização de aliases. Em caso de sucesso, a resposta ecoa o value de entrada arredondado, os rótulos canônicos de from e to, result e converted definidos com a mesma magnitude de destino arredondada, value_rad como o intermediário em radianos, unit como o rótulo de destino, factor como o multiplicador de origem para destino, formula como a string de equação curta, message como um resumo em texto, steps como linhas de substituição ordenadas e supported_units como os seis identificadores canônicos. A validação que falha — campos ausentes, números não finitos, valores fora dos limites absolutos ou um nome de unidade desconhecido — devolve invalid_input e nunca é cobrada. O preço é uma tarifa fixa de US$ 0,002 por requisição bem-sucedida, com item unitário e preço marginal por unidade igual a zero.

Dicas práticas, limites e quando usar esta página

Prefira enviar números puros para value quando você controla o cliente; strings numéricas só são aceitas quando correspondem a um padrão numérico finito estrito, sem símbolos de grau colados aos dígitos — coloque a unidade no campo from em vez disso. Normalize os rótulos de exibição do seu lado se precisar de grafias específicas do idioma; esta API sempre devolve os tokens canônicos curtos deg, rad, grad, arcmin, arcsec e turn para que os testes automatizados permaneçam estáveis. Tarefas que falham e devolvem invalid_input não consomem saldo pré-pago, o que mantém baratos os scripts exploratórios quando os clientes testam de propósito nomes de unidade desconhecidos.