ClearPath is a next-generation navigation engine that prioritizes human health by routing users through areas with the lowest Air Quality Index (AQI). Unlike traditional GPS, ClearPath optimizes for "Cleanest Air" rather than just the "Quickest Route."
The biggest challenge in environmental monitoring is Hardware Density. Most cities have fewer than 5 official monitoring stations, creating "blind spots" in navigation data.
ClearPath solves this by synthesizing an 8-node Virtual Sensor Mesh:
- The Concept: Instead of deploying $50,000 physical sensors, we use AI Virtual Sensors.
- The Logic: By feeding real-time environmental metadata (humidity, wind speed, traffic density, and proximity to industrial zones) into a Deep Learning model, we predict AQI levels with high confidence at any coordinate.
- The Result: Neighborhood-level granular data coverage (500m resolution) without the cost of physical infrastructure.
- Health-Optimized Routing: A custom A* implementation that weights paths by pollution exposure.
- Real-Time AQI Heatmaps: Dynamic Leaflet/Mapbox overlays showing pollution hotspots.
- Virtual Sensor Network: Predictive AI nodes bridging the hardware data gap.
- Caching Layer: Redis-integrated backend for low-latency spatial queries.
- Developer Documentation: Fully integrated Swagger (OpenAPI) documentation.
| Layer | Technologies |
|---|---|
| Frontend | React 18, Leaflet, Axios, CSS3 (Modular) |
| Backend | Node.js, Express (v5), Redis (Caching), FastPriorityQueue |
| Database | MongoDB (Mongoose) for spatial indices and user data |
| Data Engine | Python (Scikit-Learn/TensorFlow) for AQI predictive modelling |
| APIs | OpenStreetMap (via Overpass), OpenWeather, AirVisual |
- Data Ingestion: Background jobs (
node-cron) poll official APIs and local virtual sensors. - Processing: The ML engine recalibrates predictions based on latest environmental shifts.
- Storage: MongoDB stores historical data, while Redis handles the "Live" state for routing.
- Client: The React frontend requests routes while providing a "Health Weight" preference toggle.
- Node.js (v18+)
- MongoDB Atlas (or local instance)
- Redis Server
- API Keys: OpenWeather, Mapbox (optional)
- Navigate to the root directory.
- Install dependencies:
npm install - Configure
.envfile (see.env.example). - Start the server:
npm run dev
cd frontendnpm install- Start development server:
npm start
Distributed under the MIT License. See LICENSE for more information.
Author - https://github.com/pKm720
- Project Link: (https://github.com/pKm720/Clear_Path)
Created with ❤️ to help urban commuters breathe better.