Smart Route Planner

Smart Route Planner is a full-stack web application for comparing driving routes with an open-source mapping stack, estimating congestion pressure, and demonstrating academic routing and prediction modules.

The default demo configuration requires no paid API keys.

Stack

• React 19 + Vite 7 frontend
• Node.js 22 + Express 5 backend
• MapLibre GL JS + OpenStreetMap raster tiles
• Photon geocoding + OSRM routing
• Open-Meteo forecast API

Features

• Open-source route comparison with distance, ETA, congestion estimate, and weather risk
• Recommended route scoring based on time, congestion estimate, and weather
• MapLibre map view with OpenStreetMap tiles and route highlighting
• A* pathfinding demo on a fixed Delhi NCR graph
• LSTM-style congestion prediction demo using a synthetic sequence model

Setup

1. Copy .env.example to .env.
2. Review the optional service base URLs in .env.example.
3. Install dependencies:

npm install

4. Start both apps:

npm run dev

Environment Variables

• PORT: backend port, defaults to 3001
• OSRM_API_BASE: routing service base URL, defaults to the public OSRM demo server
• PHOTON_API_BASE: geocoding service base URL, defaults to the public Photon demo server

API Endpoints

• GET /api/health
• GET /api/search/places?q=...
• POST /api/routes/compare
• GET /api/demo/astar/graph
• POST /api/demo/astar/path
• POST /api/demo/lstm/predict

Notes

• If OSRM or Photon are unavailable, the backend still supports coordinate-based input and deterministic fallback routes.
• The LSTM panel is intentionally labeled as an academic prototype backed by synthetic data.