Google Maps cập nhật dữ liệu bản đồ sau sát nhập tại Việt Nam

Google Maps cập nhật dữ liệu bản đồ sau sát nhập tại Việt Nam

Kể từ ngày 1/7/2025, Chính phủ Việt Nam đã sắp xếp lại 34 tỉnh thành trên toàn quốc. Nhằm đồng bộ với sự quy hoạch và phát triển sau khi sáp nhập, Google Maps chính thức thông báo sẽ cập nhật các APIs (thay đổi lớn nhất là Geocoding API và Places API – bao gồm cả Autocomplete) bắt đầu vào tháng 2/2026 với một số lưu ý quan trọng cho doanh nghiệp đang sử dụng dịch vụ GMP tại Việt Nam. Hãy cùng Cloud Ace tìm hiểu nhé

Kể từ giữa tháng 2 năm 2026, Google Maps sẽ tiến hành điều chỉnh các cấp đơn vị hành chính trong Google Maps Platform APIs nhằm mô phỏng chính xác hơn hệ thống địa chỉ bưu chính của Việt Nam. Những thay đổi này tác động cụ thể đến Address Types (Loại địa chỉ) và Address Component Types (Loại thành phần địa chỉ). Theo đó, Google Maps sẽ cập nhật các type được gán cho các thành phố, tỉnh, xã, phường hoặc đặc khu tại Việt Nam.

Những thay đổi này sẽ ảnh hưởng đến phản hồi từ Geocoding API, Places API (mới) và Places API (cũ) đối với các địa điểm tại Việt Nam. Việc cập nhật sẽ được triển khai theo bốn giai đoạn. Các dữ liệu phản hồi này được trả về bởi Place Autocomplete, Place Search, Place Details, Geocoding API, cũng như các dịch vụ tương ứng thuộc Places Library, Maps JavaScript API và Places SDK dành cho Android và iOS.

Những điểm cần lưu ý:

Nếu doanh nghiệp đang đơn thuần sử dụng Geocoding API, Places API (mới) hoặc Places API (cũ) mà không phụ thuộc vào các loại address_component cụ thể, sẽ không có ảnh hưởng gì (ví dụ: chỉ sử dụng trường formatted_address).
Nếu doanh nghiệp dựa vào các loại address_component cụ thể tại Việt Nam, doanh nghiệp có thể bị ảnh hưởng. Việc triển khai ứng dụng cần được cập nhật để thích ứng với các loại address_component mới như các giải thích chi tiết dưới đây.

Giai đoạn 1: Geocoding và Place API cập nhật

Ngưng cung cấp kết quả cấp quận, huyện, thị xã, thành phố trực thuộc tỉnh.
Thay đổi cấp độ hành chính của Xã/Phường từ type administrative_area_level_3 thành administrative_area_level_2.
Các khu vực (Zone) sẽ đượng thay đổi thành type administrative_area_level_2.
Tất cả các thay đổi trên cũng sẽ được áp dụng cho các thành phần địa chỉ trong các kết quả Geocoding và Place tại Việt Nam.
Các yêu cầu Reverse Geocoding (mã hóa địa lý ngược) được lọc theo result_types cụ thể sẽ trả về kết quả tương ứng với các thay đổi mới.
Ví dụ: Để lọc kết quả cấp Phường, doanh nghiệp cần thiết lập tham số result_types là administrative_area_level_2 (thay vì administrative_area_level_3 như trước đây).
Các type mới này sẽ xuất hiện trong tất cả các API, ngoại trừ Place Autocomplete.

Giai đoạn 2: Thay đổi đối với Autocomplete API

Đồng bộ hóa kết quả trả về: Các typesmới cũng sẽ chính thức được áp dụng và trả về trong kết quả của dịch vụ Place Autocomplete.
Điều chỉnh tham số bộ lọc: Đối với các yêu cầu Place Autocomplete sử dụng tính năng lọc theo types cụ thể, kết quả trả về sẽ tương ứng với các giá trị loại mới:
Ví dụ: Để lọc kết quả cấp Phường, tham số types cần được thiết lập là administrative_area_level_2 (thay vì administrative_area_level_3 như trước đây).
Các thay đổi nêu trên cũng áp dụng đồng thời cho các yêu cầu sử dụng bộ lọc nhóm (cities) hoặc (regions).

Giai đoạn 4: (ngày bắt đầu sẽ được công bố sau)

Đối với Thành phố, xã/phường thuộc tỉnh các kết quả sẽ được cung cấp dưới dạng kết quả bổ sung với loại locality.
Đối với Xã/Phường thuộc Thành phố sẽ được cung cấp dưới dạng kết quả bổ sung với loại sublocality_level_1.

Lưu ý: Các loại kết quả sau sẽ KHÔNG thay đổi:

Cấp Tỉnh/Thành phố trực thuộc trung ương: Các kết quả Geocoding và Place đại diện cho thành phố (Municipalities) và tỉnh (Provinces) sẽ không thay đổi loại (type), vẫn giữ nguyên là administrative_area_level_1.
Cấp đơn vị dân cư nhỏ: Các kết quả Geocoding và Place đại diện cho Tổ dân phố, Khu phố (bao gồm Khu, Khóm, Tiểu khu), Thôn (bao gồm Ấp, Xóm), Làng và Bản (bao gồm Buôn, Bon, Phum, Sóc) sẽ không thay đổi loại (type), vẫn giữ nguyên là neighborhood.

Cloud Ace

Google Cloud Managed Service Provider