ForHosting KIT · Outils pour développeurs

Déclinaison du quadrillage : nord grille, vrai et magnétique

Ce calculateur combine la convergence du quadrillage et la déclinaison magnétique afin de convertir les relèvements de façon cohérente entre le nord grille, le nord géographique ou vrai et le nord magnétique.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Saisissez les deux angles en degrés décimaux selon la convention est positif. Le résultat fournit la déclinaison du quadrillage ainsi que chaque correction directe et inverse : vous n'avez donc plus à deviner s'il faut ajouter ou soustraire. Cet outil convient à la cartographie, aux levés, à la navigation et aux logiciels qui doivent indiquer clairement la référence nord.

Distinguez les trois références nord

Un relèvement cartographique n'est complet que si sa référence nord est connue. Le nord vrai, ou nord géographique, suit le méridien vers le pôle géographique. Le nord grille suit les lignes verticales d'un quadrillage projeté. Ces lignes ne coïncident généralement pas exactement avec le méridien local ; la convergence du quadrillage exprime leur écart angulaire. Le nord magnétique suit la direction locale du champ magnétique et varie selon le lieu et le temps ; la déclinaison magnétique indique son écart par rapport au nord vrai. Ce calculateur impose une convention sans ambiguïté : les angles horaires, ou vers l'est, sont positifs, tandis que les angles vers l'ouest sont négatifs. La convergence est l'angle du nord vrai au nord grille et la déclinaison, celui du nord vrai au nord magnétique. L'outil ne déduit aucune entrée à partir de coordonnées, d'une projection, d'une date ou d'un modèle magnétique. Utilisez des valeurs correspondant au même lieu et à la même date d'observation.

Appliquez les corrections sans hésiter sur le signe

Chaque champ de conversion renvoyé est une correction additive. Pour convertir un relèvement, ajoutez le champ dont le nom part de la référence actuelle et aboutit à la référence voulue. Ainsi, ajoutez <code>grid_to_true_offset_deg</code> à un relèvement grille pour obtenir le relèvement vrai. Ajoutez <code>grid_to_magnetic_offset_deg</code> pour passer directement du nord grille au nord magnétique. Les champs inverses ont des signes exactement opposés avant l'arrondi. Selon la convention annoncée, le relèvement vrai égale le relèvement grille plus la convergence, et le relèvement magnétique égale le vrai moins la déclinaison. Le champ <code>grid_declination_deg</code> donne l'angle signé du nord grille au nord magnétique : déclinaison magnétique moins convergence. Après l'ajout, normalisez le relèvement final dans l'intervalle de votre procédure, souvent de 0 inclus à 360 exclu. Les corrections sont normalisées dans l'intervalle signé supérieur à moins 180 et inférieur ou égal à 180 degrés.

Choisissez et contrôlez les bonnes valeurs sources

La convergence du quadrillage dépend d'un système de coordonnées projetées et d'un point précis. Ne réutilisez pas une valeur provenant d'une autre zone et ne supposez pas que le bord d'une carte imprimée conserve partout le même rapport au nord vrai. La déclinaison magnétique dépend également du lieu et de l'époque, car le champ magnétique évolue. Obtenez-la auprès d'un modèle, d'une carte ou d'un relevé de terrain récent et fiable, puis vérifiez si la source emploie des degrés signés est positif ou des indications est/ouest. Convertissez les valeurs ouest en nombres négatifs avant l'envoi. Pour contrôler le calcul, choisissez un relèvement, effectuez une boucle fermée de conversions et vérifiez le retour à la valeur initiale après normalisation. Les corrections grille-vers-vrai et vrai-vers-grille doivent s'annuler, tout comme celles entre grille et magnétique. La précision facultative règle uniquement les décimales affichées, sans garantir une exactitude topographique. L'API coûte $0.002 par requête.

Cas d’usage

Préparer une fiche de navigation

Transformez convergence et déclinaison publiées en corrections explicites pour les relèvements grille, vrais et magnétiques.

Contrôler des calculs topographiques

Vérifiez que le travail de terrain ou de bureau applique le bon signe lors d'un changement de référence nord.

Créer un logiciel cartographique

Produisez des constantes déterministes et conservez les angles d'entrée et la convention de signe avec le résultat.

Questions fréquentes

Qu'est-ce que la déclinaison du quadrillage ?

Il s'agit ici de l'angle signé du nord grille au nord magnétique. Avec l'est positif, elle vaut la déclinaison magnétique moins la convergence.

Quelle convention de signe est employée ?

Les angles horaires ou vers l'est sont positifs ; ceux vers l'ouest sont négatifs. Chaque correction nommée s'ajoute au relèvement source.

Comment convertir un relèvement grille en relèvement magnétique ?

Ajoutez grid_to_magnetic_offset_deg au relèvement grille, puis normalisez le résultat dans l'intervalle souhaité.

Calcule-t-il la convergence ou la déclinaison depuis des coordonnées ?

Non. Il combine des valeurs connues. Déterminez la convergence avec la projection pertinente et obtenez la déclinaison pour le bon lieu et la bonne date.

Combien coûte une requête API ?

Chaque requête API coûte $0.002. Le calcul peut aussi s'exécuter gratuitement dans le navigateur grâce à une arithmétique locale déterministe.

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/grid-to-geographic-offset

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/grid-to-geographic-offset \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"grid_convergence_deg":2.25,"magnetic_declination_deg":7.5}'

const res = await fetch("https://api.kit.forhosting.com/geo/grid-to-geographic-offset", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "grid_convergence_deg": 2.25,
    "magnetic_declination_deg": 7.5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/grid-to-geographic-offset",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "grid_convergence_deg": 2.25,
    "magnetic_declination_deg": 7.5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/grid-to-geographic-offset", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"grid_convergence_deg":2.25,"magnetic_declination_deg":7.5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"grid_convergence_deg":2.25,"magnetic_declination_deg":7.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/grid-to-geographic-offset", 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

{
  "grid_convergence_deg": 2.25,
  "magnetic_declination_deg": 7.5
}

Exemple de réponse

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

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.

Consulter la documentation complète du KIT →