ForHosting KIT · Ferramentas para dev

Ângulo horário pelo TSL e ascensão reta

Esta calculadora determina o ângulo horário local a partir do Tempo Sideral Local e da ascensão reta de um objeto.

● BetaGrátis · no seu navegador

Use pelo WebAPIE-mailTelegramApp em breve

Informe ambas as coordenadas em horas decimais, de 0 incluído até 24 sem incluir. O cálculo subtrai a ascensão reta do TSL, converte a diferença usando 15 graus por hora e normaliza a resposta entre 0 incluído e 360 sem incluir. O resultado indica quanto o objeto girou para oeste em relação ao meridiano local, usando uma representação positiva de volta completa.

O que o ângulo horário local informa

O ângulo horário local descreve a posição angular de um astro em relação ao meridiano celeste local. Um objeto com ângulo de zero grau está sobre esse meridiano. Conforme o tempo sideral avança, o ângulo aumenta e indica quanto o céu girou desde a passagem do objeto pelo meridiano. Esta calculadora aplica a relação padrão: ângulo horário é igual ao Tempo Sideral Local menos a ascensão reta. Como as duas entradas estão em horas decimais, a diferença é multiplicada por 15 graus por hora. A resposta é normalizada em uma volta positiva, de 0 inclusive a 360 exclusive. Por exemplo, um valor próximo de 15 graus coloca o objeto cerca de uma hora sideral a oeste do meridiano; 345 graus equivale a menos 15 graus e o situa aproximadamente uma hora sideral a leste. A forma normalizada é adequada para programas, apontamento de telescópios, gráficos e comparações que exigem coordenadas angulares não negativas.

Como informar TSL e ascensão reta

Forneça o Tempo Sideral Local e a ascensão reta em horas decimais, não em graus nem como texto sexagesimal. Um valor de 10 horas e 30 minutos vira 10.5 horas; 8 horas e 15 minutos vira 8.25 horas. Cada entrada precisa ser um número finito maior ou igual a zero e estritamente menor que 24. O limite 24 é excluído porque representa a mesma posição de zero hora e criaria duas formas para uma coordenada. Valores negativos, números iguais ou superiores a 24, textos numéricos, campos ausentes, infinito e dados não numéricos são recusados. Verifique se o TSL corresponde à longitude do observador e ao instante de observação pretendido, pois a calculadora não deriva o TSL de data civil, horário do relógio ou localização. Da mesma forma, use uma ascensão reta no contexto de referência celeste exigido pelo seu procedimento. A ferramenta se limita à relação angular entre duas grandezas já preparadas.

Como interpretar o resultado normalizado

A resposta fica no campo hour_angle_degrees. A subtração ocorre antes da normalização, portanto a passagem por zero hora é tratada corretamente. Se o TSL for 1 hora e a ascensão reta for 23 horas, a diferença direta será menos 22 horas, ou menos 330 graus; a normalização produzirá 30 graus, o ângulo positivo equivalente. Essa convenção evita resultados negativos e atende sistemas que representam rotações em um círculo de 0 a 360 graus. Se o seu aplicativo astronômico exigir um ângulo horário com sinal, subtraia 360 graus dos valores maiores que 180 graus. Assim, 345 graus corresponde a menos 15 graus. Não há arredondamento adicional além da aritmética numérica comum, e entradas fracionárias mantêm precisão útil. O cálculo não corrige refração atmosférica, precessão, nutação, movimento polar nem paralaxe topocêntrica; esses fatores dizem respeito à preparação das coordenadas de entrada.

Casos de uso

Preparar o apontamento de um telescópio

Converta a ascensão reta do objeto e o TSL conhecido em um ângulo horário local normalizado para a próxima etapa do cálculo.

Verificar a posição no meridiano

Determine se um alvo está sobre o meridiano celeste local, a leste ou a oeste, usando duas coordenadas siderais preparadas.

Validar software de astronomia

Use casos determinísticos com mudança de volta para testar fluxos que transformam valores horários em graus angulares.

Perguntas frequentes

Qual fórmula a calculadora usa?

Ela subtrai a ascensão reta do Tempo Sideral Local, multiplica a diferença por 15 graus por hora e normaliza o resultado de 0 incluído a 360 sem incluir.

Devo informar horas, graus ou texto com horas, minutos e segundos?

Informe os dois valores em horas decimais. Divida os minutos por 60 e os segundos por 3600 antes de usar a calculadora.

Por que 24 horas são recusadas?

Vinte e quatro horas representam a mesma coordenada circular que zero hora. Exigir valores abaixo de 24 mantém uma única representação sem ambiguidade.

Por que recebo um ângulo positivo grande em vez de um negativo?

A saída usa uma volta completa normalizada. Para obter o ângulo com sinal equivalente, subtraia 360 graus quando o valor retornado for maior que 180 graus.

A ferramenta calcula o TSL usando minha data e longitude?

Não. O Tempo Sideral Local já deve ser conhecido; esta capacidade calcula apenas sua diferença angular em relação à ascensão reta.

Quanto custa um cálculo pela API?

Cada solicitação de API custa US$ 0,002. O mesmo cálculo determinístico também pode ser executado grátis no navegador.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

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

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

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)

Exemplo de requisição

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

Exemplo de resposta

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

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →