ForHosting KIT · Outils pour développeurs

Calculateur d’élévation solaire

L’angle d’élévation solaire, également appelé hauteur du Soleil, indique à quelle hauteur l’astre apparaît au-dessus ou au-dessous de l’horizon astronomique de l’observateur.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Ce calculateur applique l’équation classique de l’astronomie sphérique à trois angles : la latitude géographique, la déclinaison solaire et l’angle horaire. Saisissez chaque valeur en degrés décimaux pour obtenir l’élévation en degrés et en radians, l’angle zénithal complémentaire et le terme sinus employé. Un résultat positif place le Soleil au-dessus de l’horizon idéal, zéro correspond à l’horizon géométrique et une valeur négative place son centre au-dessous. Le calcul est déterministe et ne sollicite ni géolocalisation, ni date, ni modèle atmosphérique, ni réseau.

Principe de la formule d’élévation solaire

L’élévation solaire découle du triangle astronomique formé par le pôle céleste, le zénith et le Soleil. Le calculateur évalue l’équation sin élévation = sin latitude × sin déclinaison + cos latitude × cos déclinaison × cos angle horaire. La latitude situe l’observateur au nord ou au sud de l’équateur. La déclinaison solaire situe le Soleil au nord ou au sud de l’équateur céleste et varie au fil des saisons entre des limites proches des solstices. L’angle horaire représente la distance angulaire du Soleil au méridien local : il vaut zéro au midi solaire local, est négatif avant cet instant et positif après. L’arc sinus de l’expression complète donne une élévation comprise entre moins quatre-vingt-dix et plus quatre-vingt-dix degrés. Ce résultat est aussi la hauteur géométrique du Soleil, mesurée de l’horizon astronomique idéal jusqu’au centre du disque solaire. Son complément à quatre-vingt-dix degrés constitue l’angle zénithal solaire. De minuscules écarts d’arrondi flottant peuvent dépasser le domaine valide de l’arc sinus dans des configurations limites exactes. L’implémentation borne donc le sinus calculé dans l’intervalle fermé de moins un à un avant d’appliquer la fonction inverse. Cette protection numérique ne modifie pas les résultats ordinaires ; elle empêche un cas mathématiquement valide au pôle ou au zénith de produire une valeur machine invalide à cause d’un arrondi.

Choix et interprétation des trois entrées

Saisissez la latitude en degrés décimaux entre moins quatre-vingt-dix et plus quatre-vingt-dix, avec une valeur positive au nord de l’équateur et négative au sud. Indiquez la déclinaison solaire selon la même convention de signe. La déclinaison est une coordonnée astronomique : ce n’est ni le relèvement du Soleil ni la déclinaison magnétique. Si vous ne la possédez pas déjà grâce à des éphémérides ou à un calcul de position solaire fondé sur la date, vous devez l’obtenir avant d’utiliser cet outil. Saisissez enfin l’angle horaire entre moins cent quatre-vingts et plus cent quatre-vingts degrés. Zéro correspond au passage sur le méridien local, couramment appelé midi solaire local ; les valeurs négatives désignent le matin et les valeurs positives l’après-midi. Le cosinus étant symétrique, deux angles horaires de même valeur absolue avant et après midi donnent la même élévation géométrique lorsque latitude et déclinaison restent fixes. solar_elevation_angle_degrees contient la réponse principale. sun_altitude_degrees répète cette valeur sous un terme astronomique courant, tandis que solar_elevation_angle_radians convient aux logiciels et équations travaillant en radians. solar_zenith_angle_degrees est mesuré depuis le zénith vers le bas plutôt que depuis l’horizon vers le haut. Ces grandeurs décrivent une géométrie idéale, sans réfraction atmosphérique, relief, bâtiments ni rayon apparent du disque solaire.

Précision, périmètre et usages pratiques

Le calcul est exact pour les coordonnées sphériques fournies, dans les limites de la précision flottante normale, mais la pertinence de la réponse dépend de la qualité des entrées et de l’interprétation physique recherchée. La latitude doit correspondre au lieu d’observation, tandis que la déclinaison et l’angle horaire doivent se rapporter au même instant et à une convention astronomique cohérente. Une erreur d’angle horaire déplace directement le Soleil sur son arc quotidien, et une déclinaison approximative introduit une erreur saisonnière de position. Le calculateur ne déduit aucune de ces grandeurs d’une date civile, d’une heure légale, d’une longitude, d’un fuseau horaire ou d’une correction de l’équation du temps. Il fournit par ailleurs une élévation géométrique, et non apparente. Près de l’horizon, la réfraction atmosphérique peut relever la position observée d’une fraction notable de degré ; la correction réelle dépend de la pression, de la température et de la structure de l’atmosphère. Les définitions du lever et du coucher peuvent aussi utiliser le bord supérieur du disque plutôt que son centre : un résultat nul ne constitue donc pas automatiquement une heure officielle de lever ou de coucher. En ingénierie, la sortie peut alimenter des études préliminaires d’incidence photovoltaïque, d’ombrage ou d’éclairage naturel, à condition d’ajouter les corrections nécessaires d’azimut, de réfraction, d’horizon et d’orientation. Chaque calcul API réussi applique le tarif de base publié de $0.002 ; le navigateur peut exécuter le même algorithme pur sans réseau.

Contrôle de géométrie solaire

Calculez la hauteur géométrique du Soleil pour une latitude, une déclinaison et un angle horaire connus.

Modèles d’énergie renouvelable

Fournissez une élévation vérifiée aux calculs préliminaires d’incidence, d’ombrage et d’éclairage naturel.

Enseignement de l’astronomie

Illustrez l’effet de la latitude, de la déclinaison saisonnière et de l’écart au midi solaire sur la course quotidienne du Soleil.

L’élévation solaire et la hauteur du Soleil sont-elles identiques ?

Oui. Dans ce calculateur, ces deux termes désignent l’angle signé entre l’horizon astronomique idéal et le centre du Soleil.

Quelles unités faut-il employer pour les entrées ?

Saisissez la latitude, la déclinaison solaire et l’angle horaire en degrés décimaux. Le résultat donne l’élévation en degrés et en radians.

Quel angle horaire correspond au midi solaire local ?

Utilisez zéro degré. Les angles horaires négatifs précèdent le midi solaire local et les angles positifs le suivent.

Une élévation nulle indique-t-elle le lever ou le coucher observé ?

Pas nécessairement. La formule donne l’élévation géométrique du centre solaire, sans réfraction atmosphérique, rayon du disque ni horizon local.

Le calculateur déduit-il la déclinaison d’une date ?

Non. Il utilise la déclinaison fournie. À partir d’une date et d’un lieu, obtenez la déclinaison et l’angle horaire avec des éphémérides ou une méthode cohérente de position solaire.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/trig/solar-elevation-angle

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

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}'
{
  "latitude": 40,
  "solar_declination": 20,
  "hour_angle": 30
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "trig.solar_elevation_angle",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →