Dữ liệu mở đơn vị hành chính Việt Nam (CSV, JSON)
Cập nhật lần cuối: · Dữ liệu theo văn bản đến 20/09/2026
Tải miễn phí danh mục 34 tỉnh, thành phố và 3.321 xã, phường, đặc khu sau sắp xếp năm 2025, kèm mã đơn vị hành chính, mã bưu chính và bảng đối chiếu xã cũ sang xã mới. Dùng cho phần mềm kế toán, bán hàng, biểu mẫu địa chỉ, nghiên cứu. Giấy phép CC BY 4.0: dùng tự do, kể cả mục đích thương mại, chỉ cần ghi nguồn Địa Chỉ Việt.
Tải về
| Bảng | Nội dung | Số dòng | Tải về |
|---|---|---|---|
| Tỉnh, thành phố | 34 tỉnh, thành phố từ 01/07/2025: mã, tên. | 34 | CSV 3 KB JSON 6 KB |
| Xã, phường, đặc khu | 3.321 đơn vị cấp xã: mã, tên, loại, tỉnh, mã bưu chính, diện tích, quy mô dân số, nghị quyết căn cứ. | 3.321 | CSV 552 KB JSON 942 KB |
| Bảng xã cũ → xã mới | Đơn vị cấp xã trước 01/07/2025 và đơn vị mới tương ứng, ghi rõ trường hợp chỉ một phần địa bàn. | 10.608 | CSV 1,3 MB JSON 2,4 MB |
Ngày tạo file: · dữ liệu theo văn bản có hiệu lực đến 20/09/2026 · giay-phep.txt (giấy phép, nguồn gốc dữ liệu).
Các cột dữ liệu
ma_tinh, ma_xa- Mã đơn vị hành chính theo Quyết định 19/2025/QĐ-TTg: tỉnh 2 chữ số, xã 5 chữ số. Đây là chuỗi, giữ nguyên số 0 ở đầu ("00004").
loai- Xã, Phường hoặc Đặc khu (bảng xã); Tỉnh hoặc Thành phố (bảng tỉnh).
ma_buu_chinh- Mã bưu chính 5 số theo Quyết định 2334/QĐ-BKHCN.
dien_tich_km2, quy_mo_dan_so- Diện tích (km²) và quy mô dân số ghi trong nghị quyết sắp xếp năm 2025 của Ủy ban Thường vụ Quốc hội. Quy mô dân số là số liệu của đề án, không phải số điều tra dân số. Ô trống: chưa có số liệu.
nghi_quyet- Nghị quyết căn cứ thành lập đơn vị (năm 2025).
ma_xa_cu, ten_xa_cu, quan_huyen_cu, tinh_cu- Đơn vị cấp xã trước 01/07/2025 theo danh mục bản 01/03/2025. Mã và quận, huyện để trống khi chưa xác định chắc chắn.
pham_vi- "toàn bộ" hoặc ghi chú như "một phần", "phần còn lại": đơn vị cũ bị chia cho nhiều đơn vị mới thì có nhiều dòng.
url- Trang tra cứu tương ứng trên Địa Chỉ Việt.
Cách dùng
- Excel: vào Data → From Text/CSV, chọn file, mã hoá UTF-8; ở bước chỉnh kiểu dữ liệu, đặt các cột mã là Text để không mất số 0 ở đầu. Mở trực tiếp bằng cách bấm đúp vẫn đúng tiếng Việt (file có BOM) nhưng Excel có thể đổi "00004" thành 4.
- Google Sheets: File → Import → Upload, bỏ chọn "Convert text to numbers, dates" để giữ nguyên mã.
- Lập trình: file JSON có dạng
{"cot": [...], "dong": [{...}]}. Ví dụ Python:json.load(open("xa.json", encoding="utf-8"))["dong"]. Nên nối các bảng bằng mã (ma_xa,ma_tinh), không nối bằng tên vì có nhiều xã trùng tên. - Cập nhật: khi có nghị quyết mới (xã lên phường, sắp xếp lại), file được tạo lại và ngày tạo file thay đổi. Danh sách thay đổi xem ở trang thay đổi đơn vị hành chính sau 01/07/2025.
Giấy phép và ghi nguồn
Phần tổng hợp, chuẩn hoá và đối chiếu của Địa Chỉ Việt được cấp phép Creative Commons Ghi công 4.0 Quốc tế (CC BY 4.0). Bạn được sao chép, phân phối, chỉnh sửa, dùng cho mục đích thương mại, với điều kiện ghi nguồn. Mẫu ghi nguồn:
Nguồn: Địa Chỉ Việt (diachiviet.com), dữ liệu mở đơn vị hành chính, CC BY 4.0Nguồn gốc dữ liệu:
- Danh mục, mã số đơn vị hành chính: Quyết định 19/2025/QĐ-TTg, các công văn cập nhật của Cục Thống kê và các nghị quyết sắp xếp đơn vị hành chính của Quốc hội, Ủy ban Thường vụ Quốc hội.
- Mã bưu chính: Quyết định 2334/QĐ-BKHCN của Bộ Khoa học và Công nghệ.
- Diện tích, quy mô dân số: số liệu trong các nghị quyết sắp xếp đơn vị hành chính cấp xã năm 2025 (tổng hợp qua sapnhap.bando.com.vn).
- Danh mục trước 01/07/2025: thanglequoc/vietnamese-provinces-database (giấy phép MIT; nguyên văn giấy phép kèm trong giay-phep.txt).
Văn bản quy phạm pháp luật và văn bản hành chính không thuộc đối tượng bảo hộ quyền tác giả (Điều 15 Luật Sở hữu trí tuệ). Phương pháp tổng hợp và giới hạn của dữ liệu: Nguồn dữ liệu và phương pháp.
Công cụ
- Đổi địa chỉ cũ sang mớiDán một địa chỉ đầy đủ kiểu cũ, nhận địa chỉ mới để sao chép.
- Chuyển đổi địa chỉ hàng loạtTối đa 100 địa chỉ hoặc file CSV, TXT; tải kết quả về file CSV.
- Mã bưu chính 34 tỉnh, thànhTìm mã bưu chính 5 số của xã, phường mới; đầu mã từng tỉnh.
- Mã tỉnh, mã xã thi tốt nghiệp THPTTra mã tỉnh 2 số, mã xã 5 số theo danh mục mới để khai hồ sơ đăng ký dự thi.
- Danh sách 34 tỉnh, thànhXã, phường mới và đơn vị cũ của từng tỉnh, thành.
Câu hỏi thường gặp
Dữ liệu có miễn phí, dùng cho phần mềm thương mại được không?
Có. Dữ liệu cấp phép CC BY 4.0: dùng miễn phí, kể cả trong sản phẩm thương mại, chỉ cần ghi nguồn Địa Chỉ Việt (diachiviet.com) ở nơi người dùng thấy được, ví dụ trang giới thiệu hoặc chân trang.
Bao lâu dữ liệu được cập nhật?
File được tạo lại khi danh mục trên trang thay đổi, ví dụ khi có nghị quyết thành lập phường hoặc sắp xếp lại đơn vị hành chính. Ngày tạo file ghi ngay dưới bảng tải về.
Vì sao một xã cũ có nhiều dòng trong bảng xã cũ → mới?
Một số xã, phường cũ được chia cho hai hoặc nhiều đơn vị mới. Mỗi đơn vị mới là một dòng, cột pham_vi ghi "một phần" hoặc "phần còn lại".
Dữ liệu có phải bản chính thức của cơ quan nhà nước không?
Không. Đây là dữ liệu tổng hợp từ văn bản nhà nước để tiện tra cứu, có thể có sai sót. Khi cần căn cứ pháp lý, hãy đối chiếu văn bản gốc. Phát hiện sai sót, vui lòng báo qua trang Liên hệ.
Dữ liệu theo văn bản có hiệu lực đến 20/09/2026.
