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

Districts

1. Danh sách quận/huyện​

Loading...

Lấy danh sách quận/huyện theo mã tỉnh/thành phố (province_code) hoặc theo danh sách mã quận/huyện (codes). Bắt buộc truyền đúng một trong hai.

Phiên bản dữ liệu

Cấp quận/huyện chỉ tồn tại ở phiên bản legacy (dữ liệu trước sáp nhập 2025).

Tham số​

Tham sốKiểuBắt buộcMặc địnhMô tả
province_codestringCó¹—Mã tỉnh/thành phố, 2 ký tự. Lưu ý tên tham số là province_code, không phải prov_code
codesstringCó¹—Danh sách mã quận/huyện phân tách bằng dấu phẩy (001,002)
fieldsstringKhôngxem bên dướiDanh sách trường muốn lấy — xem Trường hỗ trợ
include_geomstringKhôngfalsetrue hoặc false — có trả trường geom hay không
pageintegerKhông1Số trang. Chỉ dùng được cùng province_code
sizeintegerKhông10Số bản ghi mỗi trang, tối đa 50. Chỉ dùng được cùng province_code

¹ Bắt buộc một trong hai: province_code hoặc codes — không được truyền cả hai, cũng không được thiếu cả hai.

Trường hỗ trợ​

Cột Mặc định cho biết trường có được trả về khi không truyền fields hay không.

TrườngKiểuMặc địnhMô tả
idintegerCóMã nội bộ của bản ghi
prov_codestringCóMã tỉnh/thành phố chứa quận/huyện, 2 ký tự
dist_codestringCóMã quận/huyện, 3 ký tự
prov_namestring—Tên ngắn gọn của tỉnh/thành phố
dist_namestring—Tên ngắn gọn tiếng Việt (Ba Đình)
dist_fnamestringCóTên đầy đủ tiếng Việt (Quận Ba Đình)
dist_nestring—Tên ngắn gọn tiếng Anh (Ba Dinh)
dist_fnestringCóTên đầy đủ tiếng Anh (Ba Dinh District)
levelstringCóCấp hành chính (Quận, Huyện, Thị xã, Thành phố)
regionstringCóVùng địa lý (Đồng bằng sông Hồng…)
centerobject—Toạ độ trung tâm, dạng { lat, lng } theo WGS84 (EPSG:4326)
viewportobject—Khung nhìn, dạng { northeast, southwest }
geomobject—Ranh giới hành chính, GeoJSON geometry

Yêu cầu mẫu​

Loading API request...

Phản hồi​

{
"data": [
{
"id": 1,
"prov_code": "01",
"dist_code": "001",
"dist_fname": "Quận Ba Đình",
"dist_fne": "Ba Dinh District",
"region": "Đồng bằng sông Hồng",
"level": "Quận"
},
{
"id": 2,
"prov_code": "01",
"dist_code": "002",
"dist_fname": "Quận Hoàn Kiếm",
"dist_fne": "Hoan Kiem District",
"region": "Đồng bằng sông Hồng",
"level": "Quận"
}
],
"meta": {
"pagination": { "total": 30, "currentPage": 1, "pageSize": 2, "totalPages": 15 },
"data_version": "legacy"
},
"licence": "© GTEL Maps"
}

Lỗi thường gặp​

HTTPTình huống
422Tham số không hợp lệ hoặc không khớp dữ liệu

2. Chi tiết quận/huyện​

Loading...

Trả về thông tin một quận/huyện theo mã, mặc định kèm đầy đủ dữ liệu không gian.

Phiên bản dữ liệu

Cấp quận/huyện chỉ tồn tại ở phiên bản legacy (dữ liệu trước sáp nhập 2025).

Tham số​

Tham số đường dẫn

Tham sốKiểuBắt buộcMô tả
district_codestringCóMã quận/huyện, 3 ký tự (ví dụ 001)

Tham số truy vấn

Tham sốKiểuBắt buộcMặc địnhMô tả
fieldsstringKhôngxem bên dướiDanh sách trường muốn lấy — xem Trường hỗ trợ

Trường hỗ trợ​

Giống endpoint danh sách. Trường mặc định: id, prov_code, dist_code, dist_fname, dist_fne, region, level, center, viewport, geom.

Yêu cầu mẫu​

Loading API request...

Phản hồi​

{
"status": "OK",
"data": {
"id": 1,
"dist_code": "001",
"dist_fname": "Quận Ba Đình",
"center": { "lat": 21.036069337127202, "lng": 105.82659179708153 }
},
"meta": { "data_version": "legacy" },
"licence": "© GTEL Maps"
}

Lỗi thường gặp​

HTTPTình huống
404Không tồn tại mã quận/huyện
422Tham số không hợp lệ