khalidstark/mowasalati

AI-powered public transportation app for Egypt — uses Google Gemini to generate multi-modal travel routes (bus, metro, microbus, taxi) across Egyptian cities with cost, duration, and map visualization. # Mowasalati (مواصلاتي) **An AI-Powered Public Transportation App for Egypt** Mowasalati solves one of the most frustrating parts of getting around in Egypt — figuring out which combination of bus, microbus, metro, or taxi to take, how long it'll actually take, and how much it'll cost. It uses Google Gemini AI and geospatial data to generate accurate, multi-modal travel routes across Egyptian cities and governorates. A scientific poster for this project is included in the repo: `Postermowasalati.pdf` --- ## The Problem Egypt's intercity transportation network is complex — multiple transport modes, no unified timetable, inconsistent info, and existing apps that don't cover the full picture (especially outside Cairo). Locals rely on asking around or guessing. Mowasalati replaces that with AI-generated, geospatially-verified routes. --- ## How It Works The app takes a starting point and destination, then runs them through a multi-stage AI pipeline: 1. **Prompt Engineering** — Builds a structured natural language prompt for Gemini, requesting a JSON-formatted route plan covering transport types, cost, duration, and number of transfers 2. **Gemini API Call** — Sends the prompt to Gemini 2.5 Flash, which generates plausible routes based on its training data 3. **Data Parsing & Sanitization** — Cleans the raw response, extracts valid JSON, and casts all fields to typed Dart objects 4. **Geocoding** — Converts location names to precise coordinates using Google Maps API 5. **Multi-Criteria Ranking** — Scores each route: Cost (40%), Duration (50%), Transfers (10%) 6. **Map Visualization** — Renders the best route on an interactive Flutter map with polylines and key stops --- ## Features - Multi-modal routes: bus, microbus, metro, taxi — combined intelligently - Real-time travel tips (traffic congestion warnings, best travel times) - Cost and duration estimates per route - Interactive map with route visualization - Tested across Cairo, Alexandria, Mansoura, Qalyub …