ForHosting KIT · Outils pour développeurs

Gisement relatif depuis le cap

Ce calculateur convertit le relèvement vrai d’une cible en angle observé depuis l’étrave du navire.

● BetaGratuit · dans votre navigateur

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Indiquez le relèvement vrai vers la cible et le cap vrai du navire, tous deux mesurés en degrés dans le sens horaire depuis le nord. Le résultat est ramené au cercle complet de 0 à 360 degrés et précise si la cible se trouve sur l’avant, sur l’arrière, à bâbord ou à tribord. Il convient aux exercices de navigation, aux rapports de veille, à l’interprétation radar et au contrôle des observations relatives au cap.

Ce qu’indique le gisement relatif

Le relèvement vrai et le gisement relatif décrivent la même ligne de visée depuis deux références différentes. Le relèvement vrai se mesure dans le sens horaire depuis le nord vrai, tandis que le gisement se mesure depuis l’étrave. Le calculateur change de référence en soustrayant le cap du navire au relèvement vrai de la cible. Un résultat de 0 degré place la cible droit devant, 90 degrés par le travers tribord, 180 degrés droit derrière et 270 degrés par le travers bâbord. Les valeurs intermédiaires précisent sa direction autour du navire. Cette distinction est essentielle, car la veille annonce généralement une position par rapport à l’étrave, alors qu’une carte ou un capteur peut employer le nord. Le champ target_side facilite le contrôle : entre 0 et 180, la cible est à tribord ; entre 180 et 360, elle est à bâbord.

Comment le calcul franchit le nord

La formule centrale est gisement relatif = relèvement vrai − cap du navire. Une soustraction directe peut être négative lorsque le relèvement de la cible est numériquement inférieur au cap. La direction reste pourtant valide : le résultat a simplement franchi la référence zéro du nord. Le calculateur ajoute 360 degrés puis applique un modulo 360 afin de produire une valeur conventionnelle comprise entre 0 inclus et 360 exclu. Ainsi, un cap de 350 degrés et un relèvement de 45 degrés donnent un gisement de 55 degrés, donc une cible sur l’avant tribord. Vous pouvez saisir 0 ou 360 degrés pour le nord ; les deux deviennent 0. Les degrés décimaux sont acceptés et la sortie est arrondie à six décimales pour rester stable. Les deux données doivent être des nombres finis dans la plage publiée de 0 à 360 degrés.

Bien interpréter le résultat

Vérifiez que les deux angles se réfèrent au nord vrai. Associer un cap magnétique à un relèvement vrai mélange deux référentiels et peut donner une valeur crédible mais erronée. Convertissez d’abord les valeurs magnétiques si la variation ou la déviation doit être appliquée. Le cap indique la direction de l’étrave ; il ne correspond pas nécessairement à la route sur le fond en présence de vent, de courant ou de dérive. La sortie suit la convention horaire de 0 à 360, et non un angle signé : 315 degrés signifie 45 degrés à bâbord. target_side lève cette ambiguïté et distingue les positions exactement devant et derrière. Le calcul est immédiat et déterministe, adapté aux exercices, aux contrôles de logiciels de passerelle, aux journaux et à l’automatisation par API pour $0.002 par requête. Il ne calcule ni distance, ni risque de collision, ni point de rapprochement maximal.

Cas d’usage

Convertir un relèvement reporté

Transformez le relèvement vrai issu d’une carte ou d’un capteur en angle horaire qu’une veille annoncerait depuis l’étrave.

Contrôler un exercice de navigation

Vérifiez le calcul du gisement relatif, y compris lorsque la soustraction franchit le nord et produirait une valeur négative.

Normaliser les observations de passerelle

Convertissez les relevés de cap et de relèvement vrai en gisements cohérents de 0 à 360 degrés pour les journaux ou l’analyse.

Questions fréquentes

Quelle formule est appliquée ?

Le calculateur soustrait le cap du navire au relèvement vrai, puis normalise la différence entre 0 inclus et 360 degrés exclu.

Que signifie un gisement relatif de 270 degrés ?

La cible se trouve directement par le travers bâbord, soit à 90 degrés sur bâbord depuis l’étrave.

Puis-je mélanger relèvements magnétiques et vrais ?

Non. Les deux angles doivent partager la même référence nord ; cette capacité attend précisément un relèvement et un cap vrais.

Ce calcul donne-t-il la distance ou le risque de collision ?

Non. Il fournit uniquement la direction par rapport à l’étrave, sans distance, vitesse, changement de route ni données de rapprochement.

Quel est le coût d’une requête API ?

Chaque requête API coûte $0.002. Le calcul peut aussi s’exécuter localement dans le navigateur en tant que capacité de niveau A.

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/relative-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/relative-bearing \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"true_bearing":45,"vessel_heading":350}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/relative-bearing",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "true_bearing": 45,
    "vessel_heading": 350
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"true_bearing":45,"vessel_heading":350}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/relative-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

{
  "true_bearing": 45,
  "vessel_heading": 350
}

Exemple de réponse

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

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 →