https://github.com/apostolissiampanis/weather-app-api
WeatherApp is a Java-based console application that retrieves and processes weather data using the wttr.in web service.
https://github.com/apostolissiampanis/weather-app-api
api data hibernate java json lombok objected-orientated-programing oop spring-boot spring-data-jpa sqlite webflux
Last synced: about 1 month ago
JSON representation
WeatherApp is a Java-based console application that retrieves and processes weather data using the wttr.in web service.
- Host: GitHub
- URL: https://github.com/apostolissiampanis/weather-app-api
- Owner: ApostolisSiampanis
- License: mit
- Created: 2025-02-21T19:33:43.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-03-16T17:51:48.000Z (over 1 year ago)
- Last Synced: 2025-10-14T19:12:46.058Z (8 months ago)
- Topics: api, data, hibernate, java, json, lombok, objected-orientated-programing, oop, spring-boot, spring-data-jpa, sqlite, webflux
- Language: Java
- Homepage: https://apostolissiampanis.github.io/Weather-App-API/
- Size: 3.91 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Weather App Api
## [University of Piraeus](https://www.unipi.gr/en/home/) | [Department of Informatics](https://cs.unipi.gr/en/)
**MSc course**: Advanced Topics of Object - Oriented Programming (Java)
**Semester**: 1
**Project Completion Year**: 2025
## Description
WeatherApp is a Java-based console application that retrieves and processes weather data using the wttr.in web service. The application fetches weather information in JSON format and allows users to search for weather conditions based on city names. The retrieved data is stored in a local database for later analysis and statistical calculations.
## Features
- **Get weather data for a city:** Retrieve real-time weather information, including temperature, humidity, wind speed, UV index, and weather description.
- **Get average weather for a city:** Calculate the average weather conditions for a specific city based on previous searches stored in the database.
- **Get average weather for the last X days:** Compute and display the average weather conditions for a specified number of days.
- **Find the hottest city:** Identify the city with the highest recorded temperature in the database.
- **Find the coldest city:** Identify the city with the lowest recorded temperature in the database.
- **Find the most searched cities:** Display the cities that have been searched the most by users.
## Data Storage
The application uses a local SQLite database to store search results. Each record includes:
- City name
- Temperature (°C)
- Humidity (%)
- Wind speed (km/h)
- UV index
- Weather description
- Timestamp of the search
## API Reference
The application interacts with the wttr.in API, which provides weather data in JSON format. More details can be found in the official API documentation: [wttr.in GitHub](https://github.com/chubin/wttr.in?#readme).
## Javadocs
The Javadocs for this project are hosted on GitHub Pages. You can access them directly from the following link:
[Weather App api Javadocs](https://apostolissiampanis.github.io/Weather-App-API/)
The documentation includes detailed descriptions for all classes, methods, and fields.
## Contributors
Apostolis Siampanis
Dimitris Stylianou
## Acknowledgments
This project was developed as part of the "Advanced Topics of Object - Oriented Programming (Java)" MSc course at the University of Piraeus. Contributions and feedback are always welcome!
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.