Sáp nhập 34 tỉnh thành 2025: Hướng dẫn chuẩn hóa địa chỉ cũ → mới bằng API

Năm 2025, Việt Nam thực hiện đợt sắp xếp đơn vị hành chính lớn nhất trong nhiều thập kỷ: từ 63 tỉnh thành rút xuống còn 34. Với người dùng cuối, đây là chuyện hành chính. Nhưng với lập trình viên, đây là một cơn đau dữ liệu: hàng triệu địa chỉ trong database vẫn mang tên tỉnh/huyện/xã cũ, trong khi hệ thống mới, đối tác và khách hàng dần chuyển sang tên mới.

Bài viết này giải thích bối cảnh, tác động lên hệ thống phần mềm, và cách chuẩn hóa địa chỉ cũ → mới bằng API một cách thực dụng.

Bối cảnh: 63 → 34 đơn vị hành chính cấp tỉnh

Theo Nghị quyết về sắp xếp đơn vị hành chính cấp tỉnh năm 2025 (Nghị quyết 202), Quốc hội thông qua ngày 12/6/2025, cả nước còn 34 đơn vị hành chính cấp tỉnh: 28 tỉnh và 6 thành phố trực thuộc Trung ương. Trong đó có 23 đơn vị hình thành sau sáp nhập và 11 đơn vị giữ nguyên (gồm Hà Nội, Huế và một số tỉnh như Cao Bằng, Điện Biên, Hà Tĩnh, Lạng Sơn, Nghệ An, Quảng Ninh, Thanh Hóa, Sơn La, Lai Châu).

Chính quyền các tỉnh/thành mới chính thức vận hành từ 1/7/2025. Song song, mô hình hành chính cũng chuyển dần về 2 cấp (tỉnh – xã/phường) ở nhiều nơi, kéo theo việc đổi tên và sắp xếp lại hàng nghìn phường/xã.

Mốc cần nhớ: 12/6/2025 thông qua, 1/7/2025 vận hành. Mọi bộ dữ liệu địa chỉ tạo trước thời điểm này cần được rà soát.

Vì sao đây là vấn đề của lập trình viên

Nếu hệ thống của bạn lưu địa chỉ dạng chuỗi tự do hoặc gắn cứng tên tỉnh/huyện, đợt sáp nhập gây ra hàng loạt hệ quả:

• Logistics & giao hàng: địa chỉ cũ không khớp tuyến/khu vực mới → giao sai, chậm, tăng tỷ lệ giao hỏng.
• Thương mại điện tử: form checkout dùng dropdown tỉnh/huyện cũ → khách không tìm thấy địa chỉ của mình, rớt đơn.
• CRM & phân tích: gom nhóm theo tỉnh/huyện bị lệch khi một phần dữ liệu dùng tên cũ, một phần tên mới.
• Báo cáo & bản đồ: thống kê theo địa giới sai lệch vì ranh giới đã thay đổi.

Cốt lõi: bạn cần một nguồn dữ liệu địa giới hành chính cập nhật và một cách map địa chỉ/tọa độ về đơn vị hành chính mới.

Hai bài toán cần giải

1. Địa chỉ cũ (dạng text) → đơn vị hành chính mới. Ví dụ một đơn hàng cũ ghi "huyện X, tỉnh Y" trong khi Y đã sáp nhập vào tỉnh Z.
2. Tọa độ (lat/lng) → tỉnh/huyện hiện hành. Khi bạn có điểm GPS (vị trí khách, tài xế, kho) và cần biết nó thuộc đơn vị hành chính mới nào.

Bài toán (2) đặc biệt mạnh, vì tọa độ không đổi khi ranh giới đổi tên — bạn luôn có thể reverse-geocode một điểm về đơn vị hành chính hiện hành, bất kể chuỗi địa chỉ cũ ghi gì.

Cách làm với GoGoDuk

GoGoDuk cung cấp dữ liệu ranh giới hành chính (tỉnh + huyện) đã cập nhật theo đợt sắp xếp, kèm reverse-geocode để map tọa độ về tỉnh/huyện hiện hành — miễn phí.

Bước 1 — Lấy danh mục đơn vị hành chính hiện hành

curl -H "X-API-Key: gdk_live_..." \
  "https://api.gogoduk.com/v1/admin-boundaries?levels=4,8&format=geojson"

Mỗi bản ghi cấp tỉnh kèm metadata hữu ích, trong đó có trường ghi chú về lần sắp xếp gần nhất:

