ForHosting KIT · Outils pour développeurs

Angle horaire avec TSL et ascension droite

Ce calculateur détermine l’angle horaire local à partir du Temps Sidéral Local et de l’ascension droite d’un objet.

● BetaGratuit · dans votre navigateur

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Saisissez les deux coordonnées en heures décimales, de 0 inclus à 24 exclu. L’outil soustrait l’ascension droite du TSL, convertit l’écart à raison de 15 degrés par heure, puis ramène la réponse entre 0 inclus et 360 exclu. Le résultat indique la rotation de l’objet vers l’ouest par rapport au méridien local, selon une représentation positive sur un tour complet.

Ce qu’indique l’angle horaire local

L’angle horaire local décrit la position angulaire d’un astre par rapport au méridien céleste local. Un angle nul signifie que l’objet se trouve sur ce méridien. À mesure que le temps sidéral avance, l’angle augmente et exprime la rotation du ciel depuis le passage de l’objet au méridien. Le calcul suit la relation standard : l’angle horaire est égal au Temps Sidéral Local moins l’ascension droite. Les deux entrées étant données en heures décimales, leur différence est multipliée par 15 degrés par heure. La valeur obtenue est ramenée sur un tour positif, de 0 inclus à 360 exclu. Une réponse proche de 15 degrés place ainsi l’objet environ une heure sidérale à l’ouest du méridien, tandis que 345 degrés équivaut à moins 15 degrés et le situe environ une heure sidérale à l’est. Cette forme sans valeur négative convient aux logiciels, aux calculs de pointage, aux tracés et aux comparaisons de coordonnées angulaires.

Comment saisir le TSL et l’ascension droite

Indiquez le Temps Sidéral Local et l’ascension droite en heures décimales, et non en degrés ou sous forme de texte sexagésimal. Par exemple, 10 heures 30 minutes donnent 10.5 heures, et 8 heures 15 minutes donnent 8.25 heures. Chaque entrée doit être un nombre fini supérieur ou égal à zéro et strictement inférieur à 24. La borne 24 est exclue, car elle désigne la même position que zéro heure et créerait deux écritures pour une seule coordonnée. Les nombres négatifs, les valeurs égales ou supérieures à 24, les chaînes numériques, les champs absents, l’infini et les données non numériques sont refusés. Vérifiez que le TSL correspond à la longitude de l’observateur et à l’instant voulu : ce calculateur ne le déduit ni d’une date civile, ni d’une heure légale, ni d’un lieu. Utilisez également l’ascension droite dans le référentiel céleste adapté à votre traitement.

Comment lire le résultat normalisé

La réponse figure dans le champ hour_angle_degrees. La soustraction précède la normalisation, ce qui traite correctement le franchissement de zéro heure. Avec un TSL de 1 heure et une ascension droite de 23 heures, l’écart direct vaut moins 22 heures, soit moins 330 degrés ; sa normalisation donne 30 degrés, l’angle positif équivalent. Cette convention évite les sorties négatives et facilite l’intégration dans les systèmes représentant les rotations sur un cercle de 0 à 360 degrés. Si votre application exige un angle horaire signé, retranchez 360 degrés aux valeurs supérieures à 180 degrés : 345 degrés devient alors moins 15 degrés. Aucun arrondi particulier ne s’ajoute à l’arithmétique numérique ordinaire, afin de préserver la précision utile des entrées fractionnaires. Le calcul n’intègre ni réfraction atmosphérique, ni précession, ni nutation, ni mouvement polaire, ni parallaxe topocentrique.

Cas d’usage

Préparer le pointage d’un télescope

Transformez l’ascension droite de l’objet et le TSL connu en angle horaire local normalisé pour l’étape suivante du calcul.

Contrôler la position méridienne

Déterminez si une cible est sur le méridien céleste local, à l’est ou à l’ouest, grâce à deux coordonnées sidérales préparées.

Tester un logiciel d’astronomie

Employez des cas déterministes franchissant zéro pour vérifier les traitements qui convertissent des heures en degrés angulaires.

Questions fréquentes

Quelle formule le calculateur applique-t-il ?

Il soustrait l’ascension droite du Temps Sidéral Local, multiplie l’écart par 15 degrés par heure et ramène le résultat entre 0 inclus et 360 exclu.

Faut-il saisir des heures, des degrés ou un texte sexagésimal ?

Saisissez les deux valeurs en heures décimales. Divisez les minutes par 60 et les secondes par 3600 avant le calcul.

Pourquoi 24 heures sont-elles refusées ?

Vingt-quatre heures désignent la même coordonnée circulaire que zéro heure. Une valeur inférieure à 24 garantit une représentation unique et claire.

Pourquoi la réponse est-elle un grand angle positif plutôt qu’un angle négatif ?

La sortie suit la convention positive sur un tour complet. Pour obtenir l’angle signé équivalent, retranchez 360 degrés si la valeur dépasse 180 degrés.

L’outil calcule-t-il le TSL avec ma date et ma longitude ?

Non. Le Temps Sidéral Local doit être connu au préalable ; cette capacité calcule uniquement son écart angulaire avec l’ascension droite.

Quel est le prix d’un calcul par API ?

Chaque requête API coûte $0.002. Le même calcul déterministe peut aussi être exécuté gratuitement dans le navigateur.

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/astro/hour-angle-from-lst

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/astro/hour-angle-from-lst \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"local_sidereal_time_hours":10.5,"right_ascension_hours":8.25}'

const res = await fetch("https://api.kit.forhosting.com/astro/hour-angle-from-lst", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "local_sidereal_time_hours": 10.5,
    "right_ascension_hours": 8.25
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/astro/hour-angle-from-lst",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "local_sidereal_time_hours": 10.5,
    "right_ascension_hours": 8.25
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/astro/hour-angle-from-lst", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"local_sidereal_time_hours":10.5,"right_ascension_hours":8.25}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"local_sidereal_time_hours":10.5,"right_ascension_hours":8.25}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/astro/hour-angle-from-lst", 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

{
  "local_sidereal_time_hours": 10.5,
  "right_ascension_hours": 8.25
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "astro.hour_angle_from_lst",
  "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 →