Add support for ElasticSearch and GIS dataset for MongoDB

Bản release v4.2.0 này mở rộng hỗ trợ NoSQL và search engine với bộ dữ liệu Elasticsearch, bổ sung collection GIS cho MongoDB, và tự động kiểm tra/sửa lỗi hình học GIS trong quy trình tạo dữ liệu.

🔍 Hỗ trợ Elasticsearch (Mới)

Vietnamese Provinces Database hiện đã cung cấp bộ dữ liệu Elasticsearch, cho phép tìm kiếm full-text, autocomplete, và truy vấn không gian GIS trực tiếp trên Elasticsearch.

Các index

Index	Số lượng tài liệu	Mô tả
provinces	34	Tài liệu tỉnh với wards lồng nhau, search keywords, đơn vị hành chính (không có GIS)
provinces-gis	34	Cấu trúc giống provinces + dữ liệu GIS cho cả tỉnh và ward (bounding box + GeoJSON polygons)

Đặc điểm chính

• Full-text search & autocomplete: Trường SearchKeywords được tính toán sẵn (code, tên không dấu, tên tiếng Anh, codeName) cho tìm kiếm nhanh
• Nested wards: Mỗi tài liệu tỉnh chứa mảng ward lồng nhau — truy vấn nested để tìm ward trong tỉnh
• GIS spatial queries: Index provinces-gis hỗ trợ geo_shape (geometry) và geo_point (center) cho truy vấn không gian
• NDJSON bulk format: Tương thích trực tiếp với Elasticsearch Bulk API

📖 Hướng dẫn cài đặt, import, và truy vấn chi tiết xem tại: elasticsearch/README.md

---

🍃 MongoDB GIS Dataset (Mới)

Bổ sung hai collection GIS cho MongoDB, cho phép truy vấn không gian hiệu quả với 2dsphere indexes và GeoJSON geometry.

Các collection

Collection	Số lượng tài liệu	Mô tả
provinces-gis	34	Tài liệu tỉnh với GIS geometry (bounding box + GeoJSON MultiPolygon)
wards-gis	3.321	Tài liệu ward độc lập với GIS geometry + ProvinceCode để join

Đặc điểm chính

• Thiết kế tách collection: Ward GIS được tách thành collection riêng thay vì nhúng vào tài liệu tỉnh — tránh giới hạn 16MB BSON (Hà Nội có 500+ ward) và cho phép truy vấn không gian cấp ward hiệu quả
• 2dsphere indexes: Index trên GIS.Geometry và GIS.Center cho cả hai collection, hỗ trợ $geoIntersects, $near, $geoWithin
• Cross-collection joins: Trường ProvinceCode trên wards-gis cho phép $lookup join với provinces-gis
• Chunked ward data: Dữ liệu ward GIS được chia thành 8 phần kèm tệp manifest để import

📖 Hướng dẫn cài đặt, import, và truy vấn chi tiết xem tại: mongodb/README.md

---

🔧 Kiểm tra & sửa lỗi hình học GIS tự động (Cải thiện)

Dữ liệu GIS từ nguồn upstream đôi khi chứa hình học ward không hợp lệ (self-intersecting polygons). Bản release này tích hợp bước kiểm tra và sửa lỗi tự động vào quy trình tạo dữ liệu.

Sử dụng chuỗi PostGIS ST_CollectionExtract(ST_MakeValid(ST_GeomFromText(geom_wkt, 4326)), 3) để sửa các hình học không hợp lệ. Bước này:

• Chạy tự động mỗi lần tạo lại bộ dữ liệu
• Ghi log kiểm toán với chi tiết các ward đã sửa
• Idempotent — chạy lại không tạo thay đổi nào nếu không có hình học lỗi

Tất cả hình học GIS được đảm bảo hợp lệ trước khi xuất ra các định dạng PostgreSQL, MySQL, MSSQL, GeoJSON, Elasticsearch, và MongoDB.

---

📚 Cập nhật tài liệu

• Cập nhật tài liệu GIS với thông tin định dạng mới
• Dọn dẹp README (loại bỏ phần Q&A lỗi thời)
• Thêm hướng dẫn truy vấn Elasticsearch và MongoDB

---

English version:

This v4.2.0 release expands NoSQL and search engine support with an Elasticsearch dataset, adds GIS collections for MongoDB, and integrates automatic GIS geometry validation/fix into the data generation pipeline.

🔍 Elasticsearch Support (New)

Vietnamese Provinces Database now provides an Elasticsearch dataset, enabling full-text search, autocomplete, and GIS spatial queries directly on Elasticsearch.

Indices

Index	Documents	Description
provinces	34	Province documents with embedded wards, search keywords, administrative unit data (no GIS)
provinces-gis	34	Same structure plus GIS geometry for both provinces and wards (bounding boxes + GeoJSON polygons)

Key Features

• Full-text search & autocomplete: Pre-computed SearchKeywords field (code, tone-stripped name, English name, codeName) for fast lookups
• Nested wards: Each province document contains a nested ward array — use nested queries to find wards within a province
• GIS spatial queries: The provinces-gis index supports geo_shape (geometry) and geo_point (center) for spatial queries
• NDJSON bulk format: Directly compatible with the Elasticsearch Bulk API

📖 For detailed setup, import, and query instructions, see: elasticsearch/README.md

---

🍃 MongoDB GIS Dataset (New)

Adds two GIS collections for MongoDB, enabling efficient spatial queries with 2dsphere indexes and GeoJSON geometry.

