vietnam-location-data
收藏越南行政区划数据
数据集概述
这是一个全面的、结构化的越南行政区划数据库，包含省份、区县、坊社、邮政编码和电话区号。
数据内容
- 63个省份和中央直辖市（Tỉnh/Thành phố trực thuộc Trung ương）
- 区、县、市、镇（Quận/Huyện/Thị xã/Thành phố）
- 坊、社、市镇（Phường/Xã/Thị trấn）
- 邮政编码（Mã bưu chính）
- 电话区号（Mã vùng điện thoại）
- 地理区域和描述
数据结构
项目结构
vietnam-location-data/ └── VN/ ├── HaNoi/ │ └── HaNoi.json ├── HoChiMinh/ │ └── HoChiMinh.json ├── DaNang/ │ └── DaNang.json ├── CaMau/ │ └── CaMau.json └── ... (共63个省份)
数据层级结构
省级数据
json { "province": { "id": "VN-HN", "code": "HN", "name": "Hà Nội", "type": "Thành phố trực thuộc Trung ương", "region": "Miền Bắc", "slug": "ha-noi", "description": "可选描述", "area_code": "024", "postal_code": { "type": "range", "value": ["100000", "150000"], "note": "可选备注" } }, "units": [ /* 区县数组 */ ] }
区县级数据
json { "id": "HN-BD", "code": "BD", "name": "Ba Đình", "type": "Quận", "type_code": "URBAN_DISTRICT", "area_code": "024", "postal_code": ["111000", "111999"], "note": "可选备注", "wards": [ /* 坊社数组 */ ] }
坊社级数据
json { "id": "HN-BD-PH", "code": "PH", "name": "Phúc Xá", "type": "Phường", "type_code": "WARD", "postal_code": "111100", "note": "可选备注" }
类型代码
省份类型
- Thành phố trực thuộc Trung ương: 中央直辖市（河内、胡志明市、岘港、芹苴、海防）
- Tỉnh: 省份
区县类型
- URBAN_DISTRICT (Quận): 城市区
- RURAL_DISTRICT (Huyện): 农村县
- MUNICIPAL_CITY (Thành phố): 直辖市
- CITY (Thành phố): 城市
- TOWN (Thị xã): 镇
坊社类型
- WARD (Phường): 坊（城市区域）
- COMMUNE (Xã): 社（农村区域）
- TOWNSHIP (Thị trấn): 市镇
地理区域
越南主要分为以下区域：
- Miền Bắc: 越南北部
- Miền Trung: 越南中部
- Miền Nam: 越南南部
- Đồng bằng sông Cửu Long: 湄公河三角洲
- Duyên hải Nam Trung Bộ: 中南沿海地区
可用省份
越南北部（Miền Bắc）
- 河内（HN）
- 海防（HP）
- 兴安（HY）
- 北宁（BN）
- 太原（TN）
- 谅山（LS）
- 高平（CB）
- 老街（LC）
- 奠边（DB）
- 莱州（LC）
- 山罗（SL）
- 富寿（PT）
- 宣光（TQ）
- 宁平（NB）
- 清化（TH）
- 乂安（NA）
- 河静（HT）
越南中部（Miền Trung）
- 岘港（DN）
- 顺化（HU）
- 广治（QT）
- 广义（QN）
- 庆和（KH）
- 林同（LD）
- 得乐（DL）
- 嘉莱（GL）
越南南部（Miền Nam）
- 胡志明市（SG）
- 同奈（DN）
- 平阳（BD）
- 西宁（TN）
- 隆安（LA）
- 前江（TG）
- 槟椥（BT）
- 茶荣（TV）
- 永隆（VL）
- 同塔（DT）
- 安江（AG）
- 坚江（KG）
- 芹苴（CT）
- 后江（HG）
- 朔庄（ST）
- 薄寮（BL）
- 金瓯（CM）
数据集特性
- 完整的行政区划层级（省 → 区县 → 坊社）
- 每个行政单位具有唯一ID
- 越南语和ASCII slug名称
- 邮政编码（单值和范围）
- 电话号码区号
- 带有标准化代码的类型分类
- 区域分组
- 可选描述和备注
- UTF-8编码，支持越南语字符
数据质量
- 所有数据遵循一致的JSON结构
- 每个行政单位具有唯一标识符
- 主要城市的邮政编码已验证
- 电话区号截至2025年准确
- 数据定期维护和更新
使用案例
- 地址自动补全系统
- 电子商务运输表单
- 政府应用程序
- 地理数据分析
- 基于位置的服务
- 邮政编码验证
- 电话号码验证
数据统计
- 63 个省份/城市
- 700+ 个区县
- 10,000+ 个坊社/公社
- 完整的邮政编码覆盖
- 完整的电话区号映射
许可证
该项目为开源项目，可供公共使用。如在项目中使用此数据，请注明来源。
链接
- 仓库地址：https://github.com/AlexanderPhan04/vietnam-location-data
- 问题反馈：https://github.com/AlexanderPhan04/vietnam-location-data/issues
最后更新：2025年12月
