ForHosting KIT · Voyages et géographie

Cap magnétique vers cap vrai

Passez d'un cap au compas à un cap vrai avec votre déclinaison locale : un cap magnétique de 45° avec 5,5° de déclinaison est donne 50,5° vrais, et le retour au magnétique s'affiche à côté. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Cap magnétique en degrés: 45
Déclinaison: 5,5

Vous obtenez

Cap vrai: 50,5
Cap magnétique inverse: 45
Précision: 6

Ce calculateur de cap magnétique vers cap vrai convertit un cap magnétique de boussole en cap vrai à l'aide de la déclinaison magnétique locale, et renvoie la conversion inverse de vrai vers magnétique. La navigation, la topographie, l'aviation, et la cartographie de plein air mélangent presque toujours deux références nord : le nord magnétique tel qu'une boussole libre le voit, et le nord vrai (géographique) le long d'un méridien. La déclinaison est le décalage angulaire signé entre ces pôles à votre emplacement — l'est du nord vrai est positif, l'ouest est négatif — et les identités classiques sont vrai égale magnétique plus déclinaison, et magnétique égale vrai moins déclinaison, avec les caps enroulés dans l'intervalle semi-ouvert de zéro à trois cent soixante degrés. Le moteur est une arithmétique finie entièrement déterministe : aucune recherche réseau d'un modèle magnétique mondial, aucun échantillonnage aléatoire, et aucun raccourci dépendant de la date.

Ce que signifient les caps magnétique et vrai et ce que contient la réponse

Un cap magnétique est l'angle dans le sens horaire depuis le nord magnétique vers un cours ou une ligne de visée, la grandeur qu'une boussole magnétique ou un GPS portable en mode magnétique rapporte typiquement. Un cap vrai est le même type d'angle dans le sens horaire mesuré depuis le nord géographique vrai, la référence utilisée sur la plupart des cartes topographiques, les cartes marines qui tracent les méridiens, et les outils de planification en grand cercle.

La déclinaison magnétique — aussi appelée variation magnétique en contextes aéronautique et maritime — est l'angle signé du nord vrai vers le nord magnétique en un lieu et une époque : lorsque le nord magnétique se situe à l'est du nord vrai, la déclinaison est positive, et lorsqu'il se situe à l'ouest, la déclinaison est négative.

Ce calculateur prend un cap magnétique fini et une déclinaison finie, normalise l'angle magnétique dans la plage semi-ouverte de zéro inclus à trois cent soixante exclu, ajoute la déclinaison pour former le cap vrai, puis soustrait la même déclinaison pour récupérer le cap magnétique inverse afin que vous puissiez voir les deux directions de conversion dans une seule réponse.

Où la conversion magnétique-vrai s'inscrit dans la navigation, la topographie et le logiciel

Les étudiants rencontrent la déclinaison lorsqu'un laboratoire leur demande de tracer un cheminement à la boussole sur une grille de carte au nord vrai, lorsqu'un cours de survie enseigne des mnémoniques du type « est c'est moins, ouest c'est mieux », ou lorsqu'un problème d'école au sol d'aviation convertit des caps de piste magnétiques en cours vrais pour des plans de vol. Géomètres et techniciens SIG convertissent des visées magnétiques de terrain en azimuts vrais avant de les stocker avec des coordonnées projetées.

Pilotes et marins passent entre magnétique et vrai lorsque cartes, pilotes automatiques, et roses de boussole diffèrent de la variation locale imprimée sur la plaque. Les développeurs appellent le même contrat depuis des scripts pour amorcer des vecteurs de test déterministes pour des widgets de navigation, pour normaliser des segments magnétiques saisis par l'utilisateur avant l'affichage sur carte, ou pour satisfaire des énoncés de défi de programmation exigeant des degrés vrais plutôt qu'une esquisse approximative.

Les outils produit et pédagogiques utilisent la conversion lorsqu'un apprenant saisit un cap magnétique et une déclinaison et que l'interface doit montrer à la fois le cours vrai et la vérification magnétique inverse. Associez-le aux outils de boussole-vers-cap ou de loxodromie lorsque vous avez besoin d'étapes géo apparentées, et aux autres points de terminaison d'analyse pour bâtir un petit laboratoire d'auxiliaires de navigation gratuits et déterministes.

Cas d’usage

Boussole de terrain vers grille de carte

Convertissez une visée magnétique portable en cap vrai pour tracer sur une carte topographique ou une couche SIG qui utilise le nord géographique.

Exercices de planification aérienne et maritime

Transformez des cours magnétiques en cours vrais (et inversement) à l'aide de la variation cartographiée pour des examens, des briefings, et des listes de contrôle déterministes.

Questions fréquentes

Combien coûte le calculateur de cap magnétique vers cap vrai ?

Il est gratuit dans votre navigateur sur cette page.

Comment saisir une déclinaison ouest ?

Utilisez un nombre négatif. La déclinaison est est positive.

Que se passe-t-il si le cap magnétique n'est pas un nombre fini ?

L'Infini, NaN, les valeurs vides, et les jetons non numériques ne sont pas acceptés.

Cet outil recherche-t-il la déclinaison à partir de mon emplacement ?

Non. Vous fournissez la déclinaison locale. Le calculateur n'applique que la conversion algébrique ; il n'appelle pas de modèle magnétique mondial.

Puis-je saisir un cap supérieur à 360° ou inférieur à zéro ?

Oui. Un cap comme 405 ou −10 degrés est ramené dans l'intervalle de 0 à 360 avant et après la conversion. La déclinaison, elle, n'est pas ramenée, car c'est un décalage signé et la modifier inverserait le résultat.

