Zeiten für Sonnenuntergang und Sonnenaufgang API
Wir bieten eine kostenlose API an, die Sonnenuntergangs- und Sonnenaufgangszeiten für einen bestimmten Breiten- und Längengrad liefert.
Bitte beachten Sie, dass bei der Nutzung unserer API eine Namensnennung erforderlich ist. Weitere Informationen finden Sie im Abschnitt "Nutzungsbeschränkungen und Zurechnung" weiter unten.
API-Dokumentation
Unsere ist eine sehr einfache REST-API, Sie müssen nur eine GET-Anfrage an https://api.sunrise-sunset.org/json stellen . Sie brauchen sich nicht anzumelden oder einen API-Schlüssel zu erhalten.
Parameter anfordern
- lat (float): Breitengrad in Dezimalgraden. Erforderlich.
- lng (float): Längengrad in Dezimalgraden. Erforderlich.
- date (string): Datum im Format JJJJ-MM-TT. Akzeptiert auch andere Datumsformate und sogar relative Datumsformate. Wenn nicht vorhanden, wird das aktuelle Datum als Standardwert verwendet. Optional.
- callback (String): Name der Callback-Funktion für die JSONP-Antwort. Wahlweise.
- formatted (integer): 0 oder 1 (1 ist Standard). Die Zeitwerte in der Antwort werden nach ISO 8601 ausgedrückt und day_length wird in Sekunden angegeben. Optional.
- tzid (string): Eine Zeitzonenkennung, wie zum Beispiel: UTC, Afrika/Lagos, Asien/Hong_Kong, oder Europa/Lissabon. Die Liste der gültigen Bezeichner finden Sie in der Liste der unterstützten Zeitzonen. Falls angegeben, beziehen sich die Zeiten in der Antwort auf die angegebene Zeitzone. Optional.
Musteranfragen
Dies sind drei Beispielanfragen zum Abrufen von Sonnenuntergangs- und Sonnenaufgangsinformationen von unserer API für einen bestimmten Ort:
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=2025-02-07 https://api.sunrise-sunset.org/json?lat=36.7201600&lng=-4.4203400&formatted=0
Antwort
Die API-Antwort enthält die Zeiten für die Sonnenereignisse an dem angegebenen Ort. Die Daten werden mit JSON formatiert.
Beachten Sie, dass alle Zeiten, sofern Sie keine tzId angeben, in UTC und Sommerzeitanpassungen sind in den zurückgegebenen Daten nicht enthalten.
Eine Beispielantwort:
{ "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" }
Antwort ohne Datumsformatierung:
{ "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" }
Schauen Sie in unserem Glossar der astronomischen Definitionen nach, um jedes Element des Antwortobjekts zu verstehen.
Status-Codes
Das Feld "Status" im API-Antwortobjekt enthält den Status der Anfrage. Das Feld "status" kann die folgenden Werte enthalten:
- "OK": zeigt an, dass keine Fehler aufgetreten sind;
- "INVALID_REQUEST": zeigt an, dass entweder die Parameter lat oder lng fehlen oder ungültig sind;
- "INVALID_DATE": zeigt an, dass der Datumsparameter fehlt oder ungültig ist;
- "UNKNOWN_ERROR": bedeutet, dass die Anfrage aufgrund eines Serverfehlers nicht bearbeitet werden konnte. Die Anfrage kann erfolgreich sein, wenn Sie es erneut versuchen.
- "INVALID_TZID": zeigt an, dass der angegebene Wert des Parameters tzId ungültig ist, die Antwort ist gültig, aber die Zeiten sind in UTC.
Wie kann man die API über eine AJAX-Anfrage nutzen?
Verwenden Sie den Parameter callback, um eine JSONP-Antwort zu erhalten und Domänengrenzen zu vermeiden:
https://api.sunrise-sunset.org/json?lat=36.7201600&lng=-4.4203400&callback=mycallback
Nutzungsbeschränkungen und Namensnennung
Die Sonnenaufgangs- und Sonnenuntergangs-API kann kostenlos genutzt werden. Sie dürfen diese API nicht in einer Weise nutzen, die ein angemessenes Anfragevolumen übersteigt oder eine übermäßige oder missbräuchliche Nutzung darstellt. Wir verlangen, dass Sie uns mit einem Link zu unserer Website nennen.
Ankündigungen
Abonnieren Sie unseren API-Newsletter, um über Änderungen und Ankündigungen zu unserem Dienst auf dem Laufenden zu bleiben:
💡 Haben Sie eine gute Idee? 🤦 Haben Sie einen Fehler gefunden?
Wir sind ständig dabei, diese Website zu verbessern!
Wenn Sie eine Idee haben, welche Inhalte oder Informationen diese Seite aufnehmen sollte, oder wenn Sie einen Fehler gefunden haben, lassen Sie es uns bitte wissen!
Änderungsprotokoll
- 27. Dezember 2023: Mehrere kleinere Fehlerkorrekturen.
- 5. Dezember 2023: Der neue Parameter tzId ermöglicht es Ihnen, eine benutzerdefinierte Zeitzone für Ihre Anfragen anzugeben.
- 29. November 2023: Freigabe der API-Statusseite. Abonnieren Sie die Seite, um Benachrichtigungen zu erhalten, wenn der Dienst ausfällt.
- 21. September 2018: Neuer API-Server! Probleme mit Ausfallzeiten wurden behoben.
- 5. April 2017: HTTPS-Anfragen werden akzeptiert.
- 26. Februar 2016: Die Daten werden jetzt auf gültige gregorianische Daten geprüft.
- 22. Mai 2015: Unterstützung für ISO 8601-Daten durch Hinzufügen des Parameters "formatiert" zur Anfrage.
- 16. Mai 2015: Kleinere Fehler behoben.
- 22. April 2015: CORS wurde aktiviert.
- März 15, 2015: Der Inhaltstyp der Antwort wurde auf "application/json" geändert.
- 23. Februar 2015: JSONP-Antwort verfügbar!
- 22. Dezember 2014: Neue Daten zur Antwort hinzugefügt: Sonnenmittag, Tageslänge und bürgerliche, nautische und astronomische Dämmerung (Beginn und Ende).
- 16. Dezember 2014: Die erste Version der API ist da!
Kontakt
Bitte kontaktieren Sie uns für alle Ihre API-Fragen.
Wenn Ihnen die Nutzung unserer API gefällt, sollten Sie das Projekt unterstützen, indem Sie uns einen Kaffee spendieren!