Bản đồ Cứu hộ Khẩn cấp là một hệ thống thu thập, phân tích và hiển thị dữ liệu sự kiện khẩn cấp (cháy nổ, ngập lụt, tai nạn, thiên tai, mất điện...) tại Việt Nam. Mục tiêu của dự án là:
- 🧩 Tự động thu thập thông tin từ báo chí, mạng xã hội và các nguồn cộng đồng.
- 🗺️ Trực quan hóa vị trí sự kiện trên bản đồ số toàn quốc.
- ⚙️ Tạo nền tảng dữ liệu mở phục vụ nghiên cứu, cảnh báo và cứu hộ.
Hệ thống hoạt động theo mô hình Client–Server–Bot:
- Bot thu thập và xử lý dữ liệu thô.
- Server Flask cung cấp API và giao diện hiển thị.
- Frontend bản đồ (Leaflet) trình bày dữ liệu tương tác cho người dùng.
Bot được thiết kế modular như sau:
| File | Chức năng |
|---|---|
| crawler.py | Thu thập tin tức và bài đăng Facebook liên quan đến cứu hộ, thiên tai, tai nạn... |
| analyzer.py | Phân loại nội dung thu thập được thành 2 nhóm: news (tin tức) và rescue (cứu hộ). |
| location_extractor.py | Dùng NLP để rút trích địa danh, chuẩn hóa tên tỉnh/thành, và tìm tọa độ GPS (sử dụng API geocoding). |
| scheduler.py | Chạy bot theo lịch định kỳ (cronjob), tổng hợp dữ liệu mới, tránh trùng lặp, và kiểm tra dữ liệu lỗi. |
| uploader.py | Gửi dữ liệu đã chuẩn hóa đến API Flask /api/events để cập nhật lên bản đồ. |
Luồng hoạt động của modular
crawler.py → analyzer.py → location_extractor.py → uploader.py → Flask API
Sử dụng Flask để Xử lý API RESTful /api/events (GET, POST).
Lưu trữ và truy xuất dữ liệu từ cơ sở dữ liệu SQLite.
Hiển thị dữ liệu bằng Leaflet.js kết hợp VietMap API được tự động cập nhật mỗi 30 giây.
Sử dụng các Marker để hiển thị thể hiện loại sự kiện bằng màu sắc khác nhau:
-
🔴 Cháy nổ
-
🔵 Ngập lụt
-
🟠 Tai nạn
-
🟢 Cứu hộ khác
- Phụ thuộc nguồn dữ liệu: Bot chỉ thu thập được các bài viết và tin tức có thể truy cập công khai; những thông tin từ nhóm kín hoặc mạng xã hội hạn chế sẽ bị bỏ sót.
- Độ chính xác địa điểm: Một số bài viết không cung cấp địa chỉ cụ thể, dẫn đến tọa độ GPS có thể chưa hoàn toàn chính xác.
- Cập nhật thời gian thực còn hạn chế: Dữ liệu trên bản đồ được tải lại theo chu kỳ (mặc định 30 giây), chưa thực sự “live” từng giây.
- Khả năng phân loại sự kiện: Hiện tại bot phân loại chỉ dựa trên từ khóa; những bài viết phức tạp có thể bị phân loại nhầm.
- ☕ Python: Phiên bản ≥ 3.9
- 💻 Hệ điều hành: Windows 10/11, macOS, hoặc Linux.
- 📡 Kết nối mạng: Bắt buộc để bot thu thập tin tức từ web và Facebook, đồng thời tải bản đồ VietMap.
- 💾 Bộ nhớ: ≥ 4GB RAM, dung lượng trống tối thiểu 500MB
Yêu cầu:
- Python ≥ 3.9
- pip (Python Package Manager)
Cài đặt các thư viện cần thiết:
pip install flask flask-cors sqlalchemy requests beautifulsoup4 underthesea
Cấu trúc thư mục dự án:
project/
│
├── app.py # Flask server chính
├── database.py # Khởi tạo và kết nối cơ sở dữ liệu
├── bot/
│ ├── crawler.py # Thu thập tin tức & bài đăng mạng xã hội
│ ├── analyzer.py # Phân loại nội dung thành rescue/news
│ ├── location_extractor.py # Rút trích địa danh & toạ độ
│ ├── scheduler.py # Chạy định kỳ, quản lý luồng dữ liệu
│ └── uploader.py # Gửi dữ liệu lên API Flask
├── templates/
│ └── admin.html # Giao diện bản đồ cứu hộ
├── static/
│ ├── css/style.css # Giao diện & bố cục
│ └── js/map.js # Xử lý bản đồ, cập nhật marker
└── README.md
Mở terminal và điều hướng đến thư mục src của dự án:
cd path/to/project/src
Khởi động Server
python database.py
Sẽ tạo file data/events.db tự động.
Mở terminal và sử dụng:
python app.py
Truy cập:
- Trang bản đồ quản trị: http://127.0.0.1:5000/admin
Bạn mở 1 terminal song song và chạy:
python bot/scheduler.py
Bot sẽ:
- Gọi crawler.py để thu thập bài viết mới.
- Gọi analyzer.py để lọc bài liên quan cứu hộ.
- Dùng location_extractor.py để tìm địa danh và toạ độ.
- Dùng uploader.py để đẩy dữ liệu hợp lệ lên API Flask.
- Sinh viên thực hiện: Lã Việt Hoàng
- Khoa Công nghệ thông tin – Đại học Đại Nam
- 🌐 Website: https://dainam.edu.vn/vi/khoa-cong-nghe-thong-tin
- 📧 Email: [lahoangprotknl@gmail.com]
- 📱 Fanpage: AIoTLab - FIT DNU