Vettore unitario in latitudine e longitudine
Trasformi una direzione cartesiana sulla sfera unitaria in coordinate geografiche leggibili dalle persone e dai programmi cartografici.
Esegui gratis nel browser
Fornisca le componenti x, y e z di un vettore unitario in un sistema destrorso: il convertitore restituirà latitudine e longitudine in gradi con la precisione di visualizzazione scelta da Lei. Il sistema verifica che il vettore abbia davvero lunghezza unitaria, tollera soltanto una minima deriva in virgola mobile e applica una convenzione degli assi documentata. Il calcolo è deterministico, non richiede rete né banche dati di geocodifica e costa $0.002 per ogni richiesta API riuscita.
Comprendere la convenzione degli assi prima della conversione
Un punto su una sfera unitaria può essere memorizzato tramite tre componenti cartesiane invece di due angoli. Questa capacità adotta la comune convenzione geocentrica destrorsa: x positivo indica latitudine zero e longitudine zero, y positivo indica latitudine zero e longitudine novanta gradi est, mentre z positivo punta al polo nord. Di conseguenza, il vettore (1, 0, 0) diventa zero gradi di latitudine e longitudine, mentre (0, 1, 0) diventa latitudine zero e longitudine novanta gradi est. Una componente y negativa colloca il risultato a ovest del meridiano fondamentale; una componente z negativa lo colloca nell’emisfero meridionale. La longitudine restituita segue l’intervallo convenzionale da meno centottanta a più centottanta gradi. In entrambi i poli la longitudine è matematicamente indeterminata, perché tutti i meridiani vi convergono; il calcolo restituisce comunque il valore stabile prodotto da atan2 usando le componenti x e y ricevute. Prima di interpretare il risultato come coordinata geografica, verifichi che i vettori provenienti da software grafico, astronomico, robotico o di simulazione usino lo stesso ordine degli assi. Alcuni sistemi scambiano y e z oppure invertono un asse. Lo strumento converte coordinate, ma non deduce né corregge un sistema sorgente non documentato.
Come operano la convalida e la conversione sferica
Il convertitore controlla anzitutto che x, y e z siano numeri JSON finiti compresi tra meno uno e più uno. Calcola quindi la loro grandezza euclidea con l’operazione di ipotenusa a tre componenti. Un vero vettore unitario ha grandezza uno, ma le pipeline reali possono introdurre una lieve deriva in virgola mobile dopo una moltiplicazione tra matrici o una serializzazione. Per questo motivo vengono accettate e normalizzate, prima del calcolo degli angoli, le grandezze che distano da uno meno di un milionesimo. Scostamenti maggiori producono un errore di input anziché proiettare silenziosamente un vettore arbitrario sulla sfera. La latitudine è l’arcoseno di z normalizzato. La longitudine è atan2 di y normalizzato e x normalizzato: questa funzione conserva il quadrante corretto e attraversa l’antimeridiano senza regole manuali sul segno. I due angoli vengono convertiti da radianti a gradi e arrotondati alla precisione richiesta, dieci cifre per impostazione predefinita oppure da zero a quindici quando Lei la specifica. Lo zero negativo diventa zero ordinario per mantenere stabili JSON e test. La risposta comprende latitudine, longitudine, gli alias lat e lon, la precisione applicata e l’etichetta della convenzione. Non intervengono rete, casualità, orologio, datum o approssimazioni iterative.
Usare il risultato correttamente in mappe e flussi di dati
I vettori unitari evitano la discontinuità del ritorno della longitudine, consentono di interpolare agevolmente le direzioni e si adattano ai motori tridimensionali. Le interfacce per le persone, le esportazioni GIS, i registri e le etichette cartografiche richiedono invece latitudine e longitudine. Questo convertitore collega le due rappresentazioni. Lei può trasformare il raggio di una fotocamera o una selezione su un globo in una coordinata leggibile, decodificare posizioni normalizzate di una simulazione o creare casi di prova chiari per la geometria sferica. Verifichi anche il significato dei dati sorgente: una normale di superficie normalizzata e una posizione geocentrica possono avere la stessa forma numerica, ma rappresentano concetti differenti. Se il vettore sorgente ha lunghezza arbitraria, lo normalizzi consapevolmente nel sistema che lo produce e documenti la scelta, senza chiedere a questo endpoint di nascondere la differenza. Il controllo rigoroso della lunghezza unitaria individua unità errate, normalizzazione mancante e record danneggiati. Il risultato esprime soltanto una direzione angolare e non contiene altitudine, rilievo, conversione del datum o nomi geografici. Per i lotti richiami la capacità una volta per elemento e conservi la precisione utile. Il browser gestisce le prove interattive; l’automazione usa lo stesso risolutore per $0.002 a richiesta riuscita.
Casi d'uso
Etichettare una selezione su un globo 3D
Converta una direzione normalizzata selezionata su un globo in latitudine e longitudine per un suggerimento, un pannello diagnostico o un indicatore esportato.
Decodificare coordinate di simulazione
Trasformi posizioni sulla sfera unitaria provenienti da dati scientifici o tecnici in coordinate angolari leggibili con una convenzione documentata.
Creare casi di prova per la geometria sferica
Generi valori attesi stabili di latitudine e longitudine per test che memorizzano direzioni come vettori cartesiani normalizzati.
Domande frequenti
Quanto costa una conversione?
Ogni richiesta API riuscita costa $0.002. Lo stesso calcolo deterministico può essere eseguito nel browser.
Quale formula viene utilizzata?
La latitudine è asin(z) e la longitudine è atan2(y, x), dopo aver normalizzato il vettore accettato per eliminare la minima deriva numerica.
Il vettore deve avere lunghezza unitaria esatta?
La grandezza deve distare da uno meno di un milionesimo. La tolleranza ammette la normale deriva numerica e respinge vettori non normalizzati.
Quale convenzione di coordinate è richiesta?
x positivo indica latitudine 0 e longitudine 0, y positivo latitudine 0 e longitudine 90 est, mentre z positivo indica il polo nord.
Quale longitudine viene restituita a un polo?
La longitudine non è definita nel polo esatto, ma la risposta riporta il risultato stabile di atan2 calcolato dalle componenti x e y fornite.
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/geo/unit-vector-to-latlon \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"x":1,"y":0,"z":0}'const res = await fetch("https://api.kit.forhosting.com/geo/unit-vector-to-latlon", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"x": 1,
"y": 0,
"z": 0
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/geo/unit-vector-to-latlon",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"x": 1,
"y": 0,
"z": 0
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/unit-vector-to-latlon", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"x":1,"y":0,"z":0}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"x":1,"y":0,"z":0}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/unit-vector-to-latlon", 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
{
"x": 1,
"y": 0,
"z": 0
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.unit_vector_to_latlon",
"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. |