ParkFlow is a parking management system designed to enhance parking efficiency by providing real-time data on parking availability, notifications about parking areas, and intelligent Yellow Line parking services.
-
Real-time Data Pipeline Fetches real-time data from external sources, such as the Taipei parking API, and processes it to provide users with current parking grid availability.
-
Parking Area Notifications: Sends notifications to users about parking duration and fees, ensuring they stay informed and avoid penalties.
-
Yellow Line Service: Assists users with parking near yellow lines based on traffic conditions. During peak hours, the system provides a 3-minute buffer alert for parking time limits. During off-peak hours, it guides users on how to make the most of yellow line parking where permitted.
- Framework: FastAPI
- Middleware: CORSMiddleware for cross-origin requests
- External API: Taipei's parking API for real-time parking data
- Geospatial Analysis: geopy library for distance calculations in Yellow Line Service
- Deployment: Uvicorn with SSL support for secure deployment
- Clone the repository:
https://github.com/nyraa/vaclis-TownPass-Services-Backend.git- Install dependencies:
pip install -r requirements.txt- Set up environment variables by creating a .env file:
SSL_KEYFILE=your_ssl_keyfile
SSL_CERTFILE=your_ssl_certfile
SSL_PASSWORD=your_ssl_password- Run the server:
uvicorn app:app --host 0.0.0.0 --port 25569 --ssl-keyfile $SSL_KEYFILE --ssl-certfile $SSL_CERTFILE --ssl-keyfile-password $SSL_PASSWORD/:Fetches and returns real-time data on parking lots and parking grids based on user coordinates (longitude and latitude)./get_line:Returns nearby yellow line locations within a 1-kilometer radius from the user's coordinates.
Developed with ❤️ by 游松澤 (Yu Song-Ze), 張羿軒 (Zhang Yi-Xuan), 劉力瑋 (Liu Li-Wei), 楊乃昀(Yang Naiyun) ,張昀棠 (Chang Yun-Tang)
Project Team: 嘻嘻的時候，黑客松松澤