ForHosting KIT · Ferramentas para dev

Ascensão reta a partir de coordenadas eclípticas

Esta calculadora converte a longitude e a latitude eclípticas de um objeto em ascensão reta equatorial.

● BetaGrátis · no seu navegador

Use pelo WebAPIE-mailTelegramApp em breve

Ela aplica a obliquidade informada como uma rotação tridimensional, preserva o quadrante correto e retorna o resultado em horas decimais de 0 até menos de 24. O cálculo é determinístico e aceita longitudes fora de uma volta, pois as normaliza antes da rotação. A latitude e a obliquidade também são validadas, para que uma geometria angular inválida gere um erro claro em vez de uma coordenada aparentemente correta, porém enganosa.

Informe coordenadas do mesmo referencial e época

Informe longitude eclíptica, latitude eclíptica e obliquidade em graus decimais. Os três valores precisam descrever o mesmo referencial e a mesma época. Isso é importante porque a obliquidade muda lentamente com o tempo, enquanto coordenadas de catálogo podem estar vinculadas a uma época padrão, como J2000.0, ou calculadas para a data da observação. Misturar coordenadas de uma época com a obliquidade de outra cria um desvio sistemático, mesmo quando a conta termina normalmente. A longitude pode estar no intervalo habitual de 0 a 360 graus ou ser um valor equivalente fora dele; voltas completas são normalizadas automaticamente. A latitude deve ficar entre -90 e 90 graus, e a obliquidade entre 0 e 90 graus. Use casas decimais suficientes, mas lembre que dígitos extras não compensam coordenadas incertas, época aproximada, efeitos atmosféricos ou referenciais incompatíveis.

Como a rotação gera a ascensão reta

Primeiro, a conversão representa a posição eclíptica como um vetor cartesiano unitário. Em seguida, gira esse vetor ao redor do eixo x comum conforme a obliquidade fornecida, mudando a orientação do plano eclíptico para o plano equatorial. A ascensão reta é o ângulo da projeção do vetor girado no plano equatorial x-y. A calculadora avalia esse ângulo com uma arcotangente de dois argumentos, que mantém os sinais dos dois componentes e seleciona o quadrante correto. Uma arcotangente simples pode confundir posições separadas por doze horas. O ângulo é normalizado para uma volta positiva e dividido por quinze, pois 360 graus correspondem a 24 horas. Assim, o resultado é sempre maior ou igual a zero e menor que 24. Se a posição girada cair exatamente em um polo celeste, sua projeção não tem direção e a ascensão reta é indefinida; a ferramenta retorna um erro.

Interprete e confira o resultado em horas decimais

A saída é a ascensão reta em horas decimais, adequada para rotinas numéricas, comparação de catálogos, exibição de coordenadas e cálculos astronômicos posteriores. Para expressá-la em horas, minutos e segundos, use a parte inteira como horas, multiplique a fração restante por 60 para obter minutos e multiplique a fração de minuto por 60 para obter segundos. Perto do limite, um resultado próximo de 24 horas está ao lado de 0 horas no céu. Para conferir, uma posição com longitude e latitude iguais a zero deve resultar em zero horas para qualquer obliquidade válida. Com obliquidade zero, os planos coincidem e a ascensão reta acompanha a longitude normalizada dividida por quinze, exceto nos polos. A calculadora fornece somente a coordenada geométrica; não aplica precessão, nutação, aberração, paralaxe, refração nem correções de tempo de observação.

Casos de uso

Converter uma posição de catálogo

Transforme longitude e latitude de catálogo em ascensão reta decimal usando a obliquidade da época correspondente.

Conferir um cálculo astronômico

Compare o resultado equatorial do seu processo com uma rotação determinística independente que preserva o quadrante.

Preparar coordenadas para um mapa celeste

Gere uma ascensão reta normalizada para programas que identificam ou ordenam objetos por horas decimais.

Perguntas frequentes

Quanto custa o cálculo pela API?

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

Quais unidades você deve usar?

Informe longitude eclíptica, latitude eclíptica e obliquidade em graus decimais. O resultado é fornecido em horas decimais.

Por que o resultado é dividido por 15?

A ascensão reta usa horas por convenção; uma volta de 360 graus equivale a 24 horas, portanto cada hora corresponde a 15 graus.

Por que a obliquidade deve ficar entre 0 e 90 graus?

Esse valor representa o ângulo entre os planos eclíptico e equatorial. O modelo não aceita valores fora desse intervalo.

É possível usar longitude eclíptica negativa?

Sim. A longitude é normalizada módulo 360 graus, então valores negativos ou maiores que 360 apontam para a direção equivalente.

O cálculo inclui precessão ou nutação?

Não. Ele realiza apenas a rotação geométrica das coordenadas com a obliquidade fornecida. Aplique separadamente correções de época e posição aparente.

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/ra-from-ecliptic

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/ra-from-ecliptic \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ecliptic_longitude_deg":139.686111,"ecliptic_latitude_deg":4.875278,"obliquity_deg":23.4392911}'

const res = await fetch("https://api.kit.forhosting.com/astro/ra-from-ecliptic", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "ecliptic_longitude_deg": 139.686111,
    "ecliptic_latitude_deg": 4.875278,
    "obliquity_deg": 23.4392911
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/astro/ra-from-ecliptic",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "ecliptic_longitude_deg": 139.686111,
    "ecliptic_latitude_deg": 4.875278,
    "obliquity_deg": 23.4392911
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/astro/ra-from-ecliptic", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"ecliptic_longitude_deg":139.686111,"ecliptic_latitude_deg":4.875278,"obliquity_deg":23.4392911}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"ecliptic_longitude_deg":139.686111,"ecliptic_latitude_deg":4.875278,"obliquity_deg":23.4392911}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/astro/ra-from-ecliptic", 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

{
  "ecliptic_longitude_deg": 139.686111,
  "ecliptic_latitude_deg": 4.875278,
  "obliquity_deg": 23.4392911
}

Exemplo de resposta

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