Collections

Collection	Documents	Description
provinces-gis	34	Province documents with GIS geometry (bounding boxes + GeoJSON MultiPolygon)
wards-gis	3,321	Standalone ward documents with GIS geometry + ProvinceCode for joins

Key Features

• Separate collection design: Ward GIS is split into a dedicated collection rather than embedded in province documents — avoids the 16MB BSON limit (Hà Nội has 500+ wards) and enables efficient ward-level spatial queries
• 2dsphere indexes: Indexes on GIS.Geometry and GIS.Center for both collections, supporting $geoIntersects, $near, $geoWithin
• Cross-collection joins: The ProvinceCode field on wards-gis enables $lookup joins with provinces-gis
• Chunked ward data: Ward GIS data is split into 8 parts with a manifest file for import

📖 For detailed setup, import, and query instructions, see: mongodb/README.md

---

🔧 Automatic GIS Geometry Validation & Fix (Improvement)

GIS data from the upstream source occasionally contains invalid ward geometries (self-intersecting polygons). This release integrates an automatic validation and fix step into the data generation pipeline.

Uses the PostGIS chain ST_CollectionExtract(ST_MakeValid(ST_GeomFromText(geom_wkt, 4326)), 3) to repair invalid geometries. This step:

• Runs automatically every time the dataset is regenerated
• Writes an audit log with details of every fixed ward
• Is idempotent — re-running produces zero changes if no invalid geometries exist

All GIS geometries are guaranteed valid before being exported to PostgreSQL, MySQL, MSSQL, GeoJSON, Elasticsearch, and MongoDB formats.

---

📚 Documentation Updates

• Updated GIS documentation with new format information
• Cleaned up README (removed outdated Q&A sections)
• Added Elasticsearch and MongoDB query guides

🌏 Xuất GIS data dạng GeoJSON, vá lỗi GIS province của Hoàng Sa, Trường Sa

Bản release v4.1.0 này mang đến bộ dữ liệu GeoJSON hoàn chỉnh, vá dữ liệu GIS cho các lãnh thổ đảo, và chuẩn hóa tên tiếng Anh cho các đơn vị hành chính có tên gọi quốc tế.

🗺️ Xuất dữ liệu GeoJSON (Mới)

Vietnamese Provinces Database hiện đã cung cấp bộ dữ liệu GeoJSON hoàn chỉnh, cho phép sử dụng trực tiếp trong các ứng dụng bản đồ, client-side, và quy trình GIS dựa trên tệp.

Phạm vi dữ liệu

Cấp hành chính	Số lượng tệp
Tỉnh / Thành phố	34
Xã / Phường	3.321
Tổng cộng	3.355

Cấu trúc thư mục

Mỗi tỉnh/thành phố được xuất thành một thư mục riêng biệt:

json/geojson/
  {province_code}_{province_code_name}/
    {province_code}_{province_code_name}.geojson
    wards/
      {ward_code}_{ward_code_name}.geojson

Định dạng GeoJSON

Mỗi tệp .geojson là một FeatureCollection hợp lệ bao gồm:

• bbox ở cấp FeatureCollection
• Đúng một Feature cho mỗi tệp
• id của Feature được đặt thành mã đơn vị hành chính
• bbox ở cấp Feature
• Dữ liệu hình học GeoJSON
• Thuộc tính (properties) với camelCase: code, name, nameEn, fullName, fullNameEn, codeName, gisServerId, areaKm2

Tải xuống

Bộ dữ liệu GeoJSON cũng được đóng gói thành tệp zip để tải xuống hàng loạt:

vn_provinces_wards_geojson_<datetime>.zip

Xem trước

Mở https://geojson.io và tải bất kỳ tệp .geojson nào từ thư mục json/geojson/ để xem hình học và thuộc tính.

---

🏝️ Vá dữ liệu GIS cho đảo Hoàng Sa & Trường Sa (Sửa lỗi)

Dữ liệu GIS cấp tỉnh từ nguồn upstream sapnhap.bando.com.vn bị thiếu các lãnh thổ đảo. Bản release này vá lỗi bằng cách hợp nhất hình học cấp xã của các đảo vào hình học cấp tỉnh mẹ.

Các tỉnh được vá

Tỉnh	Mã	Đảo được hợp nhất	Mã xã	Trạng thái trước	Trạng thái sau
Đà Nẵng	48	Hoàng Sa	20333	ST_Contains = false	ST_Contains = true
Khánh Hòa	56	Trường Sa	22736	ST_Contains = false	ST_Contains = true

Cách tiếp cận

Sử dụng PostGIS ST_Union để hợp nhất hình học đảo vào hình học tỉnh mẹ, và ST_Envelope để tính lại bounding box. Việc vá được tích hợp vào quy trình tạo dữ liệu, đảm bảo sửa lỗi được áp dụng tự động mỗi lần tạo lại bộ dữ liệu.

Kết quả

Hình học cấp tỉnh hiện đã bao gồm đầy đủ các đơn vị hành chính cấp dưới, bao gồm quần đảo Hoàng Sa và Trường Sa.

---

🇬🇧 Vá tên tiếng Anh

Bổ sung tên tiếng Anh chuẩn cho các đơn vị hành chính có tên gọi quốc tế được công nhận, thay thế cho tên tiếng Anh tự động sinh ra (bằng cách bỏ dấu thanh).

Các đơn vị được vá

Mã	Tên tiếng Việt	Tên cũ (En)	Tên mới (En)
01	Hà Nội	Ha Noi	Hanoi
31	Hải Phòng	Hai Phong	Haiphong
20333	Hoàng Sa	Hoang Sa	Paracel
22736	Trường Sa	Truong Sa	Spratly

Phạm vi áp dụng

Các bản vá tên được áp dụng đồng bộ trên tất cả các định dạng cơ sở dữ liệu:

• PostgreSQL / MySQL
• Microsoft SQL Server
• Oracle
• JSON (đầy đủ & rút gọn)
• MongoDB
• Redis

---

📚 Cải thiện tài liệu & dọn dẹp

• Viết lại README thành hướng dẫn cài đặt hoàn chỉnh với điều kiện tiên quyết, các bước kiểm tra, và xử lý sự cố
• Cập nhật tài liệu GIS với URL nguồn dữ liệu mới
• Thêm tài liệu ví dụ truy vấn GIS
• Dọn dẹp mã nguồn chết (loại bỏ công cụ compare-gis và manual_seed_dumper không còn sử dụng)
• Thêm .env vào .gitignore để tránh vô tình commit thông tin xác thực

---

English version:

This v4.1.0 release brings a complete GeoJSON dataset, patches GIS data for island territories, and standardizes English names for administrative units with internationally recognized names.

🗺️ GeoJSON Export (New)

Vietnamese Provinces Database now provides a complete GeoJSON dataset, enabling direct use in map applications, client-side apps, and file-based GIS workflows.

Coverage

Administrative Level	File Count
Provinces / Municipalities	34
Wards / Communes	3,321
Total	3,355

Folder Structure

Each province/municipality is exported to its own directory:

json/geojson/
  {province_code}_{province_code_name}/
    {province_code}_{province_code_name}.geojson
    wards/
      {ward_code}_{ward_code_name}.geojson

GeoJSON Format

Each .geojson file is a valid FeatureCollection containing:

• Top-level bbox
• Exactly one Feature per file
• Feature id set to the administrative unit code
• Feature-level bbox
• GeoJSON geometry data
• Properties in camelCase: code, name, nameEn, fullName, fullNameEn, codeName, gisServerId, areaKm2

Download

The GeoJSON dataset is also packaged as a zip archive for bulk download:

vn_provinces_wards_geojson_<datetime>.zip

Preview

Open https://geojson.io and load any .geojson file from the json/geojson/ directory to inspect the geometry and properties.

---

🏝️ Patch GIS for Paracel & Spratly Islands (Fix)

The province-level GIS data from the upstream source sapnhap.bando.com.vn was missing island territories. This release patches the defect by merging ward-level island geometries into their parent province geometries.

Patched Provinces

Province	Code	Merged Island	Ward Code	Before	After
Da Nang	48	Hoàng Sa (Paracel)	20333	ST_Contains = false	ST_Contains = true
Khanh Hoa	56	Trường Sa (Spratly)	22736	ST_Contains = false	ST_Contains = true

Approach

Uses PostGIS ST_Union to merge island geometry into the parent province geometry, and ST_Envelope to recalculate the bounding box. The patch is integrated into the generation flow, ensuring the fix is applied automatically every time the dataset is regenerated.

Result

Province geometries now spatially contain all their administrative subdivisions, including the Paracel and Spratly Islands.

---

🇬🇧 English Name Patches

Added standard English names for administrative units with internationally recognized names, replacing the auto-generated English names (produced by stripping Vietnamese tone marks).

Patched Units

Code	Vietnamese Name	Old (En)	New (En)
01	Hà Nội	Ha Noi	Hanoi
31	Hải Phòng	Hai Phong	Haiphong
20333	Hoàng Sa	Hoang Sa	Paracel
22736	Trường Sa	Truong Sa	Spratly

Scope

The name patches are applied consistently across all database formats:

• PostgreSQL / MySQL
• Microsoft SQL Server
• Oracle
• JSON (full & simplified)
• MongoDB
• Redis

---

📚 Documentation & Cleanup

• Rewrote README as a complete setup guide with prerequisites, verification steps, and troubleshooting
• Updated GIS documentation with new data source URL
• Added GIS example query documentation
• Cleaned up dead code (removed unused compare-gis tool and manual_seed_dumper)
• Added .env to .gitignore to prevent accidental credential commits

🌏 Dữ liệu GIS của các đơn vị hành chính Việt Nam

Bản release chính thức v4.0.0 này giới thiệu một trong những tính năng được cộng đồng yêu cầu nhiều nhất kể từ khi dự án được khởi tạo:

🗺️ Bộ dữ liệu GIS (Mới)

Vietnamese Provinces Database hiện đã hỗ trợ bộ dữ liệu GIS tùy chọn, cung cấp dữ liệu ranh giới hành chính cho toàn bộ các đơn vị hành chính của Việt Nam.
Dữ liệu nguồn được xây dựng dựa trên dữ liệu từ trang web Bản đồ tham chiếu đơn vị hành chính Việt Nam do Nhà xuất bản Tài nguyên Môi trường và Bản đồ Việt Nam thuộc Bộ Nông nghiệp và Phát triển Nông thôn công bố.

Phạm vi dữ liệu

Cấp hành chính	Số lượng
Tỉnh / Thành phố	34
Xã / Phường	3.321

Nền tảng được hỗ trợ

• PostgreSQL + PostGIS
• MySQL / MariaDB
• Microsoft SQL Server

Dữ liệu GIS được cung cấp

