Arco tangente de dois argumentos em graus
Um vetor com x igual a −1 e y igual a 1 aponta para 135°, para cima e à esquerda. Informe as duas coordenadas, primeiro y e depois x, e receba o ângulo em graus entre −180 e 180, sem perder o quadrante. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Y
- 1
- X
- -1
- Graus
- 135
Esta calculadora de arco tangente de dois argumentos converte uma direção cartesiana em um ângulo medido em graus. Informe a coordenada vertical (y) e a coordenada horizontal (x), e ela calcula atan2(y, x) preservando o quadrante que um arco tangente simples de y dividido por x perderia. O resultado cobre todo o intervalo principal, de menos cento e oitenta a cento e oitenta graus, o que o torna útil para rumos, vetores, computação gráfica, robótica, navegação e verificações de geometria. O cálculo é determinístico, não depende de conexão de rede e rejeita claramente a origem, porque o ponto (0, 0) não tem direção.
Por que dois argumentos preservam a direção
Um arco tangente convencional, de um só argumento, recebe uma razão, normalmente y dividido por x. Só essa razão não basta para distinguir todas as direções. Por exemplo, os pontos (1, 1) e (−1, −1) produzem a mesma razão, embora seus vetores apontem para quadrantes opostos.
A forma de dois argumentos mantém as duas coordenadas com seus sinais e as usa separadamente, por isso consegue identificar se a direção fica à direita ou à esquerda, e acima ou abaixo do eixo horizontal. Esta calculadora segue a ordem padrão atan2(y, x): y é a componente vertical e x, a horizontal. Ângulos positivos giram no sentido anti-horário a partir do semieixo x positivo, e ângulos negativos, no sentido horário.
Um vetor que aponta para a direita retorna zero grau, um que aponta para cima retorna noventa graus e um que aponta para baixo retorna menos noventa graus. Um vetor sobre o semieixo x negativo retorna cento e oitenta graus. Esse contexto direcional completo é o principal motivo para usar atan2 em vez de calcular manualmente o arco tangente de um quociente.
Ele também evita a divisão por zero quando x vale zero, porque as duas coordenadas vão diretamente para a função angular, sem passar por uma razão calculada à parte.
Como informar as coordenadas e interpretar o resultado
Pense no par como um vetor que começa na origem e termina no ponto cujas coordenadas são x na horizontal e y na vertical. Resultados inteiros e diagonais conhecidas, portanto, continuam enxutos, enquanto inclinações menos comuns mantêm uma precisão útil. O resultado principal fica dentro do intervalo completo em graus descrito para atan2: valores abaixo do eixo horizontal normalmente são negativos, e valores acima dele, positivos.
Se a sua aplicação exige um intervalo no estilo de bússola, de zero a trezentos e sessenta, converta um resultado negativo somando trezentos e sessenta depois de recebê-lo. Não inverta os campos: atan2 recebe y primeiro e x depois, e trocá-los geralmente mede outro ângulo. O par (0, 0) é rejeitado.
Embora alguns ambientes de programação retornem um zero convencional para essa entrada, o vetor nulo não tem módulo nem direção única, então informar um ângulo distorceria a geometria.
Onde ângulos determinísticos em graus são úteis
O arco tangente de dois argumentos aparece sempre que um par de componentes com sinal precisa virar uma orientação. Em gráficos interativos, subtraia a posição de um objeto da posição do ponteiro e envie os deslocamentos vertical e horizontal resultantes para obter a rotação em direção ao ponteiro. Em robótica, a odometria das rodas, as componentes da velocidade ou o deslocamento até um alvo podem virar um rumo para diagnóstico e lógica de controle.
No pré-processamento geográfico ou de navegação, diferenças projetadas leste-oeste e norte-sul podem ser conferidas como uma direção no plano antes de aplicar um modelo de rumo mais especializado. Professores podem usar a ferramenta para mostrar por que a informação do quadrante importa, e conjuntos de testes podem usá-la para criar casos de referência transparentes para eixos, diagonais e vetores quaisquer. A implementação usa apenas a validação de números finitos, uma operação atan2 nativa e determinística, a conversão por cento e oitenta dividido por pi e um arredondamento decimal estável.
Ela não chama modelo de linguagem, não consulta serviço externo, não usa aleatoriedade e não depende da data atual. Graças a essas propriedades, entradas repetidas sempre dão o mesmo resultado, e a capacidade se presta a scripts, verificações de compilação, exercícios em sala de aula e pequenos fluxos de engenharia que precisam de um resultado claro em graus, e não de uma leitura visual opaca.
Casos de uso
Apontar um objeto 2D
Converta deslocamentos com sinal do ponteiro ou de um alvo em um ângulo de rotação, mantendo o quadrante correto.
Conferir o rumo de robôs
Transforme as componentes horizontal e vertical do movimento em um rumo em graus reproduzível para testes e diagnósticos.
Ensinar o comportamento dos quadrantes
Compare pares de coordenadas com a mesma razão e mostre por que atan2 retorna direções diferentes no plano completo.
Perguntas frequentes
Por que atan2 precisa de y e de x?
Os sinais de cada um, separadamente, identificam o quadrante. O quociente de y por x perde essa informação quando as direções são opostas.
Em que ordem devo informar as coordenadas?
Informe y primeiro e x depois, nos campos com nome. Essa é a mesma ordem da assinatura convencional atan2(y, x).
Qual é o intervalo possível do resultado?
O ângulo principal vai de menos cento e oitenta a cento e oitenta graus; valores negativos representam rotação no sentido horário a partir do semieixo x positivo.
Por que o ponto (0, 0) é rejeitado?
O vetor nulo não tem uma direção única, então um ângulo na origem é geometricamente indefinido.
Como transformar um resultado negativo em ângulo de bússola?
Some uma volta completa, trezentos e sessenta graus, a qualquer resultado negativo. Pontos abaixo do eixo horizontal saem com ângulo negativo, e essa soma dá a mesma direção medida sobre o círculo completo.
Em que ordem informo as coordenadas?
Primeiro y, a componente vertical, e depois x, a horizontal. Se você trocar a ordem, a calculadora mede outro ângulo: com y igual a 1 e x igual a −1, o resultado é 135°.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/trig/atan2-degrees \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"y":1,"x":-1}'const res = await fetch("https://api.kit.forhosting.com/trig/atan2-degrees", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"y": 1,
"x": -1
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/trig/atan2-degrees",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"y": 1,
"x": -1
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/trig/atan2-degrees", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"y":1,"x":-1}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"y":1,"x":-1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/trig/atan2-degrees", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"y": 1,
"x": -1
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "trig.atan2_degrees",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Como informar as coordenadas e interpretar o resultado
Informe y e x como números JSON finitos. A calculadora retorna um único campo, degrees, arredondado a no máximo doze casas decimais, para um JSON estável e legível. Os dois campos são obrigatórios, e textos como o número um enviado entre aspas não são convertidos silenciosamente, porque uma API numérica estrita detecta cedo erros no formato dos dados.
Onde ângulos determinísticos em graus são úteis
A versão no navegador é prática para um cálculo avulso, enquanto requisições automatizadas custam US$ 0,002 por item bem-sucedido.
Perguntas técnicas
Quanto custa um cálculo pela API?
Cada requisição bem-sucedida à API custa US$ 0,002. A calculadora do navegador pode executar localmente o mesmo cálculo determinístico.