Dữ liệu Việt Nam
vn/convert
Chuyển một địa chỉ theo địa giới CŨ (trước 01/7/2025
Còn ba cấp) sang đơn vị hành chính hiện hành: trả về phường/xã cũ đã nhận dạng được, các phường/xã mới tương ứng, cờ `certain` cho biết ánh xạ có phải một-một hay không, và câu địa chỉ mới gợi ý khi ánh xạ là một-một.
GET
https://api-tools.hitechcloud.vn/api/vn/convert
Đã chép
Cần khoá API
Tham số
q
string
·
truy vấn
Cả câu địa chỉ CŨ, ví dụ 12 Lê Lợi, Phường Bến Nghé, Quận 1, TP Hồ Chí Minh. Số nhà và tên đường được giữ nguyên trong địa chỉ mới gợi ý.
ward
string
·
truy vấn
Tên phường/xã CŨ khi đã tách sẵn. Ưu tiên hơn phần tách được từ q.
district
string
·
truy vấn
Tên quận/huyện CŨ. Không bắt buộc nhưng nên có: tên phường/xã trùng nhau rất nhiều, thiếu quận/huyện thì kết quả dễ nhập nhằng.
province
string
·
truy vấn
Tên tỉnh/thành CŨ (theo danh mục 63 tỉnh trước sáp nhập).
ward_code
integer
·
truy vấn
Mã phường/xã CŨ theo danh mục Cục Thống kê. Cách chính xác nhất — bỏ qua hoàn toàn bước đoán tên. Tra mã này tại GET api/vn/legacy/wards.
Mã trả về
200
Thành công.
401
Thiếu hoặc sai khoá API. Gửi kèm header
X-API-Key.
404
Không tìm thấy dữ liệu tương ứng.
429
Vượt hạn mức của khoá. Xem header
Retry-After.