Vecteur unitaire vers latitude et longitude
Transformez une direction cartésienne sur la sphère unitaire en coordonnées géographiques lisibles par une personne ou un logiciel cartographique.
Lancer gratuitement
Fournissez les composantes x, y et z d’un vecteur unitaire dans un repère direct : ce convertisseur renvoie la latitude et la longitude en degrés avec la précision d’affichage que vous choisissez. Il vérifie que le vecteur est bien unitaire, ne tolère qu’un très faible écart d’arrondi et applique une convention d’axes documentée. Le calcul est déterministe, ne nécessite ni réseau ni base de géocodage et coûte $0.002 par requête API réussie.
Comprendre la convention des axes avant la conversion
Un point d’une sphère unitaire peut être enregistré sous forme de trois composantes cartésiennes plutôt que de deux angles. Cette capacité emploie la convention géocentrique directe courante : l’axe x positif vise la latitude zéro et la longitude zéro, l’axe y positif la latitude zéro et la longitude quatre-vingt-dix degrés est, et l’axe z positif le pôle Nord. Ainsi, le vecteur (1, 0, 0) donne une latitude et une longitude nulles, tandis que (0, 1, 0) donne une latitude nulle et une longitude de quatre-vingt-dix degrés est. Une composante y négative place le résultat à l’ouest du méridien origine ; une composante z négative le place dans l’hémisphère Sud. La longitude renvoyée appartient à l’intervalle conventionnel allant de moins cent quatre-vingts à plus cent quatre-vingts degrés. Aux pôles, elle est mathématiquement indéterminée puisque tous les méridiens s’y rejoignent ; le calcul fournit néanmoins la valeur stable produite par atan2 à partir des composantes x et y reçues. Avant toute interprétation géographique, vérifiez que les vecteurs issus d’un logiciel graphique, astronomique, robotique ou de simulation respectent ce même ordre d’axes. Certains systèmes permutent y et z ou inversent un axe. Cet outil convertit les coordonnées, mais ne devine ni ne corrige un repère source non documenté.
Fonctionnement de la validation et du calcul sphérique
Le convertisseur vérifie d’abord que x, y et z sont des nombres JSON finis compris entre moins un et plus un. Il calcule ensuite leur norme euclidienne au moyen de l’hypoténuse à trois composantes. Un véritable vecteur unitaire possède une norme égale à un, mais les chaînes de traitement réelles introduisent parfois un écart d’arrondi insignifiant après une multiplication matricielle ou une sérialisation. Les normes situées à moins d’un millionième de un sont donc acceptées et normalisées avant le calcul des angles. Un écart supérieur déclenche une erreur de saisie au lieu de projeter silencieusement un vecteur quelconque sur la sphère. La latitude correspond à l’arc sinus de z normalisé. La longitude est calculée par atan2 avec y et x normalisés, ce qui conserve le bon quadrant et franchit l’antiméridien sans règle de signe manuelle. Les deux angles sont convertis des radians en degrés, puis arrondis à la précision demandée : dix décimales par défaut, ou de zéro à quinze si vous la précisez. Le zéro négatif devient un zéro ordinaire afin de stabiliser les réponses JSON et les tests. La réponse contient les champs latitude et longitude, leurs alias lat et lon, la précision appliquée et l’étiquette de convention. Aucun réseau, hasard, horloge, datum ni calcul itératif n’intervient.
Employer le résultat correctement dans les cartes et les données
Les vecteurs unitaires évitent la discontinuité liée au bouclage de la longitude, permettent d’interpoler les directions sans à-coups et s’intègrent naturellement aux moteurs tridimensionnels. Les interfaces destinées aux utilisateurs, les exports GIS, les journaux et les étiquettes cartographiques demandent plutôt une latitude et une longitude. Ce convertisseur fait le lien entre ces représentations. Vous pouvez convertir un rayon de caméra ou une sélection sur un globe en coordonnées lisibles, décoder des positions normalisées conservées dans un jeu de simulation ou créer des cas de test explicites pour un programme de géométrie sphérique. Validez aussi la signification des données sources : une normale de surface normalisée et une position géocentrique peuvent avoir la même forme numérique tout en décrivant des objets différents. Si le vecteur source possède une longueur arbitraire, normalisez-le volontairement dans le système producteur et consignez ce choix, plutôt que de masquer l’écart dans ce service. Le contrôle strict de la norme sert à révéler les mauvaises unités, l’absence de normalisation et les enregistrements endommagés. Le résultat décrit uniquement une direction angulaire, sans altitude, relief, transformation de datum ni nom de lieu. Pour un lot, appelez la capacité une fois par élément et gardez la précision nécessaire. Le navigateur effectue les essais interactifs ; l’automatisation emploie le même solveur pour $0.002 par requête réussie.
Cas d’usage
Étiqueter une sélection sur un globe 3D
Convertissez une direction normalisée choisie sur un globe en latitude et longitude pour une infobulle, un panneau de diagnostic ou un repère exporté.
Décoder des coordonnées de simulation
Transformez les positions sur sphère unitaire de données scientifiques ou techniques en coordonnées angulaires lisibles selon une convention d’axes documentée.
Créer des jeux d’essai de géométrie sphérique
Produisez des valeurs attendues stables de latitude et longitude pour les tests qui stockent les directions sous forme de vecteurs cartésiens normalisés.
Questions fréquentes
Quel est le prix d’une conversion ?
Une requête API réussie coûte $0.002. Le même calcul déterministe peut être exécuté dans le navigateur.
Quelle formule est appliquée ?
La latitude vaut asin(z) et la longitude atan2(y, x), après normalisation du vecteur accepté pour éliminer un faible écart d’arrondi.
Le vecteur doit-il être exactement unitaire ?
Sa norme doit être distante de moins d’un millionième de un. Cette marge accepte l’arrondi normal et rejette les vecteurs non normalisés.
Quelle convention de coordonnées faut-il respecter ?
x positif correspond à la latitude 0 et la longitude 0, y positif à la latitude 0 et la longitude 90 est, et z positif au pôle Nord.
Quelle longitude est renvoyée à un pôle ?
La longitude n’est pas définie au pôle exact, mais la réponse fournit le résultat stable de atan2 calculé avec les composantes x et y reçues.
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre 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)Exemple de requête
{
"x": 1,
"y": 0,
"z": 0
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "geo.unit_vector_to_latlon",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |