Heures de coucher et de lever du soleil API

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 requise si vous utilisez notre API. Consultez la section "Limites d'utilisation et attribution" ci-dessous pour plus d'informations.

Documentation de l’API

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

Paramètres de la demande

Demandes d'échantillons

Voici trois exemples de demandes pour obtenir des informations sur le coucher et le lever du soleil à partir de notre API pour un lieu donné :


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=2024-03-01
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 que vous ne fournissiez un tzId, toutes les heures sont exprimées en UTC et les ajustements à l'heure d'été ne sont pas inclus dans les données renvoyées.

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 de définitions astroniques pour comprendre chaque élément de l'objet de la réponse.

Codes d'état

Le champ "status" de l'objet réponse de l'API contient le statut de la demande. Le champ "status" peut contenir 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 éviter les frontières entre domaines :

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

Limites d'utilisation et attribution

L'API sur le lever et le coucher du soleil peut être utilisée gratuitement. Vous ne pouvez pas utiliser cette API d'une manière qui dépasse le volume raisonnable de demandes ou qui constitue une utilisation excessive ou abusive. Nous vous demandons de nous attribuer la paternité de l'œuvre et d'indiquer un lien vers notre site.

Annonces

S'abonner à notre lettre d'information sur l'API pour être tenu au courant des changements et des annonces concernant le service :



💡 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 !

Changelog

Contact

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

Si vous aimez utiliser notre API, n'hésitez pas à soutenir le projet en nous offrant un café !