Calculadora de azimute solar por latitude e ângulo horário
A calculadora de ângulo de azimute solar determina a direção do Sol usando a latitude do observador, a declinação solar e o ângulo horário solar local.
Executar grátis
O resultado traz um ângulo medido no sentido horário a partir do norte verdadeiro e uma direção familiar da rosa de dezesseis rumos. Informe os três ângulos em graus decimais, com valores negativos antes do meio-dia solar local e positivos depois dele. O cálculo é determinístico, funciona sem rede e atende estudos de iluminação natural, energia fotovoltaica, sombras e astronomia educacional.
Informe corretamente os três ângulos solares
Comece pela latitude geográfica do observador em graus decimais. Latitudes ao norte são positivas, latitudes ao sul são negativas, e o intervalo permitido vai de menos noventa a mais noventa graus. A declinação solar descreve a posição angular do Sol ao norte ou ao sul do equador celeste; ela é positiva quando o Sol está ao norte. O ângulo horário representa o tempo em relação ao meio-dia solar local, e não ao meio-dia do relógio civil. Use zero no meio-dia solar, valores negativos durante a manhã solar e positivos durante a tarde solar. Quinze graus correspondem aproximadamente a uma hora solar. Todos os valores devem estar em graus, nunca em radianos. Longitude e fuso horário não são solicitados porque a ferramenta pressupõe que a declinação e o ângulo horário local já foram obtidos. Se você parte de data, hora civil e longitude, calcule primeiro essas grandezas astronômicas e depois execute esta etapa de trigonometria esférica.
Entenda o ângulo e a direção apresentados
O resultado segue a convenção de navegação: zero grau é o norte verdadeiro, noventa graus é leste, cento e oitenta é sul e duzentos e setenta é oeste. Os valores crescem no sentido horário e permanecem abaixo de trezentos e sessenta graus. Além do número, a calculadora escolhe a mais próxima entre dezesseis direções, como NNE, SE ou WNW. Cada setor cobre vinte e dois graus e meio; portanto, a sigla é um resumo legível, não substitui o valor preciso. O cálculo forma as componentes leste e norte do vetor solar local e usa uma arcotangente que preserva o quadrante. Isso elimina a ambiguidade entre norte e sul que surge com um arco cosseno isolado. A direção toma como referência o norte verdadeiro, não o magnético. Uma bússola pode divergir sem a correção da declinação magnética local. O resultado matemático também descreve a direção quando o Sol modelado está abaixo do horizonte.
Considere os limites e as posições singulares
O azimute solar faz sentido quando a direção do Sol possui uma componente horizontal. Se a geometria fornecida colocar o Sol exatamente no zênite, todas as direções horizontais se afastam do mesmo ponto e nenhum azimute único existe. A mesma ambiguidade matemática ocorre no nadir, diretamente abaixo do observador. A calculadora rejeita esses casos singulares em vez de devolver uma direção arbitrária. Perto deles, uma pequena alteração na entrada pode provocar grande mudança no azimute; essa sensibilidade pertence à geometria e não é aleatoriedade numérica. O cálculo também não corrige refração atmosférica, relevo, edifícios, declinação magnética nem o raio aparente do disco solar. Esses efeitos importam em limites de nascer do sol, pôr do sol e sombreamento. Em trabalhos técnicos, guarde o valor numérico e registre a origem da declinação e do ângulo horário. A mesma entrada sempre gera o mesmo resultado, o que favorece testes, planilhas, scripts e fluxos reproduzíveis pela API por US$ 0,002 por solicitação.
Casos de uso
Oriente um sistema fotovoltaico
Encontre a direção do Sol em relação ao norte verdadeiro para um instante conhecido antes de compará-la com um painel ou rastreador.
Planeje sombras e iluminação natural
Use o azimute em estudos de terreno, fachada ou proteção solar quando a declinação e o ângulo horário já forem conhecidos.
Confira cálculos de astronomia
Valide uma atividade de trigonometria esférica ou um teste de software com uma direção determinística e um setor de bússola legível.
Perguntas frequentes
Qual direção corresponde a zero grau de azimute?
Zero grau é o norte verdadeiro. O ângulo cresce no sentido horário, com leste em noventa graus, sul em cento e oitenta e oeste em duzentos e setenta.
O ângulo horário da manhã deve ser positivo ou negativo?
Use valores negativos antes do meio-dia solar local, zero nesse meio-dia e valores positivos depois dele.
A direção usa o norte magnético?
Não. O ângulo e o rumo têm como referência o norte verdadeiro. Aplique separadamente a declinação magnética do local ao comparar o resultado com uma bússola.
É possível obter uma direção com o Sol abaixo do horizonte?
Sim. A geometria esférica ainda define a direção do Sol, embora ele não esteja visível. A calculadora não verifica relevo nem horizonte aparente.
Por que o azimute solar pode ser indefinido?
No zênite ou nadir exatos, a direção solar não tem componente horizontal e não existe um rumo único. A calculadora trata essa geometria singular como entrada inválida.
Quanto custa o cálculo pela API?
Cada solicitação à API custa US$ 0,002. O mesmo cálculo determinístico pode ser executado no navegador sem acesso à rede.
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/azimuth-of-sun \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"lat":40.7128,"declination":23.44,"hour_angle":-30}'const res = await fetch("https://api.kit.forhosting.com/trig/azimuth-of-sun", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"lat": 40.7128,
"declination": 23.44,
"hour_angle": -30
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/trig/azimuth-of-sun",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"lat": 40.7128,
"declination": 23.44,
"hour_angle": -30
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/trig/azimuth-of-sun", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"lat":40.7128,"declination":23.44,"hour_angle":-30}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"lat":40.7128,"declination":23.44,"hour_angle":-30}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/trig/azimuth-of-sun", 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
{
"lat": 40.7128,
"declination": 23.44,
"hour_angle": -30
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "trig.azimuth_of_sun",
"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. |