ForHosting KIT · Strumenti per sviluppatori

Angolo orario da TSL e ascensione retta

Questo calcolatore ricava l’angolo orario locale dal Tempo Siderale Locale e dall’ascensione retta di un oggetto.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Inserisca entrambe le coordinate in ore decimali, da 0 incluso a 24 escluso. Lo strumento sottrae l’ascensione retta dal TSL, converte la differenza usando 15 gradi per ora e normalizza la risposta tra 0 incluso e 360 escluso. Il risultato indica quanto l’oggetto ha ruotato verso ovest rispetto al meridiano locale, mediante una rappresentazione positiva dell’intero giro.

Che cosa indica l’angolo orario locale

L’angolo orario locale descrive la posizione angolare di un astro rispetto al meridiano celeste locale. Un oggetto con angolo pari a zero gradi si trova su quel meridiano. Con l’avanzare del tempo siderale, l’angolo cresce e indica quanto il cielo ha ruotato dal transito dell’oggetto sul meridiano. Il calcolo applica la relazione standard: l’angolo orario è uguale al Tempo Siderale Locale meno l’ascensione retta. Poiché entrambi i dati sono espressi in ore decimali, la differenza viene moltiplicata per 15 gradi per ora. Il valore è poi normalizzato su un giro positivo da 0 incluso a 360 escluso. Un risultato vicino a 15 gradi colloca l’oggetto circa un’ora siderale a ovest del meridiano; 345 gradi equivale invece a meno 15 gradi e lo pone circa un’ora siderale a est. Questa forma non negativa è comoda per software, calcoli di puntamento, grafici e confronti fra coordinate angolari.

Come inserire TSL e ascensione retta

Indichi il Tempo Siderale Locale e l’ascensione retta come ore decimali, non come gradi né come testo sessagesimale. Per esempio, 10 ore e 30 minuti diventano 10.5 ore, mentre 8 ore e 15 minuti diventano 8.25 ore. Ogni dato deve essere un numero finito maggiore o uguale a zero e strettamente minore di 24. Il limite 24 è escluso perché identifica la stessa posizione di zero ore e produrrebbe due rappresentazioni della medesima coordinata. Sono rifiutati valori negativi, numeri pari o superiori a 24, stringhe numeriche, campi mancanti, infinito e dati non numerici. Verifichi che il TSL riguardi la longitudine dell’osservatore e l’istante di osservazione desiderato: questo strumento non lo ricava da data civile, ora dell’orologio o posizione geografica. Anche l’ascensione retta deve appartenere al contesto di riferimento celeste richiesto dalla Sua procedura.

Come leggere il risultato normalizzato

La risposta è restituita nel campo hour_angle_degrees. La sottrazione avviene prima della normalizzazione, quindi il passaggio attraverso zero ore viene gestito correttamente. Se il TSL è 1 ora e l’ascensione retta è 23 ore, la differenza diretta è meno 22 ore, cioè meno 330 gradi; la normalizzazione produce 30 gradi, l’angolo positivo equivalente. Questa convenzione evita risultati negativi ed è adatta ai sistemi che rappresentano le rotazioni su un cerchio da 0 a 360 gradi. Se la Sua applicazione richiede un angolo orario con segno, sottragga 360 gradi ai valori superiori a 180 gradi: 345 gradi corrisponderà così a meno 15 gradi. Non viene imposto alcun arrotondamento oltre alla normale aritmetica numerica, per conservare la precisione utile dei dati frazionari. Il calcolo non comprende rifrazione, precessione, nutazione, moto polare o parallasse topocentrica.

Casi d'uso

Preparare il puntamento di un telescopio

Converta l’ascensione retta dell’oggetto e il TSL noto in un angolo orario locale normalizzato per la fase successiva.

Controllare la posizione meridiana

Stabilisca se un bersaglio è sul meridiano celeste locale, a est oppure a ovest, usando due coordinate siderali già preparate.

Verificare software astronomico

Usi casi deterministici con passaggio sullo zero per collaudare procedure che trasformano valori orari in gradi angolari.

Domande frequenti

Quale formula usa il calcolatore?

Sottrae l’ascensione retta dal Tempo Siderale Locale, moltiplica la differenza per 15 gradi per ora e normalizza il valore tra 0 incluso e 360 escluso.

Devo inserire ore, gradi o un testo con ore, minuti e secondi?

Inserisca entrambi i valori in ore decimali. Divida i minuti per 60 e i secondi per 3600 prima di eseguire il calcolo.

Perché 24 ore non sono accettate?

Ventiquattro ore rappresentano la stessa coordinata circolare di zero ore. Il limite inferiore a 24 garantisce una sola rappresentazione non ambigua.

Perché ottengo un grande angolo positivo invece di uno negativo?

L’uscita usa la convenzione normalizzata sull’intero giro. Per il valore con segno equivalente, sottragga 360 gradi quando il risultato supera 180 gradi.

Lo strumento calcola il TSL dalla mia data e longitudine?

No. Il Tempo Siderale Locale deve essere già noto; questa capacità calcola soltanto la differenza angolare rispetto all’ascensione retta.

Quanto costa un calcolo tramite API?

Ogni richiesta API costa $0.002. Lo stesso calcolo deterministico può essere eseguito gratuitamente anche nel browser.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/astro/hour-angle-from-lst

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo 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)

Esempio di richiesta

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

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "astro.hour_angle_from_lst",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →