API für Sonnenaufgangs- und Sonnenuntergangszeiten

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 Namensnennung“ weiter unten.

Dies ist Version 1 der API — unbefristet unterstützt.

Empfohlen, wenn Sie sie bereits nutzen. Für ein neues Projekt nehmen Sie besser Version 2 der API.

Diese Version funktioniert weiterhin genau wie heute. Die neueren Funktionen — automatische lokale Zeitzone, ISO-8601-Zeitstempel, goldene und blaue Stunde, Sonnenstand und Datumsbereiche — gibt es nur in Version 2 der API.

Genauigkeit der Berechnungen

Diese Version der API behält ihre ursprünglichen Berechnungen bei, damit bestehender Code nicht kaputtgeht. Darin steckt ein bekannter Fehler bei den Auf- und Untergangszeiten: Sonnenaufgänge kommen etwas zu früh, Sonnenuntergänge etwas zu spät, und der Tag wirkt dadurch etwas länger, als er ist. Behoben ist das in Version 2 der API.

Wie groß die Abweichung ist, hängt von Ort und Datum ab: etwa eine Minute in Äquatornähe und bis zu rund acht Minuten in hohen Breiten. Auch die Dämmerungszeiten weichen leicht ab: einige Sekunden in Äquatornähe und bis zu etwa einer Minute in hohen Breiten.

API-Dokumentation

Unsere REST-API ist sehr einfach: Sie müssen nur eine GET-Anfrage an https://api.sunrise-sunset.org/json senden. Sie brauchen weder eine Anmeldung noch einen API-Schlüssel.

Anfrageparameter

Beispielanfragen

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=2026-10-15
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: Sofern Sie keine tzid angeben, sind alle Zeiten in UTC angegeben, und die Sommerzeit ist in den zurückgegebenen Daten nicht berücksichtigt.

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.

Statuscodes

Das Feld "Status" im API-Antwortobjekt enthält den Status der Anfrage. Das Feld "status" kann die folgenden Werte enthalten:

Wie kann man die API über eine AJAX-Anfrage nutzen?

Verwenden Sie den Parameter callback, um eine JSONP-Antwort zu erhalten und domänenübergreifende Beschränkungen zu umgehen:

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 darf nicht über eine vernünftige Zahl von Anfragen hinaus oder übermäßig bzw. missbräuchlich genutzt werden. Eine Quellenangabe ist Pflicht: siehe wie du uns nennst.

Ankündigungen

Abonnieren Sie unseren API-Newsletter, um über Änderungen und Ankündigungen zu unserem Dienst auf dem Laufenden zu bleiben:

Über jede Änderung informiert werden: Öffne auf GitHub unser API-Repository und wähle Watch → Custom → Releases, oder abonniere unseren RSS-Feed.



💡 Haben Sie eine gute Idee? 🤦 Haben Sie einen Fehler gefunden?

Wir sind ständig dabei, diese Website zu verbessern!

Wenn Sie eine Idee für Inhalte oder Informationen auf dieser Seite haben oder einen Fehler gefunden haben, lassen Sie es uns bitte wissen!

Änderungsprotokoll

Kontakt

Bitte kontaktieren Sie uns für alle Ihre API-Fragen.

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