Ranh giới hành chính: response phong phú hơn + SDK v0.2.0

/v1/admin-boundaries ra mắt từ ngày đầu với một response tối giản có chủ đích — chỉ gồm name và boundary. Bảng vn_admin_boundaries bên dưới luôn chứa nhiều thông tin hơn thế, và hôm nay chúng tôi đưa phần còn lại ra ngoài.

Các trường tùy chọn mới trên mỗi ranh giới

• province_name, province_id — tỉnh/thành phố cha của mỗi quận/huyện (không còn phải join phía client)
• population, area_km2 — phục vụ tổng hợp mật độ và lập kế hoạch vùng dịch vụ
• pre_merge_info — ghi chú dễ đọc về lần tái tổ chức gần nhất của đơn vị, hữu ích để đối chiếu các địa chỉ cũ sau đợt sáp nhập tỉnh năm 2025
• admin_center — thành phố/thị trấn đặt trụ sở chính quyền
• phone, website — thông tin liên hệ chính thức nếu được công bố
• centroid — một điểm [lng, lat] duy nhất cho mỗi đơn vị, rẻ hơn so với việc tự tính trọng tâm polygon phía client

Độ phủ đạt 100% ở cả hai cấp (34/34 tỉnh/thành phố, 3.323/3.323 quận/huyện).

Tương thích ngược

name và boundary giữ nguyên cấu trúc hiện có. Mọi trường mới đều là tùy chọn trong cả JSON response lẫn các kiểu TypeScript — những consumer @gogoduk/[email protected] hiện tại vẫn hoạt động mà không cần thay đổi code.

SDK v0.2.0

@gogoduk/[email protected] cung cấp các kiểu bổ sung từ hôm nay. Chạy pnpm add @gogoduk/sdk@latest và các trường mới sẽ xuất hiện trên kiểu AdminBoundary mà không cần thay đổi gì khác.

Bài phân tích chuyên sâu về dataset đã cập nhật: Ranh giới hành chính Việt Nam: 34 tỉnh/thành phố, 3.323 quận/huyện, và metadata phong phú.