https://github.com/wizardoftrap/weathertrack

A modern Android weather tracking application that provides real-time weather updates and historical weather data analysis for any location worldwide.
https://github.com/wizardoftrap/weathertrack

Last synced: 11 months ago
JSON representation

A modern Android weather tracking application that provides real-time weather updates and historical weather data analysis for any location worldwide.

• Host: GitHub
• URL: https://github.com/wizardoftrap/weathertrack
• Owner: wizardoftrap
• Created: 2025-06-03T15:44:45.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2025-06-03T16:55:57.000Z (about 1 year ago)
• Last Synced: 2025-06-29T20:39:05.757Z (about 1 year ago)
• Language: Java
• Size: 692 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# WeatherTrack

A modern Android weather tracking application that provides real-time weather updates and historical weather data analysis for any location worldwide.

![WeatherTrack Banner](https://img.shields.io/badge/Android-Weather%20App-3DDC84?style=for-the-badge&logo=android&logoColor=white)

![API](https://img.shields.io/badge/API-21+-brightgreen?style=for-the-badge)

![Architecture](https://img.shields.io/badge/Architecture-MVVM-blue?style=for-the-badge)

##  Features

### Core Features

- **Real-time Weather Data**: Get current weather conditions including temperature, humidity, wind speed, and weather conditions

- **Location Search**: Search and save weather data for any city worldwide

- **Historical Data**: Automatically fetches and stores the last 7 days of weather history

- **Weekly Summary**: View temperature trends and weather patterns over the past week

- **Background Sync**: Automatic weather updates every 6 hours using WorkManager

- **Offline Support**: View previously fetched data even without internet connection

### Technical Features

- **MVVM Architecture**: Clean separation of concerns with ViewModel and LiveData

- **Room Database**: Local data persistence for offline access

- **Retrofit**: Type-safe HTTP client for API calls

- **WorkManager**: Reliable background task scheduling

- **Material Design**: Modern UI following Material Design guidelines

##  Screenshots

| Main Screen | Weekly Summary | Day wise Summary | Error Handling |

|------------|----------------|-----------------|-----------------|

| ![Home](home.png) | ![Week Summary](weekly_summary.png) | ![Day wise detailed summary](daywise_detailed_summary.png) | ![Error Handling](error_handling.png) |

##  Tech Stack

- **Language**: Java

- **Architecture**: MVVM (Model-View-ViewModel)

- **Database**: Room Persistence Library

- **Networking**: Retrofit 2.9.0

- **Background Tasks**: WorkManager 2.9.0

- **UI Components**: Material Design Components

- **Weather API**: [Open-Meteo API](https://open-meteo.com/)

- **Geocoding API**: [Open-Meteo Geocoding](https://open-meteo.com/en/docs/geocoding-api)

##  Project Structure

```

WeatherTrack/

├── app/

│   ├── src/main/java/com/example/weathertrack/

│   │   ├── data/

│   │   │   ├── local/          # Room database

│   │   │   │   ├── WeatherDao.java

│   │   │   │   └── WeatherDatabase.java

│   │   │   ├── model/          # Data models

│   │   │   │   ├── Weather.java

│   │   │   │   ├── OpenMeteoResponse.java

│   │   │   │   └── GeocodingResponse.java

│   │   │   ├── remote/         # API services

│   │   │   │   ├── WeatherApiService.java

│   │   │   │   └── RetrofitClient.java

│   │   │   └── repository/     # Repository pattern

│   │   │       └── WeatherRepository.java

│   │   ├── ui/

│   │   │   ├── main/           # Main activity

│   │   │   └── summary/        # Summary activity

│   │   │       ├── SummaryActivity.java

│   │   │       └── WeatherDayAdapter.java

│   │   ├── utils/              # Utility classes

│   │   │   ├── Constants.java

│   │   │   ├── DateConverter.java

│   │   │   └── WeatherCodeMapper.java

│   │   ├── viewmodel/          # ViewModels

│   │   │   └── WeatherViewModel.java

│   │   └── worker/             # Background workers

│   │       └── WeatherSyncWorker.java

│   └── res/

│       ├── layout/             # XML layouts

│       ├── values/             # Resources

│       └── drawable/           # Icons and drawables

```

##  Configuration

##  Key Components

### Repository Pattern

The app uses the Repository pattern to abstract data sources:

- Fetches data from Open-Meteo API

- Caches data in Room database

- Provides a single source of truth

### Background Sync

WorkManager ensures weather data is updated every 6 hours:

- Respects device battery optimization

- Works even if the app is closed

- Requires network connectivity

##  API Endpoints Used

### Weather API

- **Current Weather**: `https://api.open-meteo.com/v1/forecast`

- **Historical Weather**: `https://historical-forecast-api.open-meteo.com/v1/forecast`

### Geocoding API

- **City Search**: `https://geocoding-api.open-meteo.com/v1/search`

## Acknowledgments

- [Open-Meteo](https://open-meteo.com/) for providing free weather API

- [Material Design](https://material.io/) for design guidelines

- [Android Developers](https://developer.android.com/) for excellent documentation

---

Made with ❤️ by [Shiv Prakash Verma]