Arcotangente a due argomenti in gradi
Un vettore con x uguale a −1 e y uguale a 1 punta a 135°, in alto a sinistra. Inserisca entrambe le coordinate, prima y e poi x, e ottenga l’angolo in gradi tra −180 e 180, senza perdere il quadrante. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Y
- 1
- X
- -1
- Gradi
- 135
Questo calcolatore di arcotangente a due argomenti trasforma una direzione cartesiana in un angolo misurato in gradi. Inserisca la coordinata verticale y e la coordinata orizzontale x: il calcolatore valuta atan2(y, x) mantenendo il quadrante che una semplice arcotangente di y diviso x perderebbe. Il risultato copre l’intero intervallo principale, da meno centottanta a centottanta gradi, ed è quindi utile per orientamenti, vettori, grafica, robotica, navigazione e verifiche geometriche. Il calcolo è deterministico, non dipende dalla rete e rifiuta in modo esplicito l’origine, perché il punto (0, 0) non ha direzione.
Perché due argomenti conservano la direzione
Un’arcotangente tradizionale a un solo argomento riceve un rapporto, di solito y diviso x. Da solo, quel rapporto non basta a distinguere tutte le direzioni. Per esempio, i punti (1, 1) e (−1, −1) danno lo stesso rapporto, anche se i loro vettori puntano verso quadranti opposti.
La forma a due argomenti conserva entrambe le coordinate con il loro segno e le usa separatamente, così può stabilire se la direzione si trova a destra o a sinistra dell’asse orizzontale, sopra o sotto di esso. Questo calcolatore segue l’ordine standard atan2(y, x): y è la componente verticale e x quella orizzontale. Gli angoli positivi ruotano in senso antiorario a partire dal semiasse positivo delle x, quelli negativi in senso orario.
Un vettore che punta a destra restituisce zero gradi, uno che punta in alto novanta gradi e uno che punta in basso meno novanta gradi. Un vettore sul semiasse negativo delle x restituisce centottanta gradi. Questo contesto direzionale completo è il motivo principale per usare atan2 invece di calcolare a mano l’arcotangente di un quoziente.
Evita inoltre la divisione per zero quando x vale zero, perché le due coordinate arrivano direttamente alla funzione angolare, senza passare da un rapporto calcolato a parte.
Come inserire le coordinate e interpretare il risultato
Pensi alla coppia come a un vettore che parte dall’origine e arriva al punto di coordinate x in orizzontale e y in verticale. I risultati interi e le diagonali più note restano perciò compatti, mentre le pendenze meno comuni conservano una precisione utile. Il risultato principale rientra nell’intero intervallo in gradi descritto per atan2: i valori sotto l’asse orizzontale sono di norma negativi, quelli sopra positivi.
Se la sua applicazione richiede un intervallo tipo bussola, da zero a trecentosessanta, converta un risultato negativo aggiungendo trecentosessanta dopo averlo ricevuto. Non inverta i campi: atan2 riceve prima y e poi x, e scambiarli in genere misura un angolo diverso. La coppia (0, 0) viene rifiutata.
Alcuni ambienti di programmazione restituiscono per convenzione uno zero per questo dato in ingresso, ma il vettore nullo non ha modulo né direzione univoca, quindi indicare un angolo travisarebbe la geometria.
Dove servono angoli deterministici in gradi
L’arcotangente a due argomenti compare ogni volta che una coppia di componenti con segno deve diventare un orientamento. Nella grafica interattiva, sottragga la posizione di un oggetto da quella del puntatore e invii gli scostamenti verticale e orizzontale risultanti per trovare la rotazione verso il puntatore. In robotica, l’odometria delle ruote, le componenti della velocità o lo spostamento verso un obiettivo possono diventare una direzione di marcia per la diagnostica e la logica di controllo.
Nella pre-elaborazione geografica o di navigazione, le differenze proiettate est-ovest e nord-sud si possono verificare come direzione nel piano prima di applicare un modello di rilevamento più specializzato. Gli insegnanti possono usare lo strumento per mostrare perché l’informazione sul quadrante conta, e le suite di test per creare casi di riferimento trasparenti per assi, diagonali e vettori qualsiasi. L’implementazione si limita alla convalida dei numeri finiti, a un’operazione atan2 nativa e deterministica, alla conversione tramite centottanta diviso pi greco e a un arrotondamento decimale stabile.
Non chiama alcun modello di linguaggio, non interroga servizi esterni, non usa la casualità e non dipende dalla data corrente. Grazie a queste proprietà, gli stessi dati in ingresso producono sempre lo stesso risultato, e la capacità si presta a script, controlli di compilazione, esercitazioni in classe e piccole catene di elaborazione ingegneristiche che hanno bisogno di un risultato chiaro in gradi, non di una lettura visiva opaca.
Casi d'uso
Orientare un oggetto 2D
Converta gli scostamenti con segno del puntatore o di un obiettivo in un angolo di rotazione, mantenendo il quadrante corretto.
Verificare la direzione di un robot
Trasformi le componenti orizzontale e verticale del moto in una direzione in gradi riproducibile per test e diagnostica.
Insegnare il comportamento dei quadranti
Confronti coppie di coordinate con lo stesso rapporto e mostri perché atan2 restituisce direzioni diverse sull’intero piano.
Domande frequenti
Perché atan2 ha bisogno sia di y sia di x?
I loro segni, presi separatamente, individuano il quadrante. Il quoziente di y diviso x perde questa informazione quando le direzioni sono opposte.
In che ordine devo fornire le coordinate?
Prima y e poi x, ciascuna nel proprio campo con nome. È l’ordine della firma consueta atan2(y, x).
Quale intervallo può assumere il risultato?
L’angolo principale va da meno centottanta a centottanta gradi; i valori negativi indicano una rotazione in senso orario a partire dal semiasse positivo delle x.
Perché il punto (0, 0) viene rifiutato?
Il vettore nullo non ha una direzione univoca, quindi un angolo nell’origine non è definito geometricamente.
Come trasformo un risultato negativo in un angolo di bussola?
Aggiunga un giro completo, trecentosessanta gradi, a qualsiasi risultato negativo. I punti sotto l’asse orizzontale danno un angolo negativo, e questa somma dà la stessa direzione misurata sull’intero cerchio.
In che ordine inserisco le coordinate?
Prima y, la componente verticale, poi x, quella orizzontale. Se le scambia, il calcolatore misura un altro angolo: con y uguale a 1 e x uguale a −1 il risultato è 135°.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
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)Esempio di richiesta
{
"y": 1,
"x": -1
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "trig.atan2_degrees",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Come inserire le coordinate e interpretare il risultato
Fornisca y e x come numeri JSON finiti. Il calcolatore restituisce un solo campo, degrees, arrotondato al massimo a dodici cifre decimali per un JSON stabile e leggibile. Entrambi i campi sono obbligatori, e una stringa di testo come il numero uno scritto tra virgolette non viene convertita in silenzio, perché un’API numerica rigorosa intercetta presto gli errori nella forma dei dati.
Dove servono angoli deterministici in gradi
La versione nel browser è comoda per un calcolo singolo, mentre le richieste automatizzate costano $0.002 per ogni elemento riuscito.
Domande tecniche
Quanto costa un calcolo tramite API?
Ogni richiesta API riuscita costa $0.002. Il calcolatore nel browser può eseguire localmente lo stesso calcolo deterministico.