An Intelligent Route Mapping System for USIU-Africa Visitors and Community
# đź§ USIU Smart Campus Navigator
**Project Overview:**
The **USIU Smart Campus Navigator** is a web-based interactive application designed to help students, staff, and visitors navigate the **USIU-Africa campus** efficiently. It provides optimal routes between campus locations, considering accessibility, route type, traffic conditions, and travel time.
This project leverages **Python**, **Flask**, **NetworkX**, **GeoPandas**, **Folium**, and **Matplotlib** for routing, visualization, and GIS integration.
---
## 👩‍🏫 Course Mentor
This project was developed under the guidance of **Mutanu, Leah, PhD**, who served as the course professor and mentor for this project.
---
## 🗂️ Folder Structure
```
USIU-Campus-Navigator/
│
├─ app.py # Main Flask application
├─ requirements.txt # Python dependencies
├─ README.md # Project documentation
│
├─ templates/ # HTML templates
│ ├─ index.html # User interface for route planning
│ ├─ admin.html # Admin interface for disabling routes
│ └─ login.html # Admin login page
│
├─ static/ # Static files (maps, CSS, JS)
│ └─ route\_map.html # Generated Folium map
│
├─ data/ # Spatial and routing data
│ ├─ combined\_cleaned\_routes.geojson # Cleaned campus route data
│ └─ disabled\_routes.json # Disabled edges configuration
│
└─ notebooks/ # Optional Jupyter notebooks for analysis & visualization
└─ route\_visualization.ipynb
````
---
## 🛠️ Features
- **User Functionality**
- Select **start** and **end** locations.
- Add up to **3 intermediate stops**.
- Choose **route type**: pedestrian, car, or any.
- Filter for **wheelchair accessible** paths.
- View the suggested route on a dynamic **Folium map**.
- Travel time annotated for each route segment, accounting for **traffic**.
- **Admin Functionality**
- Login with secure password.
- Enable or disable specific campus routes.
- Chang …