VietNam Regions Database

github2025-02-05 更新2025-02-11 收录

下载链接：

https://github.com/minhsangdotcom/vietnam-regions-data

下载链接

链接失效反馈

官方服务：

资源简介：

越南各级行政单位详细数据集

Detailed Dataset of Vietnamese Administrative Divisions at All Levels

创建时间：

2025-02-05

原始信息汇总

VietNam Regions Database

概述

本项目旨在详细统计越南的省、市、区、街道等各级数据。数据以JSON和SQL文件格式提供，既多样化数据输出方式，又便于用户更好地定制表格、列以及数据库类型。

数据来源

数据来源于越南官方统计网站 https://danhmuchanhchinh.gso.gov.vn/。

项目结构

项目以Web API形式编写，主要包括两个API：

/api/regions/generateJson：用于输出JSON文件。
/api/regions/generateSqlQuery：用于输出SQL文件。

输出文件位于 Outputs 目录。

数据预览

SQL文件预览

sql INSERT INTO province (administrative_unit_id,code,custom_name,english_full_name,english_name,full_name,id,name) VALUES (1,01,,Ha Noi City,Ha Noi,Thành phố Hà Nội,01JK3AAK5QVBK9ZXK5TVDM9A8P,Hà Nội), (2,02,,Ha Giang Province,Ha Giang,Tỉnh Hà Giang,01JK3AAK6N8FV2H74J8YJY05TQ,Hà Giang), (2,04,,Cao Bang Province,Cao Bang,Tỉnh Cao Bằng,01JK3AAK6ZDKK09S689J71M9CR,Cao Bằng), (2,06,,Bac Kan Province,Bac Kan,Tỉnh Bắc Kạn,01JK3AAK76EYXQFYD6TWEZW5ZW,Bắc Kạn), (2,08,,Tuyen Quang Province,Tuyen Quang,Tỉnh Tuyên Quang,01JK3AAK7BTRQK88R69C84P3HY,Tuyên Quang), (2,10,,Lao Cai Province,Lao Cai,Tỉnh Lào Cai,01JK3AAK7KX2S8PMXZAQHQ5KD2,Lào Cai), (2,11,,Dien Bien Province,Dien Bien,Tỉnh Điện Biên,01JK3AAK7S82EXXCXYX08HGVEF,Điện Biên), (2,12,,Lai Chau Province,Lai Chau,Tỉnh Lai Châu,01JK3AAK80E2QZQ8P63HJ40SMQ,Lai Châu), (2,14,,Son La Province,Son La,Tỉnh Sơn La,01JK3AAK85JGABP3XDCP5CCYRE,Sơn La), (2,15,,Yen Bai Province,Yen Bai,Tỉnh Yên Bái,01JK3AAK8EA93JB1NVE4BJ0QZK,Yên Bái), (2,17,,Hoa Binh Province,Hoa Binh,Tỉnh Hoà Bình,01JK3AAK8QXYM018HC5YQQ4M9C,Hoà Bình);

JSON文件预览

json { "sqlGenerationPath": null, "updateMetaData": null, "provinceMetaData": { "path": "\Outputs\Provinces.json", "total": 63 }, "districtMetaData": { "path": "\Outputs\Districts.json", "total": 701 }, "wardMetaData": { "path": "\Outputs\Wards.json", "total": 10333 }, "administrativeUnitData": { "path": "\Outputs\AdministrativeUnits.json", "total": 10 } }

数据库结构

Schema

使用说明

克隆项目。
运行以下命令启动项目：

bash cd VietNamRegion dotnet run

转到Database目录并运行 create_table.sql 文件以创建数据结构。

配置

在 appsettings.Development.json 中进行配置。

数据库设置

json "DbSetting": "SqlServer",

支持的数据库类型：

Mysql
PostgreSql
SqlServer
OracleSql

表名和列名自定义

json "ProvinceConfigs": { "TableName": "province", "ColumnNames": { "Id": "Id", "Code": "Code", "Name": "Name", "EnglishName": "EnglishName", "FullName": "FullName", "EnglishFullName": "EnglishFullName", "CustomName": "CustomName", "AdministrativeUnitId": "AdministrativeUnitId" } },

性能测试

使用 /api/regions/generateJson API 在2秒内生成JSON文件。
使用 /api/regions/generateSqlQuery API 在2秒内生成SQL文件。

目的

本项目旨在帮助用户轻松获取省、市、区、街道的数据，避免手动抓取数据或使用Web Scraping。

许可

本项目使用 MIT License。

搜集汇总

数据集介绍

构建方式

VietNam Regions Database 数据集的构建基于越南官方统计网站提供的行政单位数据。数据集通过Web API的形式生成，包含两个主要API：/api/regions/generateJson 用于生成JSON文件，/api/regions/generateSqlQuery 用于生成SQL文件。数据以JSON和SQL格式存储，不仅多样化输出数据形式，而且允许更好地自定义table、column和数据类型。

使用方法

使用该数据集时，用户首先需要从越南官方统计网站获取Excel格式的数据，然后通过提供的Web API将数据转换为JSON或SQL格式。用户可以根据需要选择不同的API来获取数据，并通过配置文件自定义数据表和列的名称。此外，数据集还支持数据的增量更新，通过比较新旧数据生成变更记录，以便用户进行数据同步。

背景与挑战

背景概述

VietNam Regions Database是一个旨在详细统计越南各省市、区县、街道等行政区域数据的项目。该项目创建于[https://danhmuchanhchinh.gso.gov.vn/](https://danhmuchanhchinh.gso.gov.vn/)，这是一个越南官方的统计数据网站。项目以Web API的形式呈现，主要包括两个API：/api/regions/generateJson用于输出JSON文件，/api/regions/generateSqlQuery用于输出SQL文件。该数据库不仅数据输出形式多样，而且允许用户更好地自定义表、列和数据类型。项目由专业的数据人员创建，为相关领域的研究提供了极大的便利，对越南行政区域的研究具有一定的推动作用。

当前挑战

该数据集在构建过程中遇到的挑战主要包括：1) 如何确保数据的准确性和及时更新，由于行政区域划分可能会发生变化，因此需要有一种机制来跟踪和反映这些变化；2) 构建一个既能够灵活输出不同格式数据，又能高效处理数据更新的系统。具体的技术挑战包括数据的一致性维护、数据库性能优化以及API的高效响应。

常用场景

经典使用场景

VietNam Regions Database 数据集被广泛用于需要详细越南行政区划数据的研究和项目中。其经典的使用场景包括在地理信息系统（GIS）中作为基础数据层，以及在需要分析和处理越南各级行政单位数据的统计分析应用中。数据集提供了越南的省、市、区、街道等多级行政区划信息，能够满足不同粒度的数据需求。

解决学术问题

该数据集解决了在学术研究中对越南行政区划数据的获取和处理问题。它为研究者提供了结构化的省、市、区、街道数据，使得研究者能够轻松地进行空间分析、人口统计研究、经济发展评估等学术工作，从而提高了研究的质量和效率。

实际应用

在实际应用中，VietNam Regions Database 数据集可用于政府行政管理、城市规划、市场分析、资源分配等多个领域。例如，政府机构可以使用此数据集来优化行政区划管理，企业则可以利用它进行市场细分和目标客户分析。

数据集最近研究