gmapĐiều gì đã thay đổi
Từ ngày 01/07/2025, chính quyền địa phương vận hành theo mô hình hai cấp: 34 tỉnh, thành phố trực thuộc trung ương và cấp xã (xã, phường, đặc khu). Cấp huyện không còn, nhiều tỉnh và xã được hợp nhất.
| Mô hình cũ | Mô hình mới | |
|---|---|---|
| Số tỉnh, thành phố | 63 | 34 |
| Cấp hành chính trong địa chỉ | 3 (tỉnh – huyện – xã) | 2 (tỉnh – xã) |
| Tên trong API GMap | GADM63, addr63, poi63 | GADM34, addr34, poi34 |
Vì sao không nên đổi tên theo bảng tra
Một xã cũ có thể được chia vào nhiều đơn vị mới, và tên đường giống nhau xuất hiện ở nhiều nơi. Thay chuỗi theo bảng tên dễ gán sai đơn vị. Cách chắc chắn hơn là xác định vị trí trước, rồi tra đơn vị hành chính tại vị trí đó theo từng mô hình.
Đối chiếu bằng tọa độ
- Tìm tọa độ của địa chỉ bằng API tìm kiếm (hoặc dùng tọa độ đã lưu).
- Gọi API tra cứu ngược tại tọa độ đó với subtype=addr34 và subtype=addr63.
- Lưu cả hai nhãn địa chỉ cùng tọa độ; đánh dấu bản ghi chỉ có một cách ghi để kiểm tra lại.
# Địa chỉ theo 34 tỉnh (2 cấp)
curl 'https://cloud.gmap.vn/api/idunn/v1/reverse/10.7769:106.7009?lang=vi&subtype=addr34' \
--header 'x-api-key: public-gmap-cloud-x-api-key-demo'
# Địa chỉ theo 63 tỉnh (3 cấp)
curl 'https://cloud.gmap.vn/api/idunn/v1/reverse/10.7769:106.7009?lang=vi&subtype=addr63' \
--header 'x-api-key: public-gmap-cloud-x-api-key-demo'| Mô hình | Địa chỉ trả về (API demo, 11/10/2026) |
|---|---|
| 63 tỉnh | 114 Đường Nguyễn Huệ, Phường Bến Nghé, Quận 1, Thành phố Hồ Chí Minh |
| 34 tỉnh | 114 Đường Nguyễn Huệ, Phường Sài Gòn, Thành phố Hồ Chí Minh |
Khi cập nhật dữ liệu
- Giữ địa chỉ cũ thay vì ghi đè: hồ sơ, hóa đơn, hợp đồng trước 01/07/2025 vẫn dùng địa chỉ cũ.
- Lưu tọa độ cùng địa chỉ để lần cập nhật sau không phải tìm lại vị trí.
- Tra cứu ngược trả về địa chỉ gần nhất tại tọa độ; với địa điểm lớn, kiểm tra khoảng cách trong phản hồi.
- Khóa demo có giới hạn lưu lượng; cập nhật số lượng lớn cần khóa được cấp cho ứng dụng.
