Dữ liệu đơn vị hành chính thay đổi theo nghị quyết của Chính phủ. Để hệ thống tích hợp không bị lệch dữ
liệu giữa các lần cập nhật, các API Geocoding cho phép chọn một phiên bản dữ liệu cụ thể bằng tham số
data_version.
Các phiên bản đang phục vụ
data_version | Nội dung |
|---|
2025-07.r2 | Dữ liệu sau sáp nhập 2025, bản biên tập 2 — bản mới nhất. 2 cấp, 34 tỉnh/thành phố |
2025-07.r1 | Dữ liệu sau sáp nhập 2025, bản phát hành đầu. 2 cấp |
legacy | Dữ liệu trước sáp nhập 2025, còn cấp quận/huyện — mặc định khi không gửi data_version. 63 tỉnh/thành phố |
latest | Luôn trỏ tới bản mới nhất (hiện là 2025-07.r2). Kết quả echo mã cụ thể, không bao giờ echo latest |
Cách truyền
| Cách | Ví dụ |
|---|
| Query parameter | ?data_version=2025-07.r2 |
| Header | X-Data-Version: 2025-07.r2 |