vietnamese-provinces-database

一键获取越南省县乡数据，快速构建本地化地图应用。

这是一个为越南行政区划量身打造的开源数据集，覆盖了从省级、县级到乡级的完整行政单位信息，并附带GIS地理空间边界数据。它解决了开发者在构建越南本地化应用时，因行政区划数据分散、格式不一而导致的整合难题。项目提供结构化的SQL脚本，方便直接导入主流关系型数据库，同时支持GIS格式，可用于地图渲染和空间分析。其核心能力在于数据的系统性、规范性和易用性，开发者无需从零收集和清洗数据，即可快速集成越南行政区划功能，从而节省大量开发时间，专注于业务逻辑。

开源 free 数据集

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1805

维护状态活跃

是否开源是

定价模式 free

项目数据

分类数据集

开发团队thanglequoc

所属国家

官网地址

GitHubhttps://github.com/thanglequoc/vietnamese-provinces-database

定价模式free

价格说明开源数据集，MIT许可证，完全免费，可自由下载使用。

访问状态

是否开源是

开源协议MIT

主要语言PLpgSQL

技术栈/模型database,dataset,districts,geolocation,geospatial,gis-data,locality,postal-code,provinces,vietnam,vietnamese,wards

GitHub 星标★ 1805

30天Star增速

HF 下载量

上线时间2021-11-06 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-10

浏览次数6

使用教程

难度：入门约 10 分钟部署方式：本地安装 5 步

环境要求

已安装并可使用的关系型数据库：PostgreSQL、MySQL/MariaDB、SQL Server 或 Oracle 之一
对应的数据库命令行客户端（如 psql），用于执行仓库中的 SQL 脚本
Git，用于获取仓库中的 SQL 脚本文件
可选：需要地图渲染或空间分析时，准备支持 GIS 数据的数据库环境

安装与启动步骤

1克隆仓库

把仓库拉到本地，建表和导数据的 SQL 脚本都在仓库的数据库目录下。
```
git clone https://github.com/thanglequoc/vietnamese-provinces-database.git
```
2创建数据库

README 要求先创建数据库承载数据；Oracle 可直接使用已有库/schema，无需新建。
```
psql -U postgres -c "CREATE DATABASE vietnamese_administrative_units;"
```

3执行建表脚本

必须先跑建表脚本 CreateTable_vn_units.sql，建立省级、县级、乡级的表结构。

cd vietnamese-provinces-database && psql -U postgres -d vietnamese_administrative_units -f postgresql/CreateTable_vn_units.sql

4导入数据集

再执行 ImportData_vn_units.sql 导入行政区划数据，顺序不能颠倒。

cd vietnamese-provinces-database && psql -U postgres -d vietnamese_administrative_units -f postgresql/ImportData_vn_units.sql

5按数据库换脚本

非 PostgreSQL 用户改选对应目录下的同名脚本：mysql/、sqlserver/、oracle/。

如何确认成功

两个 SQL 脚本执行过程无报错，数据库中可见省份、县、乡相关表且已写入数据。

常见问题

Q：脚本执行顺序可以调换吗？

A：不可以。README 明确要求按顺序执行：先 CreateTable_vn_units.sql 建表，再 ImportData_vn_units.sql 导入数据。

Q：Oracle 用户也需要先创建数据库吗？

A：不必。README 说明 Oracle 用户可以使用已有的数据库或 schema，因为数据库创建方式依赖具体环境。

Q：数据覆盖到什么范围和时点？

A：包含全部 34 个越南省份及其下属县、乡级行政单位，数据依据最新生效法令 30/2026/QH16 更新。

Q：有没有 GIS 地理边界数据？

A：有。项目以 Add-on 形式提供 GIS Dataset，可用于地图渲染与空间分析，但 README 未给出具体导入命令。

注意事项

数据基于越南统计总局官网 API 生成，作者与该机构及越南政府无隶属关系。
四个数据库目录（postgresql、mysql、sqlserver、oracle）脚本名相同，注意别拷贝错方言版本。
仓库自 2022 年持续维护，使用前建议拉取最新版本以获取最新法令对应的数据。

核心亮点

数据完整，覆盖省、县、乡三级行政区划，并包含GIS边界，满足地图应用需求。
提供SQL脚本，可轻松导入PostgreSQL等数据库，与现有系统无缝集成。
基于真实行政数据，定期更新，确保与官方区划调整同步。

不足之处

文档以英文为主，对越南本地开发者之外的群体有一定门槛。
数据更新频率未明确，可能滞后于最新行政调整。

适用场景

开发越南本地化电商或外卖应用，需要按省县乡级联选择地址。
构建越南地图可视化项目，用于展示人口、经济等区域数据。
政府或企业系统需要标准化的越南行政区划代码，用于数据对接。

替代项目

openstreetmap、gadm、vietnam-administrative-division

项目介绍

vietnamese-provinces-database 是数据集领域的开源项目，由 thanglequoc 开发，2021 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,805）位列前 30%，在数据集分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,756 增加到 1,805，净增 49。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。开源数据集，MIT许可证，完全免费，可自由下载使用。

它主要面向的使用场景是：开发越南本地化电商或外卖应用，需要按省县乡级联选择地址。同类可对比的替代方案包括 openstreetmap、gadm、vietnam-administrative-division。

上一篇：colour

下一篇：DataProfiler