Dokumentacja API:

Każda stacja meteo podłączona do systemu Pogoda w Karkonoszach posiada dostęp do podstawowego API które to pozwala na pozyskanie "surowych" danych pomiarowych które możemy dowolnie użyć w swoich projektach. Dane dostarczane są w standardzie JSON. Podstawowa wersja api pozwala na pozyskanie danych których przykład znajduje się poniżej.
API ma ogromne możliwości i pozwala na pozyskanie ze stacji większej ilości informacji. Więcej informacji o API rozszerzonym w sekcji poniżej poswięconej jego możliwościom.

Oto przykładowy plik JSON API poodstawowego:

    
        {
        "lat": "50.8904", // Szerokość geograficzna służy do identyfikacji na mapie oraz w aplikacji.
        "lon": "15.7322", // Długość geograficzna służy do identyfikacji na mapie oraz w aplikacji.
        "data": {
                "cisnienie": "1010.1", // Jednostę cisnienia która trzeba dodać do wpisu to mb(milibary) lub hPa(hektopaskale) 
                "trend_cisnienia": "stable", // Trend cisnienia przyjmuje wartość up/down/stable - trend wskazuje czy ciśnienie wzrasta,maleje czy jest stałe
                "temperatura": "23.4", // Jednostka pomiaru to stopnie Celsjusza - ℃
                "wilgotnosc": "59", // wilgotność oczywiśćie wyrażamy w procentach % 
                "trend_temperatury": "up", // Trend temperatury przyjmuje wartość up/down/stable - trend wskazuje czy temperatura wzrasta,maleje czy jest stałe
                "deszcz": "0.0", // Jest to suma opadów od ostatniego odświeżenia stacji (15 min) wyrażona w mm.
                "suma_deszczu_24h": "0.0", // Jest to suma opadów z ostatnich 24h wyrażona w mm.
                "sila_wiatru": "1", // Aktualna siła zarejestowana podczas odświeżania informacji ze stacji (15min), wyrażona w km/h
                "maksymalna_sila_wiatru": "6", // Najwieksza stała siła wiatru w ciagu 24h wyrażona w km/h
                "temperatura_odczuwalna": "23.3" // Odczuwalna temperatura wyliczona z danych wilgotności, temperatury i siły wiatru. Wyrażona w stopniach Celsjusza - ℃
                }
        }

Oto przykładowy plik JSON API rozszerzonego:

W budowie

Jak uzyskać dostęp do API?

Jeśli jesteś właścicielem lub sponsorem stacji napisz mail na adres hello@pogodawkarkonoszach.pl a udostępnimy Ci API wraz z kompletną dokumentacją w pdf.

API FAQ:

Mam link do swojego pliku JSON, jest poprawny ale wcześniej działał teraz się nie wczytuje - System na naszych serwerach blokuje dostęp z adresów IP które zbyt agresywnie odpytują API (więcej niż 1 odpytanie na 5 sekund)<
Mam wrażenie że dane w pliku JSON się nie odświeżają - dane aktualizują się w tym samym czasie co odpytywana jest stacja czyli co 15 min.
Czy w API jest udostępniona opcja generowania grafiki która prezentuje pogodę w formie wizualnej? - Nie i nie przewidujemy dodawania takiej możliwości, usługą z grafiką będzie widget pogodowy
Gdzie mogę wykorzystać dane pozyskane z API? - wszędzie gdzie tylko chcesz, możesz użyć ich na swojej stronie www, w aplikacji smart home. Wszędzie gdzie masz możliwść napisania funkcjonalności pobierania danych z JSONA. Jeśli nie potrafisz wykonać integracji napisz mail do nas postaramy się pomóc.