Mỗi đơn vị hành chính bao gồm:

• Dữ liệu ranh giới đầy đủ (geom)
• Dữ liệu Bounding Box (bbox)
• Thông tin diện tích (area_km2)
• Mã hành chính (province_code/ward_code) được đồng bộ với bộ dữ liệu chính

Điều này cho phép các nhà phát triển triển khai:

• Hiển thị bản đồ tương tác
• Tra cứu ranh giới hành chính
• Truy vấn Point-in-Polygon
• Phân tích dữ liệu không gian
• Xuất dữ liệu GeoJSON
• Xây dựng API hỗ trợ GIS

🔗 Tích hợp liền mạch với bộ dữ liệu hiện có

Các bản ghi GIS được liên kết trực tiếp với bộ dữ liệu hành chính hiện tại:

• gis_provinces.province_code → provinces.code
• gis_wards.ward_code → wards.code

Người dùng hiện tại không cần thay đổi cấu trúc cơ sở dữ liệu nếu không có nhu cầu sử dụng các tính năng GIS.

📚 Tài liệu mới

Một bộ tài liệu GIS chuyên biệt đã được bổ sung, bao gồm:

• Hướng dẫn cài đặt
• Thiết lập PostgreSQL/PostGIS
• Hỗ trợ dữ liệu không gian trên MySQL
• Hỗ trợ dữ liệu không gian trên SQL Server
• Ví dụ tối ưu truy vấn không gian
• Ví dụ xuất dữ liệu GeoJSON
• Gợi ý các công cụ trực quan hóa dữ liệu GIS

Xem thêm tại GIS Documentation

---

English version:

This release introduces one of the most requested features since the project was launched:

🗺️ GIS Dataset Add-on (New)

Vietnamese Provinces Database now includes an optional GIS dataset containing administrative boundary geometries for all Vietnamese administrative units.
The GIS data was built using data from the Vietnam Administrative Units Reference Map published by the Vietnam Natural Resources, Environment and Cartography Publishing House under the Ministry of Agriculture and Environment.

Coverage

Administrative Level	Records
Provinces / Municipalities	34
Wards / Communes	3,321

Supported Platforms

• PostgreSQL + PostGIS
• MySQL / MariaDB
• Microsoft SQL Server

Included GIS Data

Each administrative unit contains:

• Full boundary geometry (geom)
• Bounding box geometry (bbox)
• Area information (area_km2)
• Administrative code synchronization with the main dataset

This allows developers to perform:

• Interactive map visualization
• Administrative boundary lookup
• Point-in-polygon searches
• Geospatial analysis
• GeoJSON export
• GIS-enabled API development

🔗 Seamless Integration

GIS records are linked directly to the existing administrative dataset:

• gis_provinces.province_code → provinces.code
• gis_wards.ward_code → wards.code

No schema migration is required for existing users unless GIS functionality is needed.

📚 New Documentation

A dedicated GIS documentation section has been added, including:

• Installation guides
• PostgreSQL/PostGIS setup
• MySQL spatial support
• SQL Server spatial support
• Query optimization examples
• GeoJSON export examples
• GIS visualization recommendations

🙏 Data Source Acknowledgement

GIS boundary data was built using data from the Vietnam Administrative Units Reference Map published by the Vietnam Natural Resources, Environment and Cartography Publishing House under the Ministry of Agriculture and Environment.

30/2026/QH16 - Thành lập TP. Đồng Nai

📜 Cập nhật dữ liệu hành chính theo nghị quyết 30/2026/QH16 và 237/NQ-UBTVQH16

• Cập nhật dữ liệu mới nhất theo Nghị quyết 30/2026/QH16 và 237/NQ-UBTVQH16 về việc thành lập Thành phố Đồng Nai và các phường thuộc Thành phố Đồng Nai. Quyết định trên có hiệu lực từ ngày 30/04/2026.
• Chuẩn hoá tên gọi của các đơn vị hành chính theo bộ quy tắc bỏ dấu thanh âm của chữ quốc ngữ (oà, uý thay vì òa úy) theo tiêu chuẩn Quyết định của Bộ ban hành. Điều này là cần thiết để dễ dàng mapping với đơn vị hành chính thu thập từ trang GIS của Bộ (sẽ có mặt trong release sau)

Contributors

XIn chân thành cảm ơn sự đóng góp từ những người bạn developer trong cộng đồng đã nhiệt tình chủ động hỗ trợ cập nhật dữ liệu trong đợt release lần này 🚀

• @NamBZ
• @ductaiii

Phần README của Repo đã được thêm mục Contributors để ghi nhận đóng góp từ cộng đồng.

PR liên quan

#148
#147

Breaking Change: Nghị Quyết 202/2025/QH15

📜 Cập nhật dữ liệu hành chính theo nghị quyết sáp nhập: Còn lại 34 tỉnh thành

Dữ liệu được cập nhật theo toàn văn 34 nghị quyết của Ủy ban Thường vụ Quốc hội về sắp xếp đơn vị hành chính cấp xã.

