API godzin zachodu i wschodu słońca v1

Oferujemy darmowe API podające godziny zachodu i wschodu słońca dla określonej szerokości i długości geograficznej.

Pamiętaj, że korzystając z API, musisz podać źródło. Więcej informacji znajdziesz poniżej w sekcji „Limity użycia i podawanie źródła”.

To wersja 1 API — obsługiwana bezterminowo.

Zalecana, jeśli już z niej korzystasz. W nowym projekcie wybierz wersja 2 API.

Ta wersja będzie działać dokładnie tak jak dzisiaj. Nowsze funkcje — automatyczna lokalna strefa czasowa, znaczniki czasu ISO 8601, złota i niebieska godzina, położenie Słońca i zakresy dat — są dostępne tylko w wersja 2 API.

Dokładność obliczeń

Ta wersja API zachowuje pierwotne obliczenia, aby istniejący kod nadal działał. Jej godziny mogą nieznacznie różnić się od godzin w wersja 2 API, gdzie stosowany jest dokładniejszy model słoneczny.

Skala różnicy zależy od miejsca i daty: kilka sekund przy równiku i nawet minuta lub więcej na wysokich szerokościach geograficznych.

Dokumentacja API

Nasze REST API jest bardzo proste: wystarczy wysłać żądanie GET na adres https://api.sunrise-sunset.org/json. Nie trzeba się rejestrować ani uzyskiwać klucza API.

Parametry żądania

Przykładowe żądania

Trzy przykładowe żądania pobierające z naszego API dane o zachodzie i wschodzie słońca dla wybranego miejsca:


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-23
https://api.sunrise-sunset.org/json?lat=36.7201600&lng=-4.4203400&formatted=0

Odpowiedź

Odpowiedź API zawiera godziny zjawisk słonecznych w danym miejscu. Dane mają format JSON.

Pamiętaj, że jeśli nie podasz tzid, wszystkie godziny będą w UTC, a zwrócone dane nie uwzględnią czasu letniego.

Przykładowa odpowiedź:


    {
      "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"
    }

Odpowiedź bez formatowania dat:


    {
      "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"
    }

Znaczenie każdego elementu obiektu odpowiedzi wyjaśnia nasz słownik pojęć astronomicznych.

Kody statusu

Pole „status” w obiekcie odpowiedzi API zawiera status żądania. Może przyjmować następujące wartości:

Jak korzystać z API przez żądanie AJAX?

Użyj parametru callback, aby otrzymać odpowiedź JSONP i ominąć ograniczenia między domenami:

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

Limity użycia i podawanie źródła

Z API wschodu i zachodu słońca można korzystać bezpłatnie. Nie wolno przekraczać rozsądnej liczby żądań ani używać API w sposób nadmierny lub stanowiący nadużycie. Wymagamy podania źródła: zobacz, jak nas wskazać.

Aktualności

Zapisz się do newslettera API, aby otrzymywać informacje o zmianach i aktualnościach dotyczących usługi:

Otrzymuj powiadomienia o każdej zmianie: na GitHub otwórz nasze repozytorium API i wybierz Watch → Custom → Releases lub obserwuj nasz kanał RSS.



💡 Masz ciekawy pomysł? 🤦 Widzisz błąd?

Stale ulepszamy ten serwis!

Masz pomysł na treści lub informacje, które warto tu dodać, albo widzisz błąd? Daj nam znać!

Historia zmian

Kontakt

W sprawach dotyczących API skontaktuj się z nami.

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