Zapytanie do API. Program Weather App

Program Weather App to wygodne narzędzie do uzyskiwania i przechowywania danych o pogodzie z intuicyjnym interfejsem. Aplikacja dostarcza informacje o bieżącej pogodzie w wybranym mieście, współpracując z OpenWeatherMap API. Obsługuje również zapisywanie uzyskanych danych w plikach formatu CSV i JSON. Język programowania: Ruby.

• Funkcjonalność programu
Wprowadzanie danych: Użytkownik wprowadza nazwę miasta i klucz API OpenWeatherMap.
Zrealizowano walidację wejścia: nazwa miasta musi zawierać tylko litery łacińskie, spacje i myślniki.

Uzyskiwanie danych o pogodzie: Program wysyła żądanie HTTP do OpenWeatherMap API.
Jeśli dane zostaną pomyślnie uzyskane, obejmują: Miasto i kraj; Temperaturę powietrza (°C); Odczuwaną temperaturę (°C); Wilgotność (%); Prędkość wiatru (m/s) i kierunek (°); Ciśnienie atmosferyczne (hPa); Krótkie opisy pogody.

Informowanie użytkownika:
Jeśli żądanie jest udane, wyświetlana jest informacja o pogodzie w graficznym oknie popup. W przypadku błędów (np. nieprawidłowy klucz API, niedostępność usługi) wyświetlane jest odpowiednie komunikat o błędzie.

Zapis danych: Obsługiwane jest zapisywanie informacji o pogodzie w plikach:
CSV: dodawanie lub nadpisywanie danych.
JSON: łączenie z istniejącymi danymi lub tworzenie nowego pliku.
Użytkownik może wybierać istniejący plik lub podać nową nazwę za pomocą graficznego dialogu.

Interfejs użytkownika (UI): Pola wprowadzania dla klucza API i miasta; Przycisk do uzyskiwania pogody, zapisywania danych w CSV i JSON oraz wyjścia z aplikacji; Logo aplikacji wyświetlane jest w górnej części okna; Menu kontekstowe dla pól tekstowych (kopiuj/wklej); Interaktywne elementy: przyciski, okna popup i pole wyboru do wyświetlania klucza API.

Wyjście z programu: Użytkownik może zakończyć działanie aplikacji za pomocą przycisku "Exit".

• Cechy programu
Łatwość użycia: Intuicyjny graficzny interfejs. Walidacja danych użytkownika z wyświetlaniem komunikatów o błędach.

Wsparcie dla wielu formatów zapisu: CSV i JSON — popularne formaty do pracy z danymi.

Interaktywne elementy: Pole wyboru do wyświetlania lub ukrywania wprowadzonego klucza API.
Dialogi do wyboru lub zapisywania pliku.

Elastyczność: Możliwość dodawania danych do istniejącego pliku (dla obu formatów).

Obsługa błędów: Program obsługuje błędy żądań HTTP, wyjątki podczas pracy z plikami i nieprawidłowe wprowadzanie danych.

• Jak korzystać z aplikacji
1. Otwórz aplikację.
2. Wprowadź klucz API (można go uzyskać rejestrując się na stronie https://home.openweathermap.org/) i nazwę miasta (łacińskimi literami).
3. Naciśnij przycisk "Find city weather", aby uzyskać dane o pogodzie.
4. Aby zapisać dane, wybierz format (CSV lub JSON) i wskaź plik.
5. Naciśnij "Exit", aby wyjść.

#ruby #requests #request #api #requestapi #apirequest #programming #api-rozwoj #csv #json #HTTP #Student-programista