Có gì mới trong GTEL MAPS API v1.1
Ngày phát hành: 06/07/2025 Phiên bản API: 1.1
GTEL MAPS API v1.1 cập nhật dữ liệu địa chỉ và đơn vị hành chính mới, bao gồm bản đồ nền raster và vector.
1. Nội dung cập nhật
Ngày cập nhật: 06/07/2025 Phiên bản API: 1.1
Nội dung:
- Cập nhật dữ liệu địa chỉ theo dữ liệu đơn vị hành chính mới.
- Cập nhật thông tin đơn vị hành chính mới.
- Cập nhật bản đồ nền (raster + vector) theo dữ liệu đơn vị hành chính mới.
2. Chi tiết bản cập nhật
2.1 Các API có ảnh hưởng
| STT | Tên API | Method | Endpoint | Ảnh hưởng |
|---|---|---|---|---|
| 1 | Reverse Geocoding | GET | {{API_BASE_URL}}/api/v1/reverse | Cập nhật dữ liệu địa chỉ theo dữ liệu đơn vị hành chính mới. |
| 2 | Forward Geocoding | GET | {{API_BASE_URL}}/api/v1/search | Cập nhật dữ liệu địa chỉ theo dữ liệu đơn vị hành chính mới. |
| 3 | Autocomplete | GET | {{API_BASE_URL}}/api/v1/autocomplete | Cập nhật dữ liệu địa chỉ theo dữ liệu đơn vị hành chính mới. |
| 4 | Place Detail | GET | {{API_BASE_URL}}/api/v1/place | Cập nhật dữ liệu địa chỉ theo dữ liệu đơn vị hành chính mới. |
| 5 | Nearby Search | GET | {{API_BASE_URL}}/api/place/nearby-search | Cập nhật dữ liệu địa chỉ theo dữ liệu đơn vị hành chính mới. |
| 6 | API Admin Unit - Region | GET | {{API_BASE_URL}}/api/admin-unit/provinces | Cập nhật thông tin đơn vị hành chính mới. |
| 7 | API Admin Unit - Region | GET | {{API_BASE_URL}}/api/admin-unit/provinces/{code} | Cập nhật thông tin đơn vị hành chính mới. |
| 8 | API Admin Unit - Ward | GET | {{API_BASE_URL}}/api/admin-unit/wards | Cập nhật thông tin đơn vị hành chính mới. |
| 9 | API Admin Unit - Ward | GET | {{API_BASE_URL}}/api/admin-unit/wards/{code} | Cập nhật thông tin đơn vị hành chính mới. |
| 10 | Raster Tiles | GET | {{API_BASE_URL}}/api/v1/tiles/{name}/{z}/{x}/{y}.png | Cập nhật bản đồ raster nền theo dữ liệu đơn vị hành chính mới. |
| 11 | Vector Tile - Style | GET | {{API_BASE_URL}}/api/styles/v1/{style-id} | Cập nhật bản đồ vector theo dữ liệu đơn vị hành chính mới. |
| 12 | Vector Tile - Tiles | GET | {{API_BASE_URL}}/api/tiles/v1/{tile-id} | Cập nhật bản đồ vector theo dữ liệu đơn vị hành chính mới. |
2.2 Chi tiết bản cập nhật
2.2.1 Bộ API địa chỉ /api/v1/reverse, /api/v1/search, /api/v1/autocomplete, /api/v1/place, /api/place/nearby-search
Request:
| Thay đổi request | Mô tả |
|---|---|
Bổ sung app-version:1.1 ở header | - Để lấy thông tin địa chỉ theo đơn vị hành chính mới. - Nếu không truyền thì sẽ lấy thông tin địa chỉ theo đơn vị hành chính cũ. |
| Các tham số khác không thay đổi | - Tất cả parameters hiện tại vẫn hoạt động bình thường. |
Response:
| Thay đổi response | Mô tả |
|---|---|
Bổ sung trường is_deprecated: true | - Đối với các địa chỉ chưa được cập nhật theo đơn vị hành chính mới. |
| Các trường khác không thay đổi | - Tất cả các trường hiện tại vẫn hoạt động bình thường. |
2.2.2 Bộ API lấy thông tin tỉnh/thành phố đơn vị hành chính /api/admin-unit/provinces, /api/admin-unit/provinces/{id}
Request:
| Thay đổi request | Mô tả |
|---|---|
Bổ sung app-version:1.1 ở header | - Để lấy thông tin đơn vị hành chính mới. - Nếu không truyền thì sẽ lấy thông tin đơn vị hành chính cũ. |
| Các tham số khác không thay đổi | - Tất cả parameters hiện tại vẫn hoạt động bình thường. |
Response:
| Thay đổi response | Mô tả |
|---|---|
| Cấu trúc không thay đổi | - Trả về thông tin đơn vị hành chính mới. |
2.2.3 API lấy thông tin danh sách phường xã /api/admin-unit/wards
Request:
| Thay đổi request | Mô tả |
|---|---|
Bổ sung app-version:1.1 ở header | - Để lấy thông tin đơn vị hành chính mới. - Nếu không truyền thì sẽ lấy thông tin đơn vị hành chính cũ. |
Bổ sung prov_code ở query string | - Để lấy danh sách phường/xã theo tỉnh/thành phố cụ thể. |
Bỏ param dist_code ở query string | - dist_code là mã quận/huyện, không còn sử dụng trong API này. |
Response:
| Thay đổi response | Mô tả |
|---|---|
| Cấu trúc không thay đổi | - Trả về danh sách phường xã theo tỉnh thành mới. |
2.2.4 API lấy thông tin chi tiết phường xã /api/admin-unit/wards/{id}
Request:
| Thay đổi request | Mô tả |
|---|---|
Bổ sung app-version:1.1 ở header | - Để lấy thông tin đơn vị hành chính mới. - Nếu không truyền thì sẽ lấy thông tin đơn vị hành chính cũ. |
| Các tham số khác không thay đổi | - Tất cả parameters hiện tại vẫn hoạt động bình thường. |
Response:
| Thay đổi response | Mô tả |
|---|---|
| Cấu trúc không thay đổi | - Trả về thông tin chi tiết phường xã mới. |
2.2.5 Bộ API lấy bản đồ raster /api/v1/tiles/{name}/{z}/{x}/{y}.png
Request:
| Thay đổi request | Mô tả |
|---|---|
| Cấu trúc không thay đổi | - Không có thay đổi về request parameters hoặc format. |
Response:
| Thay đổi response | Mô tả |
|---|---|
| Cấu trúc không thay đổi | - Trả về bản đồ raster nền theo dữ liệu đơn vị hành chính mới. |
2.2.6 Bộ API lấy bản đồ vector /api/styles/v1/{style-id}, /api/tiles/v1/{tile-id}
Request:
| Thay đổi request | Mô tả |
|---|---|
| Cấu trúc không thay đổi | - Không có thay đổi về request parameters hoặc format. |
Response:
| Thay đổi response | Mô tả |
|---|---|
| Cấu trúc không thay đổi | - Trả về bản đồ vector theo dữ liệu đơn vị hành chính mới. |
🔗 Tài nguyên
- Tài liệu API v1.1 - Tham khảo API đầy đủ
- Tài liệu API v1.0 - Phiên bản trước
- Administrative API - API hành chính
- Geocoding API - API geocoding
Chúc bạn coding vui vẻ với GTEL MAPS API v1.1! 🚀