Calculadora de elevación solar
El ángulo de elevación solar, también llamado altura del Sol, indica a qué altura aparece el astro por encima o por debajo del horizonte astronómico del observador.
Ejecutar — gratis
Esta calculadora aplica la ecuación estándar de astronomía esférica a tres ángulos: latitud geográfica, declinación solar y ángulo horario. Introduzca cada valor en grados decimales para obtener la elevación en grados y radianes, el ángulo cenital complementario y el término seno utilizado en el cálculo. Un resultado positivo sitúa el Sol sobre el horizonte ideal; cero marca el horizonte geométrico; y un valor negativo coloca su centro por debajo. El cálculo es determinista y no consulta ubicaciones, fechas, modelos atmosféricos ni servicios de red.
Cómo funciona la fórmula de elevación solar
La elevación solar se obtiene del triángulo astronómico formado por el polo celeste, el cenit y el Sol. La calculadora evalúa la ecuación sin elevación = sin latitud × sin declinación + cos latitud × cos declinación × cos ángulo horario. La latitud ubica al observador al norte o al sur del ecuador. La declinación solar sitúa el Sol al norte o al sur del ecuador celeste y varía con las estaciones entre límites próximos a los solsticios. El ángulo horario expresa la distancia angular del Sol respecto del meridiano local: vale cero al mediodía solar local, es negativo antes de ese instante y positivo después. El arcoseno de la expresión completa produce una elevación entre menos noventa y más noventa grados. El resultado es también la altura geométrica del Sol, medida desde el horizonte astronómico ideal hasta el centro del disco solar. Su complemento hasta noventa grados es el ángulo cenital solar. En geometrías límite exactas pueden aparecer pequeñas desviaciones de coma flotante fuera del intervalo válido del arcoseno. Por ello, la implementación limita de forma segura el seno calculado al intervalo cerrado de menos uno a uno antes de aplicar la función inversa. Esta protección numérica no modifica los resultados ordinarios; evita que un caso matemáticamente válido en un polo o en el cenit se convierta en un valor de máquina inválido por un error de redondeo.
Cómo elegir e interpretar las tres entradas
Introduzca la latitud en grados decimales entre menos noventa y más noventa; utilice valores positivos para lugares al norte del ecuador y negativos para lugares al sur. Indique la declinación solar con la misma convención de signo. La declinación es una coordenada astronómica, no el rumbo del Sol ni la declinación magnética. Si todavía no dispone de ella mediante una efeméride o un cálculo independiente de posición solar basado en la fecha, deberá obtenerla antes de usar esta calculadora. Por último, introduzca el ángulo horario entre menos ciento ochenta y más ciento ochenta grados. Cero representa el tránsito por el meridiano local, denominado habitualmente mediodía solar local; los valores negativos corresponden al lado de la mañana y los positivos al de la tarde. Como el coseno es simétrico, los ángulos horarios matutino y vespertino de igual magnitud generan la misma elevación geométrica si la latitud y la declinación permanecen constantes. El campo solar_elevation_angle_degrees contiene la respuesta principal. sun_altitude_degrees repite ese valor con un término astronómico habitual, mientras que solar_elevation_angle_radians facilita el uso en programas y ecuaciones que operan con radianes. solar_zenith_angle_degrees se mide hacia abajo desde el cenit, no hacia arriba desde el horizonte. Estas magnitudes describen una geometría ideal y todavía no incluyen refracción atmosférica, terreno, edificios ni el radio aparente del disco solar.
Precisión, alcance y uso práctico
El cálculo es exacto para las coordenadas esféricas proporcionadas dentro de la precisión normal de coma flotante, pero la utilidad de la respuesta depende de la calidad de los datos y de la interpretación física necesaria. La latitud debe corresponder al punto de observación, y la declinación y el ángulo horario deben referirse al mismo instante y a una convención astronómica coherente. Un ángulo horario inexacto desplaza directamente el Sol a lo largo de su arco diario, mientras que una declinación aproximada introduce un error estacional de posición. La calculadora no deduce ninguna de estas cantidades a partir de una fecha civil, hora del reloj, longitud, zona horaria o corrección de la ecuación del tiempo. También devuelve elevación geométrica, no aparente. Cerca del horizonte, la refracción atmosférica puede elevar la posición observada del Sol una fracción considerable de grado; la corrección real depende de la presión, la temperatura y la estructura atmosférica. Las predicciones de salida y puesta también pueden definir el fenómeno mediante el limbo superior en lugar del centro, de modo que un resultado de cero grados no equivale automáticamente a una hora oficial de orto u ocaso. En estudios de ingeniería, el resultado puede alimentar cálculos preliminares de incidencia en paneles solares, sombreado, luz diurna o diagramas educativos, siempre que el proceso posterior aplique las correcciones necesarias de acimut, refracción, perfil del horizonte y orientación de superficies. Cada cálculo correcto por API utiliza el precio base publicado de $0.002; el navegador puede ejecutar el mismo algoritmo puro sin acceso a la red.
Qué puede hacer con ella
Comprobaciones de geometría solar
Calcule la altura geométrica del Sol con una latitud, declinación y ángulo horario conocidos.
Modelos de energía renovable
Obtenga una elevación verificada para cálculos preliminares de incidencia, sombreado e iluminación natural.
Enseñanza de astronomía
Muestre cómo la latitud, la declinación estacional y la distancia al mediodía solar determinan la trayectoria diaria del Sol.
Preguntas frecuentes
¿La elevación solar es lo mismo que la altura del Sol?
Sí. En esta calculadora, ambos nombres designan el ángulo con signo entre el horizonte astronómico ideal y el centro del Sol.
¿Qué unidades deben usarse en las entradas?
Introduzca la latitud, la declinación solar y el ángulo horario en grados decimales. El resultado ofrece la elevación en grados y radianes.
¿Qué ángulo horario corresponde al mediodía solar local?
Utilice cero grados. Los ángulos horarios negativos representan instantes anteriores al mediodía solar local y los positivos, instantes posteriores.
¿Una elevación de cero grados indica el orto o el ocaso observado?
No necesariamente. La fórmula proporciona la elevación geométrica del centro solar y no incluye refracción atmosférica, radio del disco solar ni horizonte del terreno.
¿La calculadora obtiene la declinación a partir de una fecha?
No. Utiliza la declinación solar suministrada. Si parte de una fecha y una ubicación, obtenga la declinación y el ángulo horario mediante una efeméride o un método coherente de posición solar.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
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)Ejemplo de solicitud
{
"latitude": 40,
"solar_declination": 20,
"hour_angle": 30
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "trig.solar_elevation_angle",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |