# tinhthanhpho.com

> Đơn vị hành chính Việt Nam trước và sau ngày 1/7/2025 (mô hình 2 cấp: 34 tỉnh/thành, xã/phường/đặc khu, không còn cấp huyện) và công cụ chuyển địa chỉ cũ sang địa chỉ mới. Vietnamese administrative units before and after 1 July 2025, with an old-to-new address converter.

Dữ liệu phiên bản 2026.10.8, cập nhật 06/10/2026. Mã đơn vị theo danh mục của Cục Thống kê; căn cứ là các nghị quyết của Quốc hội và Ủy ban Thường vụ Quốc hội. Khi trích dẫn, ghi nguồn "tinhthanhpho.com" kèm đường dẫn trang.

## Trang
- https://www.tinhthanhpho.com/{tỉnh}: một tỉnh/thành mới, ví dụ https://www.tinhthanhpho.com/tp-ho-chi-minh (khối "Tóm tắt nhanh", các tỉnh cũ hợp nhất, danh sách xã/phường)
- https://www.tinhthanhpho.com/{tỉnh}/{xã}: một xã/phường/đặc khu, ví dụ https://www.tinhthanhpho.com/tp-ho-chi-minh/phuong-sai-gon (hình thành từ các đơn vị cũ nào, toàn bộ hay một phần)
- Thêm `.json` vào cuối hai dạng đường dẫn trên để lấy cùng dữ liệu dạng JSON
- https://www.tinhthanhpho.com/en/…: bản tiếng Anh
- https://www.tinhthanhpho.com/llms-full.txt: danh sách đầy đủ các tỉnh và xã kèm đường dẫn
- https://www.tinhthanhpho.com/ma-vung-dien-thoai: mã vùng điện thoại cố định của 34 tỉnh/thành, kèm mã của từng tỉnh cũ (Công văn 2784/BKHCN-CVT); `?q=0219` tra ngược từ mã
- https://www.tinhthanhpho.com/bien-so-xe: ký hiệu biển số xe của 34 tỉnh/thành (Thông tư 51/2025/TT-BCA); `?q=51` tra ngược từ ký hiệu

## API
- https://www.tinhthanhpho.com/openapi.json: đặc tả OpenAPI
- GET https://www.tinhthanhpho.com/api/v1/new-provinces: tỉnh/thành mới; /api/v1/new-provinces/{mã}/wards: xã/phường của tỉnh
- GET https://www.tinhthanhpho.com/api/v1/merge-history/ward/{mã}: đơn vị cũ → mới
- GET https://www.tinhthanhpho.com/api/v1/suggest?q=…: gợi ý tìm kiếm (không dấu, viết tắt)
- POST https://www.tinhthanhpho.com/api/v1/convert/address: chuyển địa chỉ cũ (cần khoá API); trả `confidence` exact/check, `candidates` khi xã cũ bị chia

## Dữ liệu mở (CC BY 4.0)
- https://www.tinhthanhpho.com/data/provinces.csv · https://www.tinhthanhpho.com/data/provinces.json
- https://www.tinhthanhpho.com/data/wards.csv · https://www.tinhthanhpho.com/data/wards.json
- https://www.tinhthanhpho.com/data/ward-merge-history.csv · https://www.tinhthanhpho.com/data/ward-merge-history.json
- https://www.tinhthanhpho.com/data/provinces-legacy.csv · https://www.tinhthanhpho.com/data/provinces-legacy.json
- https://www.tinhthanhpho.com/data/districts-legacy.csv · https://www.tinhthanhpho.com/data/districts-legacy.json
- https://www.tinhthanhpho.com/data/wards-legacy.csv · https://www.tinhthanhpho.com/data/wards-legacy.json
- https://www.tinhthanhpho.com/data/provinces.geojson, https://www.tinhthanhpho.com/data/wards-79.geojson (ranh giới theo tỉnh, thay 79 bằng mã tỉnh)

## Nguồn
- sapnhap.bando.com.vn — NXB Tài nguyên Môi trường và Bản đồ Việt Nam
- Cục Thống kê (danhmuchanhchinh.nso.gov.vn)
- Nghị quyết 202/2025/QH15, 1654–1687/NQ-UBTVQH15 và các nghị quyết năm 2026 (vanban.chinhphu.vn)
- Ranh giới: thanglequoc/vietnamese-provinces-database (MIT), hình học gốc từ sapnhap.bando.com.vn
- Ranh giới 63 tỉnh cũ: Natural Earth (public domain); Hoàng Sa, Trường Sa từ thanglequoc/vietnamese-provinces-database
- Bộ Khoa học và Công nghệ — Công văn 2784/BKHCN-CVT; Thông tư 22/2014/TT-BTTTT
- Bộ Công an — Thông tư 51/2025/TT-BCA và Thông tư 79/2024/TT-BCA, Phụ lục số 02
- Cục Thống kê — Niên giám thống kê 2025
- Thống kê và Sở Tài chính các tỉnh, thành phố — báo cáo năm 2025
- Bộ Khoa học và Công nghệ — Quyết định 2334/QĐ-BKHCN; Quyết định 2475/QĐ-BTTTT