trackasia trackasia
Xem Bản Đồ

Bảng tin

Khám phá thông tin, tin tức và chương trình khuyến mãi mới nhất từ TrackAsia
Tìm hiểu thêm
image
11/07/2025

Cập nhật API địa giới hành chính: Hỗ trợ địa chỉ cũ & mới linh hoạt

Ngày 1/7/2025 đánh dấu một bước ngoặt lớn khi Việt Nam chính thức áp dụng địa giới hành chính mới, tinh gọn từ 63 xuống còn 34 tỉnh, thành. Đây không chỉ là thay đổi mang tính hành chính mà còn đặt ra những yêu cầu cấp thiết về việc cập nhật dữ liệu bản đồ, hệ thống định danh và địa chỉ trong các hệ thống công nghệ.

Để đồng hành cùng doanh nghiệp và nhà phát triển trong giai đoạn chuyển đổi này, TrackAsia Maps chính thức nâng cấp API với khả năng:

✅ Hỗ trợ tìm kiếm và hiển thị địa chỉ theo địa giới hành chính mới.

✅ Linh hoạt chuyển đổi, truy xuất song song cả địa chỉ cũ và mới.

✅ Tương thích ngược, không làm gián đoạn hệ thống đang triển khai.             
 

Cập nhật API: Chuyển từ v1 ➝ v2

 

Nếu bạn đang dùng trackasia-gl để hiển thị bản đồ, vui lòng cập nhật đoạn mã khởi tạo theo chuẩn mới:

Trước đây (v1):

var map = new trackasiagl.Map({             
  container: 'map',             
  style: 'https://maps.track-asia.com/styles/v1/streets.json?key=public_key',             
  center: { lat: 10.762622, lng: 106.660172 },             
  zoom: 6             
});

 

Hiện tại (v2):

var map = new trackasiagl.Map({             
  container: 'map',             
  style: 'https://maps.track-asia.com/styles/v2/streets.json?key=public_key',             
  center: { lat: 10.762622, lng: 106.660172 },             

  zoom: 6             
});

 

Lưu ý: v2 sử dụng tập bản đồ mới nhất, tương thích với địa giới hành chính sau ngày 1/7/2025.              
  
👉 Xem nhanh tích hợp tại đây: Tài liệu API của TrackAsia         

 

⚙️ Cách hoạt động

 

– Mặc định, API trả về địa chỉ theo địa giới hành chính cũ (trước ngày 1/7/2025) nhằm đảm bảo tính tương thích với hệ thống hiện tại.               

API search/autocomplete /place detail đã được cập nhật để hỗ trợ các đơn vị hành chính mới. Người dùng có thể dễ dàng điều chỉnh hành vi của API thông qua 2 tham số mới:

1. new_admin=true

Khi được thêm vào truy vấn, API sẽ trả về địa chỉ theo địa giới hành chính mới (đã cập nhật sau ngày 1/7/2025). Nếu không truyền tham số này, API sẽ mặc định sử dụng địa chỉ cũ để giữ tính tương thích ngược.

2. include_old_admin=true

Tham số này được dùng kết hợp với new_admin=true để API trả về song song cả địa chỉ mới và cũ. Địa chỉ cũ sẽ được thể hiện trong các trường bắt đầu bằng tiền tố old_*                

ví dụ:

  • old_formatted_address
  • old_address_components

Ví dụ 1: Truy vấn mặc định (địa giới cũ)

GET /api/v2/place/details/json?key=public&place_id=6:venue:184ea827-6691-5439-b6a2-abcc640c2cd4&lang=vi              
 


OUTPUT:

{                   
  "formatted_address": "336 Trương Công Định, Phường 8, Thành phố Vũng Tàu, Tỉnh Bà Rịa-Vũng Tàu",                   
  "address_components": [...],                   
}              
 
  • 
Đây là kết quả mặc định khi không truyền new_admin=true, hệ thống sẽ dùng địa giới cũ để đảm bảo tính tương thích ngược.
  • Địa chỉ hiển thị là Phường 8, TP. Vũng Tàu, Tỉnh Bà Rịa-Vũng Tàu.

Ví dụ 2: Trả về địa giới mới     

GET /api/v2/place/details/json?key=public&place_id=6%3Avenue%3A184ea827-6691-5439-b6a2-abcc640c2cd4&new_admin=true&lang=vi            
 


OUTPUT:

