Calculadora de elevação solar
O ângulo de elevação solar, também chamado de altura do Sol, indica quanto o astro aparece acima ou abaixo do horizonte astronômico do observador.
Executar grátis
Esta calculadora aplica a equação padrão da astronomia esférica a três ângulos: latitude geográfica, declinação solar e ângulo horário. Informe cada valor em graus decimais para receber a elevação em graus e radianos, o ângulo zenital complementar e o termo seno usado no cálculo. Um resultado positivo coloca o Sol acima do horizonte ideal, zero marca o horizonte geométrico e um resultado negativo coloca seu centro abaixo dele. O cálculo é determinístico e não usa consulta de localização, serviço de data, modelo atmosférico nem rede.
Como funciona a fórmula da elevação solar
A elevação solar resulta do triângulo astronômico formado pelo polo celeste, pelo zênite e pelo Sol. A calculadora avalia a equação sin elevação = sin latitude × sin declinação + cos latitude × cos declinação × cos ângulo horário. A latitude posiciona o observador ao norte ou ao sul do equador. A declinação solar posiciona o Sol ao norte ou ao sul do equador celeste e varia sazonalmente entre limites próximos aos solstícios. O ângulo horário expressa a distância angular do Sol ao meridiano local: ele vale zero ao meio-dia solar local, é negativo antes desse instante e positivo depois. O arco seno da expressão completa fornece a elevação entre menos noventa e mais noventa graus. O resultado também é a altura geométrica do Sol, medida do horizonte astronômico ideal até o centro do disco solar. Seu complemento até noventa graus é o ângulo zenital solar. Pequenos desvios de ponto flutuante para fora do intervalo válido do arco seno podem ocorrer em geometrias-limite exatas. Por isso, a implementação restringe com segurança o seno calculado ao intervalo fechado de menos um a um antes de aplicar a função inversa. Essa proteção numérica não altera resultados comuns; ela impede que um caso matematicamente válido no polo ou no zênite se torne um valor de máquina inválido por causa de arredondamento.
Como escolher e interpretar as três entradas
Informe a latitude em graus decimais de menos noventa a mais noventa, com números positivos para locais ao norte do equador e negativos para locais ao sul. Informe a declinação solar com a mesma convenção de sinais. Declinação é uma coordenada astronômica, não o rumo do Sol nem a declinação magnética. Se você ainda não a tiver obtido de uma efeméride ou de um cálculo separado de posição solar baseado na data, será necessário determiná-la antes de usar esta calculadora. Por fim, informe o ângulo horário entre menos cento e oitenta e mais cento e oitenta graus. Zero representa a passagem pelo meridiano local, geralmente chamada de meio-dia solar local; valores negativos correspondem ao período da manhã e positivos ao período da tarde. Como o cosseno é simétrico, ângulos horários de mesma magnitude antes e depois do meio-dia produzem elevações geométricas iguais quando latitude e declinação permanecem fixas. O campo solar_elevation_angle_degrees é a resposta principal. sun_altitude_degrees repete esse valor com um termo comum da astronomia, enquanto solar_elevation_angle_radians atende programas e equações que trabalham em radianos. solar_zenith_angle_degrees é medido para baixo a partir do zênite, em vez de para cima a partir do horizonte. Esses valores descrevem uma geometria ideal e ainda não consideram refração atmosférica, relevo, edifícios ou o raio aparente do disco solar.
Precisão, escopo e uso prático
O cálculo é exato para as coordenadas esféricas fornecidas dentro da precisão normal de ponto flutuante, mas a utilidade da resposta depende da qualidade das entradas e da interpretação física desejada. A latitude deve representar o ponto de observação, e a declinação e o ângulo horário devem corresponder ao mesmo instante e à mesma convenção astronômica. Um ângulo horário impreciso desloca diretamente o Sol ao longo de seu arco diário, enquanto uma declinação aproximada introduz um erro sazonal de posição. A calculadora não deriva nenhuma dessas grandezas de data civil, horário do relógio, longitude, fuso horário ou correção da equação do tempo. Ela também retorna elevação geométrica, não aparente. Perto do horizonte, a refração atmosférica pode elevar o Sol observado por uma fração considerável de grau, e a correção real depende de pressão, temperatura e estrutura da atmosfera. Previsões de nascer e pôr do sol também podem definir o evento pelo limbo superior, e não pelo centro; portanto, um resultado de zero grau não corresponde automaticamente a um horário oficial. Em estudos de engenharia, a saída pode alimentar cálculos preliminares de incidência em painéis solares, sombreamento, iluminação natural ou diagramas didáticos, desde que as etapas seguintes apliquem as correções necessárias de azimute, refração, perfil do horizonte e orientação da superfície. Cada cálculo bem-sucedido pela API usa o preço-base publicado de US$ 0,002, enquanto o navegador pode executar o mesmo algoritmo puro sem acesso à rede.
Casos de uso
Verificação de geometria solar
Calcule a altura geométrica do Sol para latitude, declinação e ângulo horário conhecidos.
Modelos de energia renovável
Forneça uma elevação verificada a cálculos preliminares de incidência, sombreamento e iluminação natural.
Ensino de astronomia
Demonstre como latitude, declinação sazonal e distância do meio-dia solar moldam o percurso diário do Sol.
Perguntas frequentes
Elevação solar e altura do Sol são a mesma coisa?
Sim. Nesta calculadora, os dois nomes significam o ângulo com sinal entre o horizonte astronômico ideal e o centro do Sol.
Quais unidades devem ser usadas nas entradas?
Informe latitude, declinação solar e ângulo horário em graus decimais. O resultado inclui a elevação em graus e radianos.
Qual ângulo horário corresponde ao meio-dia solar local?
Use zero grau. Ângulos horários negativos representam instantes anteriores ao meio-dia solar local, e os positivos representam instantes posteriores.
Elevação de zero grau indica o nascer ou o pôr do sol observado?
Não necessariamente. A fórmula fornece a elevação geométrica do centro solar e não inclui refração atmosférica, raio do disco solar nem horizonte do terreno.
A calculadora deriva a declinação de uma data?
Não. Ela usa a declinação solar fornecida. Ao partir de uma data e localização, obtenha declinação e ângulo horário com uma efeméride ou um método coerente de posição solar.
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
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/trig/solar-elevation-angle \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":40,"solar_declination":20,"hour_angle":30}'const res = await fetch("https://api.kit.forhosting.com/trig/solar-elevation-angle", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"latitude": 40,
"solar_declination": 20,
"hour_angle": 30
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/trig/solar-elevation-angle",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"latitude": 40,
"solar_declination": 20,
"hour_angle": 30
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/trig/solar-elevation-angle", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"latitude":40,"solar_declination":20,"hour_angle":30}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"latitude":40,"solar_declination":20,"hour_angle":30}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/trig/solar-elevation-angle", 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
{
"latitude": 40,
"solar_declination": 20,
"hour_angle": 30
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "trig.solar_elevation_angle",
"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
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. |