IT114115-FYP-EaseParkHK
EaseParkHK 
EaseParkHK is a Flask-based car park vacancy system providing real-time parking availability for Hong Kong districts. This project was developed as part of the Final Year Project for the Higher Diploma in Cloud and Data Centre Administration at the Hong Kong Institute of Vocational Education (IVE).
Features
- Real-time car park vacancy updates for Hong Kong.
- Meter parking space availability.
- Traffic camera feeds for real-time road monitoring.
- Traffic notices for road closures, accidents, and alerts.
- AI assistant for car park vacancy queries.
- Filter by vehicle type (e.g., private cars, motorcycles).
- Detailed car park info (address, contact, website).
- Interactive map showing car park and meter locations.
Installation & Setup
- Clone the repository:
git clone https://github.com/HenryLok0/IT114115-FYP-EaseParkHK cd IT114115-FYP-EaseParkHK - Create and activate a virtual environment:
python3 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate - Install dependencies:
pip install -r requirements.txt - Populate the database:
python test_data.py - Run the application:
flask --debug run --host=0.0.0.0
Environment Variables
Set the following environment variables before running the application:
GOOGLE_GENAI_API_KEY: Your Google Gemini API key, obtained from Google Cloud Console.DATABASE_URL: Your PostgreSQL database URL, e.g.,postgresql://user:password@localhost:5432/dbname.
Ports and Services
- Port 5000: EaseParkHK website (main application)
- Port 5050: pgAdmin (Docker-based database management)
- Port 8025: Email reset website (for password recovery)
Usage
- Go to http://localhost:5000 to access EaseParkHK.
- Use the navigation bar to browse car parks and meter parking by district.
- Filter by vehicle type or view locations on the map.
- Access traffic cameras and notices for real-time updates.
- Ask the AI assistant questions (e.g., “Which car parks in Kowloon have spaces now?”).
- Manage the database with pgAdmin at http://localhost:5050.
- Use http://localhost:8025 for email-based password resets.
Contributors
Development Team
Project Supervisor
Contributing
Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Support
If you have questions or need help, please open an issue on GitHub.
Thank you to all contributors and the open-source community for your support.