{            
  "formatted_address": "336 Trương Công Định, Phường Tam Thắng, Thành phố Hồ Chí Minh",            
  "address_components": [            
    { "long_name": "336", "types": ["street_number"] },            
    { "long_name": "Trương Công Định", "types": ["route"] },            
    { "long_name": "Phường Tam Thắng", "types": ["administrative_area_level_2"] },            
    { "long_name": "Thành phố Hồ Chí Minh", "types": ["administrative_area_level_1"] },            
    { "long_name": "Việt Nam", "types": ["country"] }            
  ],            
  "place_id": "6:venue:184ea827-6691-5439-b6a2-abcc640c2cd4"            
}           
 
  • Khi thêm new_admin=true, địa chỉ trả về sẽ phản ánh địa giới hành chính mới đã áp dụng từ 01/07/2025. 
  • Địa chỉ hiển thị là: Phường Tam Thắng, TP. Hồ Chí Minh.


|Ví dụ 3: Trả song song địa chỉ cũ và mới

GET /api/v2/place/details/json?key=public&place_id=6:venue:184ea827-6691-5439-b6a2-abcc640c2cd4&new_admin=true&include_old_admin=true&lang=vi


OUTPUT:

{                   
  "formatted_address": "336 Trương Công Định, Phường Tam Thắng, Thành phố Hồ Chí Minh",                   
  "address_components": [...],                   
  "old_formatted_address": "336 Trương Công Định, Phường 8, Thành phố Vũng Tàu, Tỉnh Bà Rịa-Vũng Tàu",                   
  "old_address_components": [...]                 
}  
  • Địa chỉ mới phản ánh theo đơn vị hành chính sau sáp nhập: Phường Tam Thắng, TP.HCM
  • Địa chỉ cũ vẫn được truy xuất đầy đủ: Phường 8, TP. Vũng Tàu, Tỉnh Bà Rịa-Vũng Tàu 

👉 Xem nhanh tại: Tài liệu API của TrackAsia         

 

Vì sao tính năng này quan trọng?

  • Tương thích cả dữ liệu cũ và mới: Hệ thống vận hành, đối tác và khách hàng của bạn có thể đang sử dụng nhiều phiên bản địa chỉ khác nhau.
  • Tránh sai sót giao hàng và định tuyến: Việc hiển thị song song giúp tăng độ chính xác và giảm nhầm lẫn.
  • Chuẩn bị sẵn sàng cho chuyển đổi toàn quốc: Chủ động cập nhật giúp bạn đón đầu thay vì bị động xử lý sự cố.               
     

GỢI Ý SỬ DỤNG

  • Khi hiển thị địa chỉ cho người dùng cuối: Dùng include_old_admin=true để hiển thị cả địa chỉ cũ và mới, tránh nhầm lẫn.
  • Khi đồng bộ hệ thống backend: Có thể gọi new_admin=true để bắt đầu cập nhật dần dữ liệu theo chuẩn mới.
  • Khi xử lý đơn hàng, CRM, ERP, logistics: Nên ghi nhận cả hai để hỗ trợ tra cứu, đối chiếu và phân tích lịch sử chính xác.                
    
 

TrackAsia cam kết đồng hành cùng doanh nghiệp, nhà phát triển và hệ sinh thái trong quá trình chuyển đổi địa giới hành chính tại Việt Nam. Với bản cập nhật này, bạn có thể:

  • Chủ động quản lý dữ liệu theo chuẩn mới
  • Đảm bảo tính linh hoạt, ổn định của hệ thống
  • Giảm thiểu rủi ro sai sót khi địa chỉ thay đổi

Nếu bạn cần hỗ trợ kỹ thuật hoặc tư vấn triển khai, đội ngũ TrackAsia sẵn sàng đồng hành cùng bạn!

👉 Xem thêm tại: Tài liệu API của TrackAsia                
📬 Liên hệ hỗ trợ: [email protected]

Liên hệ truyền thông
Theo dõi các kênh truyền thông của TrackAsia
Tin mới nhất

Khám phá ứng dụng
TrackAsia Sample

Ứng dụng cung cấp kịch bản sẵn có, dễ dàng tích hợp vào hệ thống, tối ưu quản lý và trực quan hóa dữ liệu, hỗ trợ nhà phát triển xây dựng giải pháp nhanh chóng.


image image
image

Cùng nhau thực hiện ý tưởng mới

Ý tưởng của bạn
tạo ra tác động

Việc đưa ngành công nghiệp này tiến lên không chỉ cần kỹ năng, tài năng và chuyên môn, mà còn cần trí tưởng tượng. Từ tất cả chúng ta.

Ask Track AI...

Track AI

With Trackasia

Chat with us on Messenger