Zapytaj i zapisz dane pogodowe z OpenWeather za pomocą wtyczki REST

Firma OpenWeather udostępnia dane pogodowe i prognozy na swojej stronie internetowej OpenWeatherMap https://openweathermap.org w celu pobrania. Dane można zintegrować z własnymi aplikacjami. Pobieranie jest możliwe za pośrednictwem oferowanego interfejsu API za pośrednictwem interfejsu REST, dzięki czemu integracja może być zautomatyzowana. Oprócz szczegółowych prognoz długoterminowych, które są płatne, bieżące dane pogodowe i prognozy krótkoterminowe można wywołać bezpłatnie.

REST Open Weather z OPC Routerem

Na przykładzie OpenWeatherMap pokazujemy użycie wtyczki OPC Router REST do wywoływania interfejsów API REST i pokazujemy, jak

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

Interfejs API pogody, interfejs REST do danych pogodowych

Interfejs REST to interfejs danych oparty na technologiach internetowych. Dane można pobrać z interfejsu API REST za pośrednictwem protokołu https. Technicznie rzecz biorąc, strona internetowa jest wywoływana za pomocą adresu URL, tak jak w przeglądarce. Parametry są przekazywane do wywołania strony internetowej, które są dołączane do adresu URL jako pola parametrów. Znaczenie parametrów jest zdefiniowane w odpowiedniej dokumentacji interfejsu API REST. Dokumentacja interfejsu API pogody OpenWeather jest dostępna online pod adresem https://openweathermap.org/api. Dla każdej formy pobierania danych (bieżąca pogoda, prognoza dzienna / 5 dni / 16 dni / 30 dni itp.) istnieje oddzielny punkt końcowy interfejsu API REST (adres URL wywołania).

Parametr „q” zawiera kod miasta i kraju. Punktem końcowym interfejsu API REST jest „weather”. Parametry są dołączane do punktu końcowego za pomocą „?” i łączone łańcuchem „&”. Każdy parametr jest deklarowany z nazwą i wartością, rozdzielonymi znakiem „=”.
Parametr „appid” jest używany przez Weather API jako uwierzytelnienie w celu identyfikacji klienta pobierającego. W przypadku własnej konfiguracji testowej należy poprosić o własny App-ID, aby pobrać dane. App-ID lub API KEY można uzyskać, rejestrując się na następującej stronie https://home.openweathermap.org/users/sign_up. API KEY można następnie wyświetlić w obszarze użytkownika w sekcji „API keys”.
Opis pobierania bieżącej pogody dla dowolnej lokalizacji jest udokumentowany tutaj: https://openweathermap.org/current

Teraz, gdy znany jest host dla wywołania, obiekt transferu REST może być użyty w połączeniu OPC Routera, który używa utworzonego hosta. Następnie wybierany jest odpowiedni punkt końcowy w obiekcie transferu i określane są parametry. Do pobrania bieżącej pogody używany jest punkt końcowy „pogoda”, a w tym przypadku lokalizacja jest określana przez identyfikator lokalizacji (tutaj Schenefeld z identyfikatorem = 2839763).

Aby znaleźć identyfikator swojej lokalizacji, po prostu wyszukaj swoje miasto na stronie głównej (https://openweathermap.org). Na stronie prognozy dla swojego miasta identyfikator można znaleźć w adresie URL: https://openweathermap.org/city/2839763
GET jest tutaj używany jako metoda REST, a parametry są przekazywane jako „QueryString”. Dokumentację dotyczącą pobierania bieżącej pogody według identyfikatora można znaleźć tutaj: https://openweathermap.org/current#cityid

Po wykonaniu połączenia dostępne są informacje o strukturze JSON. Dlatego w połączeniu umieszczono już 30-sekundowy wyzwalacz, a połączenie zostało opublikowane, aby można je było wykonać.
Po wykonaniu połączenia można użyć funkcji „Sugestie” w konfiguracji obiektu transferu JSON, aby określić dostępne pola z dokumentu JSON i udostępnić je do wyboru. Przycisków strzałek można użyć do wybrania pól do użycia w połączeniu.

Pobieranie danych pogodowych przez REST jako dokument JSON

Pobrane dane pogodowe można teraz dalej przetwarzać zgodnie z życzeniem. W tym przykładzie dane zostaną zapisane w bazie danych i wysłane do usługi komunikacyjnej. Wtyczka SQL Server OPC Routera może zostać użyta do zapisania danych w bazie danych MS SQL. W konfiguracji wtyczki określone są zwykłe parametry połączenia bazy danych SQL, a następnie tabele i procedury składowane są dostępne w wyborze obiektu transferu. Przykład pokazuje bazę danych „Weather” z tabelą „TBL_WEATHER_CURRENT” jako miejscem przechowywania bieżących danych pogodowych. Tabela jest wybrana, a kolumny, które mają zostać użyte, są oznaczone.

Pobieranie danych pogodowych przez REST jako dokument JSON

Wtyczka Telegram może być używana do dystrybucji danych pogodowych nie tylko za pośrednictwem SQL, ale również na przykład bezpośrednio za pośrednictwem wiadomości push do urządzenia mobilnego (np. telefonu komórkowego). Za pomocą wtyczki Telegram podłączane są tak zwane boty Telegram. Z jednej strony bot może być używany do wysyłania aktywnych poleceń od użytkownika mobilnego do OPC Routera, z drugiej strony OPC Router może również wysyłać aktywne wiadomości do zarejestrowanych użytkowników.
W naszym przykładzie wygenerowaliśmy bota telegramu, który jest używany do dystrybucji informacji pogodowych. Bot jest generowany za pośrednictwem aplikacji Telegram:

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

W rezultacie zbiór danych zostaje zapisany w bazie danych SQL w określonym momencie wyzwalania (możliwe jest również cykliczne lub kilkukrotne) i wysłana zostaje wiadomość telegramu.W naszym przykładzie wygenerowaliśmy bota telegramu, który jest używany do dystrybucji informacji pogodowych. Bot jest generowany za pośrednictwem aplikacji Telegram:

Wypróbuj sam i pobierz już dziś wersję próbną OPC Routera tutaj: