GoGoDuk

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

GET /v1/admin-boundaries?levels=4,8&format=geojson&countryCode=VN&tolerance=0.005
X-API-Key: gdk_live_xxxxxxxxxxxxxxxxxxxxxxxx
curl -G "https://api.gogoduk.com/v1/admin-boundaries" -H "X-API-Key: $GOGODUK_API_KEY" --data-urlencode "levels=4,8" --data-urlencode "format=geojson" --data-urlencode "countryCode=VN" --data-urlencode "tolerance=0.005"

Tham số query

TênBắt buộcMô tả
levelskhôngDanh 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.
formatkhôngĐịnh dạng hình học: geojson (mặc định) hoặc wkt.
countryCodekhôngMã quốc gia ISO alpha-2. Mặc định VN.
tolerancekhôngNgưỡng làm mượt ST_SimplifyPreserveTopology tính theo độ (vd 0.001–0.01) để giảm dung lượng response.

Response

{
  "admin_level_4": [
    {
      "id": 1,
      "name": "Thành phố Hà Nội",
      "province_name": "Thành phố Hà Nội",
      "population": 8500000,
      "area_km2": 3359.8,
      "pre_merge_info": null,
      "admin_center": { "lat": 21.0285, "lon": 105.8542 },
      "centroid": { "lat": 21.003, "lon": 105.691 },
      "boundary": {
        "type": "MultiPolygon",
        "coordinates": []
      }
    }
  ],
  "admin_level_8": []
}

Trường response

TrườngKiểuMô tả
admin_level_4 / admin_level_8arrayDanh sách polygon theo từng cấp hành chính yêu cầu.
[].namestringTên đơn vị hành chính chính thức.
[].province_namestring | nullTên tỉnh/thành phố trực thuộc (có trên cấp 8).
[].populationnumber | nullDân số (nếu có).
[].area_km2number | nullDiện tích theo km² (nếu có).
[].pre_merge_infoobject | nullThông tin đối chiếu địa giới trước sáp nhập (nếu có).
[].admin_centerobject | null{ lat, lon } trung tâm hành chính.
[].centroidobject | null{ lat, lon } tâm hình học.
[].boundaryobject | stringGeoJSON geometry object hoặc chuỗi WKT tùy theo format.

Lỗi thường gặp

  • 400 BAD_REQUEST — levels, format hoặc tolerance không hợp lệ.
  • 401 INVALID_API_KEY — API key không hợp lệ.
  • 403 INSUFFICIENT_SCOPE — key thiếu scope admin_boundaries:read.
  • 429 RATE_LIMIT_MINUTE — chờ theo trường retry_after.

On this page