﻿# Dữ liệu mở đơn vị hành chính Việt Nam

Địa Chỉ Việt (diachiviet.com). Trang tải về: https://diachiviet.com/du-lieu-mo/

- Ngày dựng: 2026-11-05
- Dữ liệu theo văn bản có hiệu lực đến: 20/09/2026
- Giấy phép: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/deed.vi)
- Mã hoá: UTF-8 có BOM, phân cách bằng dấu phẩy

## Các file

| File | Số dòng | Nội dung |
|---|---|---|
| tinh.csv, tinh.json | 34 | 34 tỉnh, thành phố từ 01/07/2025: mã, tên. |
| xa.csv, xa.json | 3321 | 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ứ. |
| xa-cu-moi.csv, xa-cu-moi.json | 10618 | Đơ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. |
| xa-{tinh}.csv, xa-{tinh}.json | 34 + 34 file | Cùng cột với xa.csv, xa.json, mỗi file một tỉnh, thành. Danh sách ở cuối file này. |
| xa-cu-moi-{tinh}.json | 34 file | Các dòng của xa-cu-moi.json có `ma_tinh` (tỉnh mới) là tỉnh đó. |

## Dùng như API

Các file JSON gọi trực tiếp được (CORS mở, không cần khoá): https://diachiviet.com/api/v1/tinh.json, https://diachiviet.com/api/v1/xa/{tinh}.json, https://diachiviet.com/api/v1/xa-cu-moi/{tinh}.json. Hướng dẫn: https://diachiviet.com/api-tinh-thanh/

## Các cột

### tinh.csv, tinh.json

- `ma_tinh`: Mã tỉnh 2 chữ số theo Quyết định 19/2025/QĐ-TTg (chuỗi, giữ số 0 ở đầu).
- `ten`: Tên đơn vị.
- `ten_day_du`: Tên đầy đủ, có "Tỉnh" hoặc "Thành phố".
- `loai`: Bảng tỉnh: Tỉnh hoặc Thành phố. Bảng xã: Xã, Phường hoặc Đặc khu.
- `so_don_vi_cap_xa`: Số đơn vị cấp xã của tỉnh.
- `url`: Trang tra cứu tương ứng trên Địa Chỉ Việt.

### xa.csv, xa.json, xa-{tinh}.csv, xa-{tinh}.json

- `ma_xa`: Mã xã 5 chữ số theo Quyết định 19/2025/QĐ-TTg (chuỗi, giữ số 0 ở đầu, ví dụ "00004").
- `ten`: Tên đơn vị.
- `loai`: Bảng tỉnh: Tỉnh hoặc Thành phố. Bảng xã: Xã, Phường hoặc Đặc khu.
- `ma_tinh`: Mã tỉnh 2 chữ số theo Quyết định 19/2025/QĐ-TTg (chuỗi, giữ số 0 ở đầu).
- `ten_tinh`: Tên đầy đủ của tỉnh, thành phố.
- `ma_buu_chinh`: Mã bưu chính 5 số theo Quyết định 2334/QĐ-BKHCN.
- `dien_tich_km2`: Diện tích (km²) ghi trong nghị quyết sắp xếp năm 2025. Ô trống: chưa có số liệu.
- `quy_mo_dan_so`: Quy mô dân số ghi trong nghị quyết sắp xếp năm 2025; 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).
- `url`: Trang tra cứu tương ứng trên Địa Chỉ Việt.

### xa-cu-moi.csv, xa-cu-moi.json, xa-cu-moi-{tinh}.json

- `ma_xa_cu`: Mã đơn vị cấp xã trước 01/07/2025, danh mục bản 01/03/2025. Trống khi chưa xác định chắc chắn.
- `ten_xa_cu`: Tên đơn vị cấp xã trước 01/07/2025, theo nghị quyết sắp xếp năm 2025.
- `quan_huyen_cu`: Quận, huyện cũ. Trống khi chưa xác định chắc chắn.
- `tinh_cu`: Tỉnh, thành cũ.
- `ma_xa_moi`: Mã xã mới.
- `ten_xa_moi`: Tên xã mới.
- `ma_tinh`: Mã tỉnh 2 chữ số theo Quyết định 19/2025/QĐ-TTg (chuỗi, giữ số 0 ở đầu).
- `ten_tinh`: Tên đầy đủ của tỉnh, thành phố.
- `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.
- `ten_danh_muc_cu`: Tên trong danh mục bản 01/03/2025 khi khác cột ten_xa_cu (cách viết khác), dùng để đối chiếu, tìm kiếm. Trống khi giống nhau hoặc chưa xác định.

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.

## Nguồn

- Danh mục và mã số đơn vị hành chính: Quyết định 19/2025/QĐ-TTg và các văn bản cập nhật của Cục Thống kê; 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 ngày 24/08/2025 của Bộ Khoa học và Công nghệ.
- Diện tích, quy mô dân số cấp xã: 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 của Ủy ban Thường vụ Quốc hội (tổng hợp qua sapnhap.bando.com.vn). Quy mô dân số là số liệu của đề án sắp xếp, không phải số điều tra dân số.
- Danh mục đơn vị hành chính trước 01/07/2025 (bản 01/03/2025): thanglequoc/vietnamese-provinces-database (giấy phép MIT, nguyên văn trong giay-phep.txt), theo danh mục của Tổng cục Thống kê.

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ệ).

## 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ấp phép CC BY 4.0: dùng tự do, kể cả 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 - https://diachiviet.com/du-lieu-mo/

Toàn văn giấy phép, gồm giấy phép MIT của danh mục cũ: giay-phep.txt.

Dữ liệu tham khảo, có thể có sai sót. Giấy tờ chính thức theo xác nhận của cơ quan có thẩm quyền. Báo lỗi: https://diachiviet.com/lien-he/

## File theo tỉnh, thành

- xa-an-giang.csv, xa-an-giang.json, xa-cu-moi-an-giang.json: An Giang (mã 91, 102 đơn vị, 299 dòng cũ → mới)
- xa-bac-ninh.csv, xa-bac-ninh.json, xa-cu-moi-bac-ninh.json: Bắc Ninh (mã 24, 99 đơn vị, 324 dòng cũ → mới)
- xa-ca-mau.csv, xa-ca-mau.json, xa-cu-moi-ca-mau.json: Cà Mau (mã 96, 64 đơn vị, 186 dòng cũ → mới)
- xa-can-tho.csv, xa-can-tho.json, xa-cu-moi-can-tho.json: Cần Thơ (mã 92, 103 đơn vị, 266 dòng cũ → mới)
- xa-cao-bang.csv, xa-cao-bang.json, xa-cu-moi-cao-bang.json: Cao Bằng (mã 04, 56 đơn vị, 161 dòng cũ → mới)
- xa-da-nang.csv, xa-da-nang.json, xa-cu-moi-da-nang.json: Đà Nẵng (mã 48, 94 đơn vị, 282 dòng cũ → mới)
- xa-dak-lak.csv, xa-dak-lak.json, xa-cu-moi-dak-lak.json: Đắk Lắk (mã 66, 102 đơn vị, 294 dòng cũ → mới)
- xa-dien-bien.csv, xa-dien-bien.json, xa-cu-moi-dien-bien.json: Điện Biên (mã 11, 45 đơn vị, 129 dòng cũ → mới)
- xa-dong-nai.csv, xa-dong-nai.json, xa-cu-moi-dong-nai.json: Đồng Nai (mã 75, 95 đơn vị, 282 dòng cũ → mới)
- xa-dong-thap.csv, xa-dong-thap.json, xa-cu-moi-dong-thap.json: Đồng Tháp (mã 82, 102 đơn vị, 310 dòng cũ → mới)
- xa-gia-lai.csv, xa-gia-lai.json, xa-cu-moi-gia-lai.json: Gia Lai (mã 52, 135 đơn vị, 377 dòng cũ → mới)
- xa-ha-noi.csv, xa-ha-noi.json, xa-cu-moi-ha-noi.json: Hà Nội (mã 01, 126 đơn vị, 795 dòng cũ → mới)
- xa-ha-tinh.csv, xa-ha-tinh.json, xa-cu-moi-ha-tinh.json: Hà Tĩnh (mã 42, 69 đơn vị, 212 dòng cũ → mới)
- xa-hai-phong.csv, xa-hai-phong.json, xa-cu-moi-hai-phong.json: Hải Phòng (mã 31, 114 đơn vị, 457 dòng cũ → mới)
- xa-hue.csv, xa-hue.json, xa-cu-moi-hue.json: Huế (mã 46, 40 đơn vị, 133 dòng cũ → mới)
- xa-hung-yen.csv, xa-hung-yen.json, xa-cu-moi-hung-yen.json: Hưng Yên (mã 33, 104 đơn vị, 384 dòng cũ → mới)
- xa-khanh-hoa.csv, xa-khanh-hoa.json, xa-cu-moi-khanh-hoa.json: Khánh Hòa (mã 56, 65 đơn vị, 205 dòng cũ → mới)
- xa-lai-chau.csv, xa-lai-chau.json, xa-cu-moi-lai-chau.json: Lai Châu (mã 12, 38 đơn vị, 106 dòng cũ → mới)
- xa-lam-dong.csv, xa-lam-dong.json, xa-cu-moi-lam-dong.json: Lâm Đồng (mã 68, 124 đơn vị, 331 dòng cũ → mới)
- xa-lang-son.csv, xa-lang-son.json, xa-cu-moi-lang-son.json: Lạng Sơn (mã 20, 65 đơn vị, 196 dòng cũ → mới)
- xa-lao-cai.csv, xa-lao-cai.json, xa-cu-moi-lao-cai.json: Lào Cai (mã 15, 99 đơn vị, 319 dòng cũ → mới)
- xa-nghe-an.csv, xa-nghe-an.json, xa-cu-moi-nghe-an.json: Nghệ An (mã 40, 130 đơn vị, 412 dòng cũ → mới)
- xa-ninh-binh.csv, xa-ninh-binh.json, xa-cu-moi-ninh-binh.json: Ninh Bình (mã 37, 129 đơn vị, 405 dòng cũ → mới)
- xa-phu-tho.csv, xa-phu-tho.json, xa-cu-moi-phu-tho.json: Phú Thọ (mã 25, 148 đơn vị, 482 dòng cũ → mới)
- xa-quang-ngai.csv, xa-quang-ngai.json, xa-cu-moi-quang-ngai.json: Quảng Ngãi (mã 51, 96 đơn vị, 280 dòng cũ → mới)
- xa-quang-ninh.csv, xa-quang-ninh.json, xa-cu-moi-quang-ninh.json: Quảng Ninh (mã 22, 54 đơn vị, 185 dòng cũ → mới)
- xa-quang-tri.csv, xa-quang-tri.json, xa-cu-moi-quang-tri.json: Quảng Trị (mã 44, 78 đơn vị, 265 dòng cũ → mới)
- xa-son-la.csv, xa-son-la.json, xa-cu-moi-son-la.json: Sơn La (mã 14, 75 đơn vị, 200 dòng cũ → mới)
- xa-tay-ninh.csv, xa-tay-ninh.json, xa-cu-moi-tay-ninh.json: Tây Ninh (mã 80, 96 đơn vị, 308 dòng cũ → mới)
- xa-thai-nguyen.csv, xa-thai-nguyen.json, xa-cu-moi-thai-nguyen.json: Thái Nguyên (mã 19, 92 đơn vị, 285 dòng cũ → mới)
- xa-thanh-hoa.csv, xa-thanh-hoa.json, xa-cu-moi-thanh-hoa.json: Thanh Hóa (mã 38, 166 đơn vị, 561 dòng cũ → mới)
- xa-ho-chi-minh.csv, xa-ho-chi-minh.json, xa-cu-moi-ho-chi-minh.json: TP. Hồ Chí Minh (mã 79, 168 đơn vị, 493 dòng cũ → mới)
- xa-tuyen-quang.csv, xa-tuyen-quang.json, xa-cu-moi-tuyen-quang.json: Tuyên Quang (mã 08, 124 đơn vị, 335 dòng cũ → mới)
- xa-vinh-long.csv, xa-vinh-long.json, xa-cu-moi-vinh-long.json: Vĩnh Long (mã 86, 124 đơn vị, 359 dòng cũ → mới)
