Chuyển đổi địa chỉ cũ sang địa chỉ mới sau sáp nhập 2025

Tách địa chỉ tự do thành số nhà, đường, phường xã, tỉnh và tự đổi địa chỉ cũ 3 cấp (có quận/huyện) sang đơn vị 2 cấp mới từ 2025.

Kết quả

Bấm “Chạy” để xem kết quả.

API chuẩn hoá địa chỉ đọc địa chỉ theo cách người dùng thường gõ: 123 Lê Lợi, P. Bến Thành, Q.1, TP.HCM, 45/2 Nguyễn Trãi, Phường 2, Quận 5, thon 3, xa ea tieu, huyen cu kuin, dak lak (không dấu) hay dạng mới Số 5 ngõ 10 phố Huế, Phường Hai Bà Trưng, Hà Nội. API nhận các cách viết tắt (P., Q., TX., TT., TP., P3, Q10), tên tỉnh cũ và mới cùng các tên gọi khác như HCM, Sài Gòn, và tách số nhà khỏi tên đường.

Kết quả là đơn vị hiện hành: từ 1/7/2025 không còn cấp huyện, nên địa chỉ cũ được chuyển đổi theo bảng chuyển đổi chính thức của Cục Thống kê: Phường 2, Quận 5 thành Phường Chợ Quán, TP. Hồ Chí Minh; Phường Phú Cường, TP. Thủ Dầu Một, Bình Dương thành Phường Thủ Dầu Một, TP. Hồ Chí Minh. Phản hồi có phường xã và tỉnh mới kèm mã, mã bưu chính, full_address để in ngay và, với địa chỉ đã chuyển đổi, đơn vị cũ trong converted_from.

Khi một phường xã cũ bị chia cho nhiều đơn vị mới, ambiguous là true và candidates liệt kê các khả năng. Gửi tối đa 100 địa chỉ một lần bằng POST { "addresses": [...] }. Dữ liệu dùng chung với API tỉnh thành Việt Nam và cập nhật theo các nghị quyết sau đó.

Dùng trong code của bạn

curl "https://apibox.io.vn/v1/address-parse?address=123 Lê Lợi, P. Bến Thành, Q.1, TP.HCM" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/address-parse?address=123 Lê Lợi, P. Bến Thành, Q.1, TP.HCM', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://apibox.io.vn/v1/address-parse?address=123 Lê Lợi, P. Bến Thành, Q.1, TP.HCM",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/address-parse?address=123 Lê Lợi, P. Bến Thành, Q.1, TP.HCM');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Tài liệu API → Nhận API key miễn phí

Hỏi đáp

Gõ không dấu có được không?

Được: tên, tiền tố và chữ viết tắt được so khớp không phân biệt dấu, hoa thường, ví dụ "p3, q10, hcm" hay "xa ea tieu, huyen cu kuin, dak lak".

Phường cũ không còn thì sao?

Một số phường đã sáp nhập trước 2025 hoặc bị chia năm 2025. matched là false khi không khớp, ambiguous kèm candidates khi có nhiều đơn vị mới; tên đường sẽ quyết định.

API có kiểm tra tên đường không?

Không. Tên đường và số nhà được giữ nguyên như nhập; chỉ các đơn vị hành chính được kiểm tra và chuyển đổi.