🌧️ Route Weather

"I was travelling with my papa. Suddenly it started raining. He kept asking me — check the weather of this village, now check that village, now the next one. I got tired of doing it one by one. Then the idea clicked — what if one program could show the weather for every village on your route, automatically?"

— That moment became this project.

---

What It Does

You enter a source and destination anywhere in Maharashtra (or anywhere in India). The program finds all villages along the driving route and shows you the weather at each one — not the weather right now, but the weather at the time you will actually arrive there.

Source      : Rohani
Destination : Lakhandur
Departure   : 09:00

-----------------------------------------------------------------
Village                Arrival    Temp           Weather
-----------------------------------------------------------------
Rohani                 09:00      32.1°C         ☀ Clear Sky
Kudegaon               09:14      31.4°C         ☁ Few Clouds
Padsodi                09:38      30.0°C         🌧 Light Rain (60% rain)
Lakhandur              10:11      29.3°C         ⛈ Thunderstorm (85% rain)

-----------------------------------------------------------------
  Weather Alerts
-----------------------------------------------------------------
  ⚠  Rain expected around 09:38
  ⚠  Thunderstorm expected around 10:11 — drive carefully

-----------------------------------------------------------------
                    Weather Timeline
-----------------------------------------------------------------
  Time     Temp       Rain%    Condition
  -------------------------------------------------------
  06:00    33.0°C     5        ☀ Clear Sky
  09:00    32.1°C     20       ☀ Clear Sky
  12:00    30.5°C     65       🌧 Light Rain
  15:00    28.8°C     85       ⛈ Thunderstorm
  18:00    27.4°C     40       ☁ Broken Clouds
  21:00    26.1°C     10       ☁ Few Clouds

========================================
           Journey Summary
========================================
  Distance          : 62.14 km
  Travel Time       : 71 min
  Departure         : 09:00
  Estimated Arrival : 10:11
  Highest Temp      : 33°C
  Lowest Temp       : 26°C
  Rain Expected     : YES ⚠
  Best Depart Time  : 06:00
========================================

---

How It Works

You enter source + destination + departure time
        ↓
OpenRouteService finds the driving route
        ↓
GPS coordinates sampled every ~2 km along the route
        ↓
Reverse geocoding finds the village name at each point
        ↓
OpenWeatherMap forecast API gets weather at your arrival time
        ↓
Everything printed in a clean table

---

Setup

1. Clone the repo

git clone https://github.com/rajhatwar477-jpg/route-weather.git
cd route-weather

2. Install dependencies

pip install -r requirements.txt

3. Get free API keys

Service	Link	Free tier
OpenRouteService	https://openrouteservice.org	2000 req/day
OpenWeatherMap	https://openweathermap.org/api	1000 req/day

4. Create your .env file

cp .env.example .env

Open .env and fill in your keys:

ORS_API_KEY=your_openrouteservice_key_here
WEATHER_API_KEY=your_openweathermap_key_here

5. Run

python app.py

---

Project Structure

route-weather/
├── app.py          ← main program (run this)
├── villages.py     ← finds village names from GPS coordinates
├── weather.py      ← gets weather forecast for each village
├── .env.example    ← template for your API keys
├── .env            ← your actual keys (never commit this)
├── requirements.txt
└── README.md

---

Roadmap

This is Version 1 — terminal only.

Version	Status	Features
v1.0	✅ Current	Terminal output, route + weather + alerts + summary
v2.0	🔜 Coming	Web UI with Flask, interactive map, village cards
v3.0	🔜 Future	AI route recommendation, traffic + flood alerts, alternate route suggestion

---

Built With

• OpenRouteService — driving route & geocoding
• OpenWeatherMap — 5-day / 3-hour forecast API
• Geopy / Nominatim — reverse geocoding (GPS → village name)
• Python standard library — datetime, timedelta, os

---

raj hatwar

Built out of a real problem, on a real rainy road.