Outils associés

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

POSThttps://api.kit.forhosting.com/geo/magnetic-true-bearing

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/magnetic-true-bearing \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"magnetic_bearing":45,"declination":5.5}'

const res = await fetch("https://api.kit.forhosting.com/geo/magnetic-true-bearing", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "magnetic_bearing": 45,
    "declination": 5.5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/magnetic-true-bearing",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "magnetic_bearing": 45,
    "declination": 5.5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/magnetic-true-bearing", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"magnetic_bearing":45,"declination":5.5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"magnetic_bearing":45,"declination":5.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/magnetic-true-bearing", 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

{
  "magnetic_bearing": 45,
  "declination": 5.5
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.magnetic_true_bearing",
  "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

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Limites

max_abs_deg 1000000000000000

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.

Notes techniques

Ce que signifient les caps magnétique et vrai et ce que contient la réponse

La charge utile renvoie magnetic_bearing, declination, true_bearing, reverse_magnetic_bearing, une courte chaîne de formule, l'étiquette de méthode magnetic_true_bearing, et la précision utilisée. Il n'y a aucun chemin de modèle géomagnétique approximatif et aucune substitution silencieuse de tables de déviation : le moteur termine soit avec des angles en virgule flottante stables à l'intérieur de la plage de grandeur prise en charge, soit rejette l'entrée avec invalid_input. Les cas rejetés incluent magnetic_bearing ou declination manquant, des valeurs non finies telles que l'Infini ou NaN, des jetons non numériques, et des grandeurs au-delà du plafond documenté. Si vous avez besoin d'une recherche de modèle magnétique mondial par latitude et date, d'une table de rose nom-de-boussole-vers-degrés, ou d'un cours en grand cercle entre deux coordonnées, utilisez ces outils dédiés ; cette page ne répond qu'à la conversion algébrique magnétique-vrai avec une sortie numérique reproductible adaptée aux feuilles d'exercices, aux tests unitaires et aux consommateurs d'API qui ne doivent pas inventer de données cartographiques.

Comment magnetic_bearing et declination sont lus et comment les résultats restent reproductibles

Les signes plus initiaux facultatifs et la notation scientifique dans les chaînes numériques sont autorisés lorsqu'ils s'analysent comme des décimaux finis ; les espaces intégrés, les préfixes hexadécimaux, et les jetons non numériques sont rejetés avec un message clair afin qu'une cellule erronée ne devienne pas un mauvais cours. La déclinaison ouest est saisie comme un nombre négatif plutôt qu'un indicateur ouest séparé, ce qui garde l'arithmétique identique dans chaque langue et client. Les caps peuvent arriver hors de zéro à trois cent soixante — par exemple quatre cent cinq ou moins dix — et sont normalisés avec une arithmétique modulaire dans cet intervalle avant et après la conversion ; la déclinaison elle-même n'est pas enroulée, car un décalage signé de quelques dizaines de degrés est l'unité prévue et l'enrouler inverserait la conversion. Les champs privilégiés sont magnetic_bearing pour l'angle de boussole en degrés et declination pour le décalage local positif-vers-l'est en degrés, mais les alias magnetic, mag_bearing, M, et bearing pour l'angle magnétique, et decl, magnetic_declination, variation, D, et mag_var pour la déclinaison, sont acceptés afin que tableurs, chaînes de requête, et formulaires typés puissent réutiliser le même contrat. Un champ precision facultatif, avec les alias decimals et dp, choisit combien de décimales exposer pour chaque champ d'angle, par défaut six et plafonné à quinze afin que les goldens JSON restent stables. Associez l'exécution gratuite dans le navigateur de cette page à l'API payante lorsque vous avez besoin du même résultat mathématique au sein d'un pipeline automatisé sans réimplémenter vous-même l'arithmétique de cap modulaire.

Où la conversion magnétique-vrai s'inscrit dans la navigation, la topographie et le logiciel

Sur cette page, le travail s'exécute entièrement dans votre navigateur ; via l'API, chaque recherche réussie coûte $0.002, une validation échouée n'est pas facturée, et rien n'est conservé après le renvoi de la réponse. Cette séparation — exploration interactive gratuite et API payante identique — s'inscrit dans le reste du catalogue de niveau A du KIT et permet de passer d'une démonstration en classe à un pipeline automatisé sans changer le résultat mathématique.

Cas d'intégration

Fixtures de navigation déterministes

Générez des valeurs true_bearing et reverse_magnetic_bearing reproductibles pour tests unitaires, vérifications de propriétés, et assertions CI.

Questions techniques

Comment les caps vrai et magnétique inverse sont-ils définis ?

Avec une déclinaison positive-vers-l'est, true_bearing = normalize(magnetic_bearing + declination) et reverse_magnetic_bearing = normalize(true_bearing − declination). Les caps s'enroulent dans [0, 360).

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Ce que signifient les caps magnétique et vrai et ce que contient la réponse

Où la conversion magnétique-vrai s'inscrit dans la navigation, la topographie et le logiciel

Cas d’usage

Boussole de terrain vers grille de carte

Exercices de planification aérienne et maritime

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Limites

Erreurs

Notes techniques

Ce que signifient les caps magnétique et vrai et ce que contient la réponse

Comment magnetic_bearing et declination sont lus et comment les résultats restent reproductibles

Où la conversion magnétique-vrai s'inscrit dans la navigation, la topographie et le logiciel

Cas d'intégration

Fixtures de navigation déterministes

Questions techniques

merci