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
- lat (float): Latitude en degrés décimaux. Obligatoire.
- lng (float): Longitude en degrés décimaux. Obligatoire.
- date (string): Date au format AAAA-MM-JJ. Accepte également d'autres formats de date et même des formats de date relative. Si elle n'est pas présente, la date est par défaut la date du jour. Facultatif.
- callback (string) : Nom de la fonction de rappel pour la réponse JSONP. Facultatif.
- formatted (integer): 0 ou 1 (1 est la valeur par défaut). Les valeurs temporelles dans la réponse seront exprimées conformément à la norme ISO 8601 et la longueur du jour sera exprimée en secondes. Facultatif.
- tzid (string): Un identifiant de fuseau horaire, comme par exemple : UTC, Afrique/Lagos, Asie/Hong_Kong ou Europe/Lisbonne. La liste des identifiants valides est disponible dans la liste des fuseaux horaires pris en charge. S'il est fourni, les heures de la réponse seront référencées par rapport au fuseau horaire indiqué. Facultatif.
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-11-09 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 :
- "OK": indique qu'aucune erreur ne s'est produite ;
- "INVALID_REQUEST": indique que les paramètres lat ou lng sont manquants ou invalides ;
- "INVALID_DATE": indique que le paramètre de date est manquant ou invalide ;
- "UNKNOWN_ERROR": indique que la demande n'a pas pu être traitée en raison d'une erreur du serveur. La demande peut aboutir si vous réessayez.
- "INVALID_TZID": indique que la valeur du paramètre tzId fournie n'est pas valide, la réponse est valide mais les heures sont en UTC.
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
- 27 décembre 2023: Plusieurs corrections de bugs mineurs.
- Le 5 décembre 2023: Le nouveau paramètre tzId vous permet de fournir un fuseau horaire personnalisé pour vos demandes.
- 29 novembre 2023: Publication de la page d'état de l'API. Abonnez-vous pour recevoir des alertes si le service tombe en panne.
- 21 septembre 2018: Nouveau serveur API ! Les problèmes de temps d'arrêt ont été corrigés.
- Le 5 avril 2017: Les demandes HTTPS sont acceptées.
- 26 février 2016: Les dates sont maintenant vérifiées pour être des dates grégoriennes valides.
- 22 mai 2015: Prise en charge des dates ISO 8601 par l'ajout du paramètre "formatted" à la requête.
- 16 mai 2015: Correction de bugs mineurs.
- 22 avril 2015: CORS a été activé.
- 15 mars 2015: Le type de contenu de la réponse a été modifié en "application/json".
- 23 février 2015: Réponse JSONP disponible !
- 22 décembre 2014: Nouvelles données ajoutées à la réponse : midi solaire, durée du jour et crépuscule civil, nautique et astronomique (début et fin).
- 16 décembre 2014: La première version de l'API est disponible !
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é !