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ảngNội dungSố dòngTải về
Tỉnh, thành phố34 tỉnh, thành phố từ 01/07/2025: mã, tên.34CSV 3 KB JSON 6 KB
Xã, phường, đặc khu3.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.321CSV 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.608CSV 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

  1. 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.
  2. Google Sheets: File → Import → Upload, bỏ chọn "Convert text to numbers, dates" để giữ nguyên mã.
  3. 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.
  4. 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.0

Nguồ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ụ

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.