{
  "admin_level_4": [
    {
      "name": "Tỉnh Lào Cai",
      "population": 1778785,
      "area_km2": 13256.92,
      "pre_merge_info": "tỉnh Yên Bái và tỉnh Lào Cai",
      "admin_center": "Yên Bái (cũ)",
      "centroid": [104.34738, 22.06048]
    }
  ]
}

Trường pre_merge_info cho bạn biết đơn vị nào đã gộp vào đơn vị nào — rất tiện để dựng bảng đối chiếu "tên cũ → tên mới".

Bước 2 — Map tọa độ về tỉnh/huyện hiện hành

Nếu bản ghi của bạn có tọa độ (hoặc bạn geocode được địa chỉ ra tọa độ trước), hãy reverse-geocode:

curl -H "X-API-Key: gdk_live_..." \
  "https://api.gogoduk.com/v1/reverse-geocode?lat=21.03&lng=105.85"

{ "lat": 21.03, "lng": 105.85, "city": "Hà Nội", "district": "Đống Đa" }

Kết quả luôn theo địa giới hiện hành trong dataset, nên đây là cách đáng tin cậy nhất để gắn một điểm về đúng đơn vị hành chính mới.

Bước 3 — Với địa chỉ chỉ có text

Nếu bạn chỉ có chuỗi địa chỉ (không có tọa độ), hãy geocode trước để lấy tọa độ, rồi reverse-geocode về đơn vị mới:

# 1) Địa chỉ -> gợi ý + tọa độ
curl -H "X-API-Key: gdk_live_..." \
  "https://api.gogoduk.com/v1/suggest?input=226+Van+Phuc+Ba+Dinh+Ha+Noi"

Lấy lat/lng của kết quả phù hợp, sau đó gọi /v1/reverse-geocode như Bước 2. Cách "đi qua tọa độ" này bền vững hơn so với so khớp chuỗi tên tỉnh/huyện cũ.

Checklist chuẩn hóa địa chỉ cho dev

• Tách trường: đừng lưu địa chỉ thành một chuỗi tự do duy nhất — tách tỉnh/huyện/xã + đường + số nhà.
• Lưu tọa độ: geocode và lưu lat/lng cho mỗi địa chỉ — đây là khóa bền vững khi ranh giới đổi tên.
• Dựng bảng đối chiếu tên cũ → tên mới (tận dụng pre_merge_info) cho phần dữ liệu chỉ có text.
• Cập nhật dropdown tỉnh/huyện/xã ở form theo danh mục mới (/v1/admin-boundaries).
• Chạy lại reverse-geocode cho dữ liệu lịch sử có tọa độ để gắn đơn vị hành chính hiện hành.
• Kiểm thử biên: các tỉnh/huyện bị sáp nhập và các trường hợp đổi tên phường/xã.

Câu hỏi thường gặp

Việt Nam còn bao nhiêu tỉnh thành sau sáp nhập 2025? Còn 34 đơn vị hành chính cấp tỉnh: 28 tỉnh và 6 thành phố trực thuộc Trung ương, vận hành chính thức từ 1/7/2025.

Làm sao chuyển địa chỉ cũ sang địa chỉ mới? Cách bền vững nhất là đi qua tọa độ: geocode địa chỉ ra lat/lng, rồi reverse-geocode về tỉnh/huyện hiện hành. Với dữ liệu chỉ có text, dựng bảng đối chiếu tên cũ → mới.

GoGoDuk có dữ liệu phường/xã mới chưa? Hiện /v1/admin-boundaries cung cấp cấp tỉnh + huyện đã cập nhật; ranh giới cấp phường/xã đang trong lộ trình. Theo dõi changelog.

Có mất phí không? Không. API ranh giới hành chính và reverse-geocode của GoGoDuk miễn phí — 100 request/ngày mỗi tài khoản, không cần thẻ.

Bắt đầu

Xem chi tiết dataset ranh giới hành chính trong bài Ranh giới hành chính Việt Nam, hoặc thử ngay:

curl -H "X-API-Key: gdk_live_..." \
  "https://api.gogoduk.com/v1/admin-boundaries?levels=4" | jq '.admin_level_4 | length'

Kết quả nên là 34. Đăng ký API key hoặc đọc tài liệu. Phát hiện ranh giới sai sau sáp nhập? Email [email protected] kèm tên đơn vị, chúng tôi sẽ kiểm tra.