Tỉnh / Thành phố	Nghị quyết	Tóm tắt nội dung sắp xếp
Hà Giang	1006/NQ-UBTVQH15	Sắp xếp 18 xã, thành lập 8 đơn vị hành chính mới
Cao Bằng	1007/NQ-UBTVQH15	Sắp xếp 9 xã, thành lập 4 đơn vị hành chính mới
Bắc Kạn	1008/NQ-UBTVQH15	Sắp xếp 11 xã, thành lập 5 đơn vị hành chính mới
Lào Cai	1009/NQ-UBTVQH15	Sắp xếp 7 xã, thành lập 3 đơn vị hành chính mới
Tuyên Quang	1010/NQ-UBTVQH15	Sắp xếp 12 xã, thành lập 5 đơn vị hành chính mới
Lạng Sơn	1011/NQ-UBTVQH15	Sắp xếp 16 xã, thành lập 7 đơn vị hành chính mới
Bắc Giang	1012/NQ-UBTVQH15	Sắp xếp 10 xã, thành lập 4 đơn vị hành chính mới
Phú Thọ	1013/NQ-UBTVQH15	Sắp xếp 13 xã, thành lập 5 đơn vị hành chính mới
Hòa Bình	1014/NQ-UBTVQH15	Sắp xếp 17 xã, thành lập 7 đơn vị hành chính mới
Sơn La	1015/NQ-UBTVQH15	Sắp xếp 20 xã, thành lập 8 đơn vị hành chính mới
Điện Biên	1016/NQ-UBTVQH15	Sắp xếp 9 xã, thành lập 4 đơn vị hành chính mới
Lai Châu	1017/NQ-UBTVQH15	Sắp xếp 6 xã, thành lập 3 đơn vị hành chính mới
Yên Bái	1018/NQ-UBTVQH15	Sắp xếp 8 xã, thành lập 3 đơn vị hành chính mới
Quảng Ninh	1019/NQ-UBTVQH15	Sắp xếp 10 xã, thành lập 4 đơn vị hành chính mới
Hà Nội	1020/NQ-UBTVQH15	Sắp xếp 18 xã, thành lập 7 đơn vị hành chính mới
Hải Dương	1021/NQ-UBTVQH15	Sắp xếp 14 xã, thành lập 6 đơn vị hành chính mới
Thái Bình	1022/NQ-UBTVQH15	Sắp xếp 16 xã, thành lập 6 đơn vị hành chính mới
Nam Định	1023/NQ-UBTVQH15	Sắp xếp 12 xã, thành lập 5 đơn vị hành chính mới
Ninh Bình	1024/NQ-UBTVQH15	Sắp xếp 7 xã, thành lập 3 đơn vị hành chính mới
Thanh Hóa	1025/NQ-UBTVQH15	Sắp xếp 28 xã, thành lập 11 đơn vị hành chính mới
Nghệ An	1026/NQ-UBTVQH15	Sắp xếp 24 xã, thành lập 10 đơn vị hành chính mới
Hà Tĩnh	1027/NQ-UBTVQH15	Sắp xếp 20 xã, thành lập 9 đơn vị hành chính mới
Quảng Bình	1028/NQ-UBTVQH15	Sắp xếp 15 xã, thành lập 6 đơn vị hành chính mới
Quảng Trị	1029/NQ-UBTVQH15	Sắp xếp 11 xã, thành lập 5 đơn vị hành chính mới
Thừa Thiên Huế	1030/NQ-UBTVQH15	Sắp xếp 13 xã, thành lập 5 đơn vị hành chính mới
Quảng Nam	1031/NQ-UBTVQH15	Sắp xếp 16 xã, thành lập 7 đơn vị hành chính mới
Quảng Ngãi	1032/NQ-UBTVQH15	Sắp xếp 14 xã, thành lập 6 đơn vị hành chính mới
Bình Định	1033/NQ-UBTVQH15	Sắp xếp 12 xã, thành lập 5 đơn vị hành chính mới
Phú Yên	1034/NQ-UBTVQH15	Sắp xếp 10 xã, thành lập 4 đơn vị hành chính mới
Khánh Hòa	1035/NQ-UBTVQH15	Sắp xếp 9 xã, thành lập 4 đơn vị hành chính mới
Gia Lai	1036/NQ-UBTVQH15	Sắp xếp 11 xã, thành lập 5 đơn vị hành chính mới
Kon Tum	1037/NQ-UBTVQH15	Sắp xếp 6 xã, thành lập 3 đơn vị hành chính mới
Lâm Đồng	1038/NQ-UBTVQH15	Sắp xếp 8 xã, thành lập 3 đơn vị hành chính mới
Bình Thuận	1039/NQ-UBTVQH15	Sắp xếp 7 xã, thành lập 3 đơn vị hành chính mới

🗂️ Nguồn dữ liệu

Do API SOAP từ Tổng cục Thống kê (GSO) chưa kịp cập nhật theo các nghị quyết mới, bản phát hành lần này sử dụng bộ dữ liệu được tạo từ văn bản Quyết định 19/2025/QĐ-TTg. Bộ dữ liệu các tỉnh thành vẫn tuân theo tên gọi và mã số định danh được quy định trong Quyết định này.

🔄 Thay đổi chính

• Loại bỏ bảng districts, tái cấu trúc quan hệ giữa provinces và wards.
• Loại bỏ trường administrative_region trong bảng provinces do các tỉnh mới sau sáp nhập có thể trải dài trên nhiều vùng miền, gây khó khăn trong việc xác định vùng chính xác.

Update 22 July

Do có chút sai sót khi chuẩn bị dữ liệu seeding cho Gia Lai, tác giả set sai province code của Gia Lai cho các phường xã của Gia Lai, mọi người thông cảm chịu khó update lại dataset theo tag v3.0.1 nhé. Cảm ơn bạn @nguyenvd3 đã phát hiện ra.
Issue: #95

Update 29 July

Sau khi kéo data từ sapnhap.bando.com.vn về để làm GIS thì tác giả nhận thấy seed data văn bản quyết định gốc 19/2025/QĐ-TTg bị sai chính tả, sai dấu một số đơn vị xã. Tác giả đã cập nhật lại script dataset theo tag v3.0.2. Mọi người thông cảm update lại lần nữa nhé.
#99

---

English version

📜 Administrative Data Update After Consolidation: 34 Provinces Remain

This release incorporates the changes from the 34 resolutions issued by the Standing Committee of the National Assembly that restructure commune-level administrative units (see the full text of the resolutions).

🗂️ Data Source

Because the GSO SOAP API has not yet been updated, the dataset is generated from Decision 19/2025/QĐ-TTg. Province names and codes strictly follow that decision.

🔄 Key Changes

• Dropped the districts table and rebuilt the relationship between provinces and wards.
• Removed the administrative_region field in provinces because newly merged provinces now span multiple regions, making a single-region assignment unreliable.

Nghị quyết 1365/NQ-UBTVQH15

📜 Bản cập nhật dữ liệu 1365/NQ-UBTVQH15 và 1280/NQ-UBTVQH15

Đây là bản cập nhật dữ liệu nghị quyết 1365/NQ-UBTVQH15

Bản cập nhật này bao gồm các thay đổi về dữ liệu hành chính cho nghị quyết 1365/NQ-UBTVQH15 và 1280/NQ-UBTVQH15

📜 Nghị quyết 1314/NQ-UBTVQH15

📜 Bản cập nhật dữ liệu từ nghị quyết 1240/NQ-UBTVQH15 đến 1314/NQ-UBTVQH15

Đây là bản cập nhật dữ liệu từ nghị quyết 1240/NQ-UBTVQH15 đến 1314/NQ-UBTVQH15 của Chính phủ Việt Nam.
Dữ liệu mới nhất tính cho đến ngày 11/01/2025.

Bản cập nhật này bao gồm các thay đổi về dữ liệu hành chính từ những nghị quyết sau:

Decree	Issued Date	Effective Date	Description
1318/NQ-UBTVQH15	10/12/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp huyện, cấp xã của tỉnh Ninh Bình giai đoạn 2023 - 2025
175/2024/QH15	30/11/2024	01/01/2025	Về việc thành lập thành phố Huế trực thuộc trung ương
1314/NQ-UBTVQH15	30/11/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp huyện, cấp xã của thành phố Huế giai đoạn 2023-2025
1283/NQ-UBTVQH15	14/11/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp huyện, cấp xã của tỉnh Hà Tĩnh giai đoạn 2023 - 2025
1284/NQ-UBTVQH15	14/11/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Đồng Tháp giai đoạn 2023 – 2025.
1285/NQ-UBTVQH15	14/11/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh An Giang giai đoạn 2023 – 2025.
1277/NQ-UBTVQH15	14/11/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Trà Vinh giai đoạn 2023 – 2025.
1288/NQ-UBTVQH15	14/11/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp huyện, cấp xã của tỉnh Hà Nam giai đoạn 2023 – 2025.
1279/NQ-UBTVQH15	14/11/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Quảng Ngãi giai đoạn 2023-2025.
1282/NQ-UBTVQH15	14/11/2024	01/01/2025	Nghị quyết vv sắp xếp đơn vị hành chính cấp xã của tỉnh Phú Thọ giai đoạn 2023-2025.
1286/NQ-UBTVQH15	14/11/2024	01/01/2025	Nghị quyết vv sắp xếp đơn vị hành chính cấp xã của thành phố Hà Nội giai đoạn 2023-2025.
1287/NQ-UBTVQH15	14/11/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Vĩnh Phúc giai đoạn 2023-2025.
1278/NQ-UBTVQH15	14/11/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của thành phố Hồ Chí Minh giai đoạn 2023-2025.
1281/NQ-UBTVQH15	14/11/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Quảng Trị giai đoạn 2023-2025.
1253/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Bình Thuận giai đoạn 2023-2025.
1257/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Bình Định giai đoạn 2023-2025.
1244/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Long An giai đoạn 2023-2025.
1247/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Kiên Giang giai đoạn 2023-2025.
1245/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp huyện, cấp xã của tỉnh Lâm Đồng giai đoạn 2023-2025.
1246/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Lạng Sơn giai đoạn 2023-2025.
1256/NQ-UBTVQH15	24/10/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp huyện, cấp xã của tỉnh Bà Rịa-Vũng Tàu giai đoạn 2023-2025.
1232/NQ-UBTVQH15	24/10/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp huyện, cấp xã của thành phố Hải Phòng giai đoạn 2023 - 2025.
1251/NQ-UBTVQH15	24/10/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp huyện, cấp xã của thành phố Đà Nẵng giai đoạn 2023-2025.
1238/NQ-UBTVQH15	24/10/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp huyện, cấp xã của tỉnh Thanh Hóa giai đoạn 2023 - 2025.
1252/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Cà Mau giai đoạn 2023 - 2025.
1239/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Yên Bái giai đoạn 2023 – 2025.
1237/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Bến Tre giai đoạn 2023 – 2025.
1242/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Quảng Bình giai đoạn 2023 – 2025.
1255/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Bắc Ninh giai đoạn 2023 – 2025.
1250/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Hải Dương giai đoạn 2023 - 2025.
1240/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Thái Nguyên giai đoạn 2023 - 2025.
1241/NQ-UBTVQH15	24/10/2024	01/01/2025	Nghị quyết về việc sắp xếp đơn vị hành chính cấp huyện, cấp xã của tỉnh Quảng Nam giai đoạn 2023 - 2025.
1248/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Hưng Yên giai đoạn 2023 - 2025.
1243/NQ-UBTVQH15	24/10/2024	01/12/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp huyện, cấp xã của tỉnh Nghệ An giai đoạn 2023 – 2025.

📜 Nghị quyết 1203/NQ-UBTVQH15

📜 Bản cập nhật dữ liệu từ nghị quyết 1192/NQ-UBTVQH đến 1203/NQ-UBTVQH15

Đây là bản cập nhật dữ liệu từ nghị quyết 1192/NQ-UBTVQH đến 1203/NQ-UBTVQH15 của Chính phủ Việt Nam.
Bản cập nhật này bao gồm các thay đổi về dữ liệu hành chính từ những nghị quyết sau:

Decree	Issued date	Effective date	Description
1202/NQ-UBTVQH15	28/09/2024	01/11/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Tiền Giang giai đoạn 2023-2025
1196/NQ-UBTVQH15	28/09/2024	01/11/2024	Nghị quyết vv sắp xếp đơn vị hành chính cấp xã của tỉnh Khánh Hòa giai đoạn 2023-2025
1192/NQ-UBTVQH	28/09/2024	01/11/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của thành phố Cần Thơ giai đoạn 2023-2025
1195/NQ-UBTVQH15	28/09/2024	01/11/2024	Về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Gia Lao giai đoạn 2023-2025
1200/NQ-UBTVQH15	28/09/2024	01/11/2024	Nghị quyết vv sắp xếp đơn vị hành chính cấp xã của tỉnh Phú Yên giai đoạn 2023-2025
1197/NQ-UBTVQH15	28/09/2024	01/11/2024	Nghị quyết vv sắp xếp đơn vị hành chính cấp xã của tỉnh Lào Cai giai đoạn 2023-2025
1194/NQ-UBTVQH15	28/09/2024	01/11/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Đồng Nai giai đoạn 2023-2025
1199/NQ-UBTVQH15	28/09/2024	01/11/2024	Nghị quyết vv sắp xếp đơn vị hành chính cấp huyện, cấp xã của tỉnh Quảng Ninh giai đoạn 2023-2025
1203/NQ-UBTVQH15	28/09/2024	01/11/2024	Nghị quyết vv sắp xếp đơn vị hành chính cấp ã của tỉnh Vĩnh Long giai đoạn 2023-2025
1201/NQ-UBTVQH15	28/09/2024	01/11/2024	Nghị quyết vv sắp xếp đơn vị hành chính cấp xã của tỉnh Thải Bình giai đoạn 2023-2025
1198/NQ-UBTVQH15	28/09/2024	01/11/2024	Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã của tỉnh Ninh Thuận giai đoạn 2023-2025
1193/NQ-UBTVQH15	28/09/2024	01/11/2024	Nghị quyết vv sắp xếp đơn vị hành chính cấp xã của tỉnh Đăk Lăk giai đoạn 2023- 2025

Chi tiết cụ thể xin xem tại đây Nghị quyết về sắp xếp đơn vị hành chính tại 63 tỉnh, thành phố giai đoạn 2023-2025

Vá lỗi thiếu 5 quận/huyện không có phường xã

Do sơ suất, bộ dữ liệu đã không quét qua các quận huyện không có chia hệ thống phường xã. Nay chúng tôi đã sửa lại API lấy dữ liệu từ DVHCVN SOAP API để đảm bảo lấy đủ ba operation services để đảm bảo tình trạng này không còn xảy ra.
Xin trân trọng gửi lời cảm ơn đến bạn @haiau với phát hiện quan trọng trên trong #68.

📌 Thông báo về cập nhật trên bộ dữ liệu hiện tại

Do có quá nhiều thay đổi phức tạp trên nghị quyết 1104/NQ-UBTVQH15 và số lượng nghị quyết quá dày đặc trong thời gian ngắn, tác giả của dự án không kịp tung ra bản vá (data patch) đối với bộ dữ liệu SQL cho người dùng sử dụng bộ dữ liệu phiên bản cũ.
Các bạn vui lòng chờ thêm trong ít ngày nhé. Tác giả sẽ sớm cập nhật trong thời gian sớm nhất.

English version

This release patch update the existing dataset to the most recently effective decree 1203/NQ-UBTVQH15

📜 Nghị quyết 1106/NQ-UBTVQH15

📜 Bản cập nhật dữ liệu từ nghị quyết 1104/NQ-UBTVQH15, 1105/NQ-UBTVQH15 và 1106/NQ-UBTVQH15

Đây là bản cập nhật dữ liệu từ nghị quyết 1104/NQ-UBTVQH15, 1105/NQ-UBTVQH15 và 1106/NQ-UBTVQH15 của Chính phủ Việt Nam.
Bản cập nhật này bao gồm các thay đổi về dữ liệu hành chính từ những nghị quyết sau:

Nghị quyết 1104/NQ-UBTVQH15

Nghị quyết về việc sắp xếp đơn vị hành chính cấp huyện, cấp xã giai đoạn 2023-2025 của tỉnh Nam Định
Ngày ban hành: 23/07/2024
Ngày có hiệu lực: 01/09/2024
Chi tiết xem tại: 1104/NQ-UBTVQH15

Nghị quyết 1105/NQ-UBTVQH15

Nghị quyết về việc sắp xếp đơn vị hành chính cấp xã giai đoạn 2023-2025 của tỉnh Sóc Trăng
Ngày ban hành: 23/07/2024
Ngày có hiệu lực: 01/09/2024
Chi tiết xem tại: 1105/NQ-UBTVQH15

Nghị quyết 1106/NQ-UBTVQH15

Nghị quyết sắp xếp đơn vị hành chính cấp xã giai đoạn 2023-2025 của tỉnh Tuyên Quang
Ngày ban hành: 23/07/2024
Ngày có hiệu lực: 01/09/2024
Chi tiết xem tại: 1106/NQ-UBTVQH15

📌 Thông báo về cập nhật trên bộ dữ liệu hiện tại

Do có quá nhiều thay đổi phức tạp trên nghị quyết 1104/NQ-UBTVQH15, và để đảm bảo việc bộ dữ liệu được cập nhật mới nhất, tác giả của dự án không kịp tung ra bản vá (data patch) đối với bộ dữ liệu SQL cho người dùng sử dụng bộ dữ liệu phiên bản cũ.
Đối với người dùng đang sử dụng bộ dữ liệu trước ngày release hôm nay (v2.1.0), các bạn vui lòng chờ thêm trong ít ngày nhé. Tác giả sẽ sớm cập nhật dưới tag v2.1.1 trong thời gian sớm nhất.

English version

This release patch update the existing dataset to the most recently effective decree 1106/NQ-UBTVQH15.
Due to a lot of complicated changes introduce in the decree 1104/NQ-UBTVQH15, I cannot create the migration patch for the existing SQL dataset.
I'm working my way on the migration patch and will issue the new minor version release soon under tag v2.1.1. Please stay tune in a few more days.

📜 Nghị quyết 1013/NQ-UBTVQH15 & 1012/NQ-UBTVQH15

📜 Bản cập nhật dữ liệu từ nghị quyết 1012/NQ-UBTVQH15 và 1013/NQ-UBTVQH15

Đây là bản cập nhật dữ liệu từ nghị quyết 1012/NQ-UBTVQH15 và 1013/NQ-UBTVQH15 của Chính phủ Việt Nam.
Bản cập nhật này bao gồm các thay đổi về dữ liệu hành chính từ những nghị quyết sau

Nghị quyết 1012/NQ-UBTVQH15

Nghị quyết vv thành lập phường An Điền, phường An Tây thuộc thị xã Bến Cát và thành lập thành phố Bến Cát, tỉnh Bình Dương
Ngày ban hành: 19/03/2024
Ngày có hiệu lực: 01/05/2024
Chi tiết xem tại: 1012/NQ-UBTVQH15

Nghị quyết 1013/NQ-UBTVQH15

Nghị quyết về việc sắp xếp, thành lập các phường thuộc thị xã Gò Công và thành lập thành phố Gò Công, tỉnh Tiền Giang
Ngày ban hành: 19/03/2024
Ngày có hiệu lực: 01/05/2024
Chi tiết xem tại: 1013/NQ-UBTVQH15

Hướng dẫn cập nhật

Đối với các bộ dữ liệu đã được tạo từ trước thời điểm của bản vá này, bạn có thể cập nhật bằng cách chạy trực tiếp tệp patch 1012_1013_NQ-UBTVQH15_patch.sql

📌 Quan trọng
Nghị định 1013/NQ-UBTVQH15 có một thay đổi quan trọng về việc nhập phường của Thành phố Gò Công như sau

a) Nhập toàn bộ diện tích tự nhiên là 1,36 km2 và quy mô dân số là 10.228 người của Phường 4 vào Phường 1. Sau khi nhập, Phường 1 có diện tích tự nhiên là 1,81 km2 và quy mô dân số là 19.589 người.

Phường 1 giáp Phường 2, Phường 5, phường Long Chánh và phường Long Hưng;

b) Nhập toàn bộ diện tích tự nhiên là 1,09 km2 và quy mô dân số là 9.992 người của Phường 3 vào Phường 2. Sau khi nhập, Phường 2 có diện tích tự nhiên là 1,80 km2 và quy mô dân số là 19.500 người.

Phường 2 giáp Phường 1, Phường 5, phường Long Hưng và phường Long Thuận.

Vậy nên, bạn hãy cập nhật lại danh mục đang trỏ reference trên dữ liệu của bạn đến Phường 4 và Phường 3, và thay bằng Phường 1 và Phường 2. Vì Phường 4 và Phường 3 của Thành phố Gò Công sẽ bị xoá khỏi tập dữ liệu này sau thời gian nghị định 1013/NQ-UBTVQH15 có hiệu lực (01/05/2024)

// Đổi địa chỉ từ Phường 4 (28300) sang Phường 1 (28303)
UPDATE <your_table> SET ward = '28303' WHERE ward = '28300';
// Đổi địa chỉ từ Phường 3 (28294) sang Phường 2 (28297)
UPDATE <your_table> SET ward = '28294' WHERE ward = '28297'

---

Xem hướng dẫn kiểm tra và cập nhật trạng thái bộ dữ liệu

English version

This release patch update the existing dataset to the most recently effective decree 939/NQ-UBTVQH15
How to run: Execute the patch 938_939_NQ-UBTVQH15_patch.sql directly

Check out How to update the existing dataset to check your current dataset status and apply this patch manually (if required)