API des heures de coucher et de lever du soleil

Nous proposons une API gratuite qui fournit les heures de coucher et de lever du soleil pour une latitude et une longitude données.

Veuillez noter que l’attribution est obligatoire si vous utilisez notre API. Consultez la section « Limites d’utilisation et attribution » ci-dessous pour en savoir plus.

Ceci est la version 1 de l'API — maintenue indéfiniment.

Recommandée si vous l'utilisez déjà. Pour un nouveau projet, utilisez plutôt la version 2 de l'API.

Cette version continuera de fonctionner exactement comme aujourd'hui. Les nouveautés — fuseau horaire local automatique, horodatages ISO 8601, heure dorée et heure bleue, position solaire et plages de dates — ne sont que dans la version 2 de l'API.

Précision des calculs

Cette version de l'API conserve ses calculs d'origine pour ne pas casser le code existant. Ils comportent une erreur connue sur les heures de lever et de coucher : les levers arrivent un peu trop tôt, les couchers un peu trop tard, et la journée paraît donc un peu plus longue qu'elle ne l'est. C'est corrigé dans la version 2 de l'API.

L’écart dépend du lieu et de la date : environ une minute près de l’équateur et jusqu’à huit minutes environ aux hautes latitudes. Les heures de crépuscule sont elles aussi légèrement décalées : quelques secondes près de l’équateur et jusqu’à environ une minute aux hautes latitudes.

Documentation de l’API

Notre API REST est très simple : il suffit de faire une requête GET à https://api.sunrise-sunset.org/json. Inutile de vous inscrire ou d’obtenir une clé API.

Paramètres de la requête

Exemples de requêtes

Voici quelques exemples de requêtes pour obtenir les heures de lever et de coucher du soleil d’un lieu avec notre API :


https://api.sunrise-sunset.org/json?lat=36.7201600&lng=-4.4203400

https://api.sunrise-sunset.org/json?lat=36.7201600&lng=-4.4203400&date=today

https://api.sunrise-sunset.org/json?lat=36.7201600&lng=-4.4203400&date=2026-10-15
https://api.sunrise-sunset.org/json?lat=36.7201600&lng=-4.4203400&formatted=0

Réponse

La réponse de l'API comprend les heures des événements solaires dans le lieu donné. Les données sont formatées en JSON.

Notez qu’à moins de fournir un paramètre tzid, toutes les heures sont exprimées en UTC et ne tiennent pas compte de l’heure d’été.

Un exemple de réponse :


    {
      "results":
      {
        "sunrise":"7:27:02 AM",
        "sunset":"5:05:55 PM",
        "solar_noon":"12:16:28 PM",
        "day_length":"9:38:53",
        "civil_twilight_begin":"6:58:14 AM",
        "civil_twilight_end":"5:34:43 PM",
        "nautical_twilight_begin":"6:25:47 AM",
        "nautical_twilight_end":"6:07:10 PM",
        "astronomical_twilight_begin":"5:54:14 AM",
        "astronomical_twilight_end":"6:38:43 PM"
      },
       "status":"OK",
       "tzid": "UTC"
    }

Réponse sans formatage de la date :


    {
      "results":
      {
        "sunrise":"2015-05-21T05:05:35+00:00",
        "sunset":"2015-05-21T19:22:59+00:00",
        "solar_noon":"2015-05-21T12:14:17+00:00",
        "day_length":51444,
        "civil_twilight_begin":"2015-05-21T04:36:17+00:00",
        "civil_twilight_end":"2015-05-21T19:52:17+00:00",
        "nautical_twilight_begin":"2015-05-21T04:00:13+00:00",
        "nautical_twilight_end":"2015-05-21T20:28:21+00:00",
        "astronomical_twilight_begin":"2015-05-21T03:20:49+00:00",
        "astronomical_twilight_end":"2015-05-21T21:07:45+00:00"
      },
       "status":"OK",
       "tzid": "UTC"
    }

Consultez notre glossaire des termes astronomiques pour comprendre chaque élément de la réponse.

Codes d'état

Le champ « status » de la réponse de l’API indique l’état de la requête. Il peut prendre les valeurs suivantes :

Comment utiliser l'API à partir d'une requête AJAX ?

Utilisez le paramètre callback pour recevoir une réponse JSONP et contourner les restrictions entre domaines (cross-domain) :

https://api.sunrise-sunset.org/json?lat=36.7201600&lng=-4.4203400&callback=mycallback

Limites d'utilisation et attribution

L’API de lever et coucher du soleil est gratuite. Elle ne doit pas être utilisée au-delà d’un volume raisonnable de requêtes, ni de façon excessive ou abusive. L’attribution est obligatoire : voyez comment nous citer.

Annonces

Abonnez-vous à notre lettre d’information sur l’API pour être tenu au courant des changements et des annonces concernant le service :

Soyez averti de chaque changement : sur GitHub, ouvrez notre dépôt de l’API et choisissez Watch → Custom → Releases, ou suivez notre flux RSS.



💡 Vous avez une idée géniale ? 🤦 Vous avez trouvé des erreurs ?

Nous améliorons constamment ce site web !

Si vous avez une idée de contenu ou d'information à inclure dans cette page ou si vous avez trouvé une erreur, n'hésitez pas à nous en faire part !

Journal des modifications

Contact

N'hésitez pas à nous contacter pour toutes vos questions relatives à l'API.

If you enjoy using our API please consider supporting the project by buying us a coffee!