ForHosting KIT · Outils pour développeurs

Normaliser un cap entre 0 et 360 degrés

Convertissez un cap négatif, un angle supérieur à une révolution ou un azimut déjà conventionnel en une valeur cohérente comprise entre zéro et moins de 360 degrés.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Le calculateur retire ou ajoute des tours complets de 360 degrés sans modifier la direction représentée. Il convient aux données de navigation, de topographie, de cartographie, de robotique ou de tableur qui emploient des conventions différentes. Saisissez une valeur finie en degrés pour obtenir le nombre d’origine et son équivalent normalisé, sans aucune consultation externe.

Comprendre l’intervalle normalisé

Un cap décrit une direction autour d’un cercle complet. Des angles séparés par un multiple entier de 360 degrés indiquent donc exactement la même direction. Ainsi, 10 degrés, 370 degrés et -350 degrés sont équivalents. La normalisation retient un représentant standard de cette famille illimitée. Ce calculateur emploie l’intervalle semi-ouvert allant de 0 degré inclus à 360 degrés exclus. Le nord vaut donc 0 degré, jamais 360, tandis que l’est, le sud et l’ouest valent 90, 180 et 270 degrés. Cette convention évite deux représentations au point de raccordement. La normalisation ne fait pivoter, n’arrondit et ne réinterprète pas la direction. Elle ajoute ou soustrait uniquement des tours complets jusqu’à placer la valeur dans l’intervalle. Les décimales sont conservées : 721.25 degrés devient ainsi 1.25 degré.

Saisir l’angle et contrôler le résultat

Indiquez un seul cap numérique fini, exprimé en degrés. Il peut déjà appartenir à l’intervalle, être négatif ou comporter plusieurs révolutions positives ou négatives. Une valeur comprise entre 0 et 360 reste inchangée, hormis le zéro négatif qui devient un zéro ordinaire. Pour 725.5 degrés, deux tours sont retirés et le résultat vaut 5.5 degrés. Pour -10 degrés, l’ajout d’un tour donne 350 degrés. Le calcul utilise directement le reste équivalent : sa durée ne dépend pas du nombre de tours. Vérifiez que la source est bien exprimée en degrés et suit la convention de cap attendue. Une valeur en radians ne sera pas convertie, et l’outil ne peut pas détecter une mesure antihoraire. Les valeurs absentes, non numériques, infinies ou NaN sont refusées afin d’éviter un résultat trompeur.

Employer les caps normalisés sans erreur

Une valeur normalisée simplifie les comparaisons, le stockage, le tri, l’affichage et les formules, mais elle ne modifie que le bouclage numérique. Elle ne transforme pas le nord magnétique en nord vrai, n’applique ni déclinaison ni convergence de grille et ne calcule aucun itinéraire. Conservez ces informations séparément. Les comparaisons circulaires demandent aussi de la prudence près de la limite : 359 degrés et 1 degré ne sont distants que de 2 degrés, même si une soustraction ordinaire donne 358. Normalisez les deux valeurs, puis appliquez une formule de différence circulaire. Pour assurer la traçabilité d’un nettoyage automatisé, gardez la valeur originale avec la valeur normalisée. Chaque requête API traite un élément et coûte $0.002. Le calcul n’utilise ni réseau, ni date, ni hasard, ni table évolutive. Si un arrondi d’affichage est requis, appliquez-le ensuite selon la précision des données.

Nettoyer des données de navigation

Uniformisez les caps négatifs ou multitours avant de stocker ou comparer des relevés de véhicules, navires ou aéronefs.

Régulariser l’orientation d’un robot

Transformez des rotations cumulées en orientation canonique pour les tableaux de bord et systèmes de commande.

Préparer des champs cartographiques

Normalisez les colonnes d’azimut importées avant leur emploi dans un SIG, une validation ou un calcul directionnel.

Quel intervalle le résultat utilise-t-il ?

Le résultat est supérieur ou égal à 0 degré et strictement inférieur à 360 degrés. Un tour complet est représenté par 0 degré.

Comment les caps négatifs sont-ils traités ?

Des tours complets de 360 degrés sont ajoutés si nécessaire. Par exemple, -10 degrés devient 350 degrés.

Que deviennent les valeurs supérieures à 360 degrés ?

Les tours complets sont retirés sans modifier la direction. Par exemple, 725.5 degrés devient 5.5 degrés.

Cet outil convertit-il les radians en degrés ?

Non. L’entrée est interprétée en degrés ; convertissez les radians séparément avant d’utiliser cette capacité.

La normalisation corrige-t-elle la déclinaison magnétique ?

Non. Elle boucle uniquement l’angle numérique ; les corrections de nord magnétique, vrai ou de grille restent distinctes.

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.

POSThttps://api.kit.forhosting.com/geo/normalize-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é.

curl -X POST https://api.kit.forhosting.com/geo/normalize-bearing \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bearing":725.5}'
{
  "bearing": 725.5
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.normalize_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.

par requête$0.002

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

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →