GET /v1/admin-boundaries
Dữ liệu polygon ranh giới hành chính cấp tỉnh và phường/xã Việt Nam (GeoJSON hoặc WKT).
Trả về polygon ranh giới hành chính Việt Nam (cấp 4 tỉnh/thành phố và cấp 8 phường/xã/đặc khu) ở định dạng GeoJSON hoặc WKT, kèm các trường tùy chọn như dân số, diện tích, tâm hình học và thông tin địa giới trước sáp nhập.
Scope yêu cầu: admin_boundaries:read
Request
Tham số query
| Tên | Bắt buộc | Mô tả |
|---|---|---|
levels | không | Danh sách cấp hành chính ngăn cách bằng dấu phẩy (4: tỉnh/TP, 8: phường/xã). Mặc định 4,8. |
format | không | Định dạng hình học: geojson (mặc định) hoặc wkt. |
countryCode | không | Mã quốc gia ISO alpha-2. Mặc định VN. |
tolerance | không | Ngưỡng làm mượt ST_SimplifyPreserveTopology tính theo độ (vd 0.001–0.01) để giảm dung lượng response. |
Response
Trường response
| Trường | Kiểu | Mô tả |
|---|---|---|
admin_level_4 / admin_level_8 | array | Danh sách polygon theo từng cấp hành chính yêu cầu. |
[].name | string | Tên đơn vị hành chính chính thức. |
[].province_name | string | null | Tên tỉnh/thành phố trực thuộc (có trên cấp 8). |
[].population | number | null | Dân số (nếu có). |
[].area_km2 | number | null | Diện tích theo km² (nếu có). |
[].pre_merge_info | object | null | Thông tin đối chiếu địa giới trước sáp nhập (nếu có). |
[].admin_center | object | null | { lat, lon } trung tâm hành chính. |
[].centroid | object | null | { lat, lon } tâm hình học. |
[].boundary | object | string | GeoJSON geometry object hoặc chuỗi WKT tùy theo format. |
Lỗi thường gặp
400 BAD_REQUEST—levels,formathoặctolerancekhông hợp lệ.401 INVALID_API_KEY— API key không hợp lệ.403 INSUFFICIENT_SCOPE— key thiếu scopeadmin_boundaries:read.429 RATE_LIMIT_MINUTE— chờ theo trườngretry_after.