Chuyển tới nội dung chính

Administrative API

Administrative API GTEL MAPS cung cấp dữ liệu về các đơn vị hành chính, bao gồm quốc gia, tỉnh/thành phố, phường/xã và các hình dạng địa lý của địa điểm cụ thể.

Phiên bản dữ liệu​

Dữ liệu đơn vị hành chính thay đổi theo nghị quyết của Chính phủ, nên API phục vụ song song 3 phiên bản dữ liệu, chọn bằng tham số data_version:

  • 2025-07.r2 — dữ liệu sau sáp nhập 2025, bản mới nhất, khuyến nghị cho tích hợp mới.
  • 2025-07.r1 — dữ liệu sau sáp nhập 2025, bản phát hành đầu.
  • legacy — dữ liệu trước sáp nhập 2025, còn cấp quận/huyện.

Chi tiết từng phiên bản, cách chọn phiên bản và endpoint tra cứu danh mục: xem Data Versions.

Danh sách API​

APIMô tảPhiên bản dữ liệu
ProvincesDanh sách và chi tiết tỉnh/thành phốTất cả
WardsDanh sách và chi tiết phường/xãTất cả
DistrictsDanh sách và chi tiết quận/huyệnChỉ legacy
Resolve LocationXác định đơn vị hành chính chứa một toạ độChỉ 2025-07.r2, 2025-07.r1
Data VersionsTra cứu danh mục phiên bản dữ liệu đang phục vụKhông phụ thuộc