Pobieranie i zapisywanie danych pogodowych z OpenWeather za pomocą wtyczki REST

Firma OpenWeather udostępnia dane meteorologiczne i prognozy za pośrednictwem swojej witryny OpenWeatherMap. Dane te można zintegrować z własnymi aplikacjami. Pobieranie informacji odbywa się poprzez oferowane API z interfejsem REST, dzięki czemu integracja może zostać zautomatyzowana. Oprócz szczegółowych prognoz długoterminowych, które są płatne, można bezpłatnie wywoływać aktualne dane pogodowe oraz prognozy krótkoterminowe.

REST Open Weather z OPC Routerem

Na przykładzie OpenWeatherMap pokazujemy, jak wykorzystać wtyczkę REST oprogramowania OPC Router do wywoływania interfejsów REST API oraz w jaki sposób

• • pobrać dane pogodowe z OpenWeatherMap
  • przetwarzane są dane pogodowe w formacie JSON
  • dane można przechowywać w bazie danych SQL za pomocą wtyczki SQL Server
  • dane pogodowe można przesyłać telegramem za pomocą wtyczki Telegram

API pogodowe, interfejs REST do danych pogodowych

REST API

Interfejs REST to interfejs danych oparty na technologiach webowych. Dane z REST API mogą być pobierane za pośrednictwem protokołu HTTPS. Technicznie rzecz biorąc, strona internetowa jest wywoływana za pomocą adresu URL, tak jak w przeglądarce. Do wywołania strony przekazywane są parametry, które zostają dołączone do adresu URL jako pola parametrów. Znaczenie parametrów zostało zdefiniowane w odpowiedniej dokumentacji REST API. W przypadku Weather API od OpenWeather dokumentacja jest dostępna online pod adresem https://openweathermap.org/api.
Dla każdej formy pobierania danych (aktualna pogoda, prognoza dzienna / 5-dniowa / 16- niowa / 30-dniowa itp.) istnieje oddzielny punkt końcowy (endpoint) interfejsu API REST (wywoławczy adres URL). Przykład pobierania bieżącej pogody dla Londynu wygląda następująco: dane wynikowe w formacie JSON (wywołanie zwraca wyłącznie dane testowe).

Wywołanie REST

Parametr „q” zawiera nazwę miasta oraz kod kraju. Punktem końcowym (endpoint) REST API jest „weather”. Parametry są dołączane do punktu końcowego za pomocą znaku „?” i łączone operatorem „&”. Każdy parametr składa się z nazwy i wartości, rozdzielonych znakiem „=”. Parametr „appid” służy w Weather API do uwierzytelniania w celu identyfikacji klienta pobierającego dane. Na potrzeby własnej konfiguracji testowej musisz uzyskać własny identyfikator App-ID, aby móc realizować zapytania. Klucz API (App-ID) można uzyskać, rejestrując się na stronie home.openweathermap.org/users/sign_up. Po zalogowaniu klucz API jest widoczny w panelu użytkownika w zakładce „API keys”. Opis procedury pobierania aktualnej pogody dla dowolnej lokalizacji został udokumentowany tutaj: openweathermap.org/current

Po zdefiniowaniu hosta, w połączeniu OPC Routera można użyć obiektu transferu REST korzystającego z utworzonego hosta. W obiekcie transferu danych wybiera się odpowiedni punkt końcowy (endpoint) i określa parametry. Do pobierania aktualnej pogody służy endpoint „weather”, a w tym przypadku lokalizacja jest określana na podstawie ID lokalizacji (tutaj: Schenefeld z ID=2839763).

Aby znaleźć identyfikator (ID) swojej lokalizacji, po prostu wyszukaj swoje miasto na witrynie (https://openweathermap.org). Na stronie z prognozą pogody dla Twojego miasta ID znajdziesz w adresie URL: https://openweathermap.org/city/2839763. Jako metodę REST wykorzystuje się tutaj GET, a parametry są przekazywane jako „QueryString”. Dokumentację dotyczącą pobierania aktualnej pogody na podstawie ID miasta można znaleźć tutaj: https://openweathermap.org/current#cityid

Po wykonaniu połączenia informacje o strukturze JSON stają się dostępne. W tym celu w połączeniu umieszczono już 30-sekundowy wyzwalacz (trigger), a samo połączenie zostało opublikowane, aby mogło zostać uruchomione. Po jego wykonaniu, w konfiguracji obiektu transferu JSON można użyć funkcji „Suggestions”, aby zidentyfikować dostępne pola w dokumencie JSON i udostępnić je do wyboru. Za pomocą przycisków strzałek można wybrać pola, które mają zostać użyte w połączeniu.

Pobieranie danych pogodowych przez REST jako dokument JSON

Pobrane dane pogodowe można teraz poddać dalszemu przetwarzaniu. W tym przykładzie zapiszemy je w bazie danych i prześlemy do serwisu powiadomień. Do zapisu danych w bazie MS SQL wykorzystamy wtyczkę SQL Server. W konfiguracji wtyczki określa się standardowe parametry połączenia, po czym w obiekcie transferu dostępne stają się tabele i procedury składowane. Przykład pokazuje bazę „Weather” z tabel „TBL_WEATHER_CURRENT” jako miejsce przechowywania bieżących danych. Należy wybrać tę tabelę i zaznaczyć kolumny, które mają zostać użyte.

Wysyłanie informacji pogodowych przez komunikator Telegram

Wtyczka Telegram pozwala na dystrybucję danych pogodowych nie tylko przez SQL, ale także – przykładowo – bezpośrednio jako wiadomość push na urządzenie mobilne (np. telefon). Wtyczka ta służy do łączenia się z tzw. botami Telegrama, co pozwala na dwukierunkową komunikację: przesyłanie instrukcji od użytkownika do OPC Routera, a także wysyłanie komunikatów systemowych do zdefiniowanej grupy odbiorców. W poniższym przykładzie skonfigurowano bota dedykowanego do dystrybucji prognoz. Proces generowania bota w środowisku Telegram przebiega następująco:

Efekt końcowy: od OpenWeather do SQL Server i Telegram

W rezultacie, o określonej godzinie wyzwolenia (możliwe jest również działanie cykliczne lub o kilku porach), zestaw danych zostaje zapisany w bazie danych SQL, a wiadomość Telegram zostaje wysłana.

Dzięki funkcjonalności „przeciągnij i upuść”, OPC Router upraszcza dostęp oraz archiwizację danych pogodowych. Pobierz bezpłatną, pełną wersję demonstracyjną i sprawdź możliwości komunikacji poprzez interfejs REST.