VNGeoData
VNGeoData là một ứng dụng web tĩnh mã nguồn mở, cung cấp thông tin về các đơn vị hành chính của Việt Nam (34 tỉnh/thành và 3.321 xã/phường) sau cuộc cải tổ hành chính có hiệu lực từ ngày 01/07/2025. Dự án được lưu trữ trên GitHub Pages, với dữ liệu hành chính được cung cấp dưới dạng file JSON.
Tính năng
Tra cứu qua giao diện web: Chọn tỉnh/thành từ dropdown để xem danh sách xã/phường tương ứng.
Truy cập dữ liệu JSON: Sử dụng file JSON thô cho các ứng dụng lập trình.
Mã nguồn mở: Cộng đồng có thể đóng góp dữ liệu hoặc cải thiện giao diện.
Demo
Truy cập ứng dụng tại:
https://xuanphao19.github.io/VNGeoData/
Nhật ký thay đổi
Truy cập dữ liệu JSON
Dữ liệu hành chính được lưu trữ tại:
https://raw.githubusercontent.com/xuanphao19/VNGeoData/main/docs/data/administrativeUnits.json
Ví dụ sử dụng JSON:
fetch('https://raw.githubusercontent.com/xuanphao19/VNGeoData/main/docs/data/administrativeUnits.json')
.then(response => response.json())
.then(data => console.log(data));
Hướng dẫn sử dụng
1. Giao diện web
2. Truy cập JSON thô
Nguồn dữ liệu
Dữ liệu trong src/data/administrativeUnits.json hiện là mẫu. Để sử dụng dữ liệu thực tế, hãy thay thế bằng danh sách chính thức (34 tỉnh/thành, 3.321 xã/phường) từ các nguồn như Tổng cục Thống kê Việt Nam hoặc Bộ Nông nghiệp và Môi trường.
Cài đặt cục bộ
Clone repository:
git clone https://github.com/xuanphao19/VNGeoData.git
Mở file docs/index.html trong trình duyệt để kiểm tra giao diện.
Đóng góp
Chúng tôi hoan nghênh mọi đóng góp từ cộng đồng! Để đóng góp:
Fork repository này.
Tạo một branch mới:
git checkout -b feature-branch
Commit thay đổi:
git commit -m 'Thêm tính năng mới'
Đẩy branch lên:
git push origin feature-branch
Tạo Pull Request trên GitHub.
Gợi ý đóng góp
Cập nhật dữ liệu hành chính thực tế trong administrativeUnits.json.
Thêm tính năng tìm kiếm xã/phường theo tên.
Cải thiện giao diện hoặc thêm bản đồ.
Giấy phép
Dự án được cấp phép theo MIT License. Xem file LICENSE để biết thêm chi tiết.
Liên hệ
Nếu có câu hỏi hoặc đề xuất, hãy:
VNGeoData được xây dựng để hỗ trợ cộng đồng tra cứu đơn vị hành chính mới của Việt Nam. Hãy cùng nhau hoàn thiện dự án này!