如何快速获取中国行政区划数据:5个实用技巧实现JSON与CSV格式无缝转换

张开发
2026/4/20 15:01:53 15 分钟阅读

分享文章

如何快速获取中国行政区划数据:5个实用技巧实现JSON与CSV格式无缝转换
如何快速获取中国行政区划数据5个实用技巧实现JSON与CSV格式无缝转换【免费下载链接】Administrative-divisions-of-China中华人民共和国行政区划省级省份、 地级城市、 县级区县、 乡级乡镇街道、 村级村委会居委会 中国省市区镇村二级三级四级五级联动地址数据。项目地址: https://gitcode.com/gh_mirrors/ad/Administrative-divisions-of-China你是否在开发需要地址选择器的应用或者在进行地理数据分析时需要准确的行政区划信息Administrative-divisions-of-China 这个开源项目为你提供了完整的解决方案。它包含了中国五级行政区划数据支持JSON和CSV两种格式的无缝转换让数据获取变得前所未有的简单。 项目核心价值解决实际开发痛点在开发涉及地址信息的应用时我们常常面临几个关键问题数据来源不统一- 不同平台的数据格式各异更新维护困难- 行政区划每年都在变化格式转换繁琐- 需要在JSON、CSV等多种格式间切换层级关系复杂- 五级联动数据难以手动整理Administrative-divisions-of-China 正是为解决这些问题而生。它提供了从省级到村级的完整行政区划数据包含34个省份、333个城市、2,851个区县、39,888个乡镇和662,238个村居的详细信息。 5分钟快速上手从零到数据导出第一步环境准备与项目克隆# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/ad/Administrative-divisions-of-China cd Administrative-divisions-of-China # 安装项目依赖 npm install第二步一键导出JSON格式数据如果你需要JSON格式的行政区划数据只需运行npm run json执行后你将在dist目录下获得以下文件文件类型文件名数据内容省级数据provinces.json34个省级行政区划地级数据cities.json333个地级市数据县级数据areas.json2,851个区县信息乡级数据streets.json39,888个乡镇街道村级数据villages.json662,238个村居委会第三步一键导出CSV格式数据如果你需要CSV格式用于Excel或其他表格软件npm run csvCSV文件同样生成在dist目录下包含完整表头可以直接用Excel打开code,name,provinceCode 110000,北京市, 120000,天津市, 130000,河北省, 数据结构深度解析理解五级联动关系了解数据结构是高效使用数据的关键。中国行政区划采用标准的五级编码体系行政编码规则每个行政区域都有一个唯一的6位数字编码前2位省级代码中间2位地级代码后2位县级代码对于乡级和村级会有更长的编码来标识更精确的位置关系。JSON数据结构示例让我们看看省级数据的实际结构[ { code: 110000, name: 北京市 }, { code: 120000, name: 天津市 } ]地级数据则包含省级关联[ { code: 110101, name: 东城区, provinceCode: 110000 } ]五级联动数据关系┌─────────────────────────────────────────────────────────────┐ │ 中华人民共和国行政区划 │ └─────────────────────────────────────────────────────────────┘ │ ┌───────────────────┼───────────────────┐ │ │ │ ┌─────▼─────┐ ┌─────▼─────┐ ┌─────▼─────┐ │ 省级行政区 │ │ 省级行政区 │ │ 省级行政区 │ │ (34个) │ │ (34个) │ │ (34个) │ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ │ │ │ ┌─────▼─────┐ ┌─────▼─────┐ ┌─────▼─────┐ │ 地级行政区 │ │ 地级行政区 │ │ 地级行政区 │ │ (333个) │ │ (333个) │ │ (333个) │ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ │ │ │ ┌─────▼─────┐ ┌─────▼─────┐ ┌─────▼─────┐ │ 县级行政区 │ │ 县级行政区 │ │ 县级行政区 │ │ (2,851个) │ │ (2,851个) │ │ (2,851个) │ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ │ │ │ ┌─────▼─────┐ ┌─────▼─────┐ ┌─────▼─────┐ │ 乡级行政区 │ │ 乡级行政区 │ │ 乡级行政区 │ │ (39,888个) │ │ (39,888个) │ │ (39,888个) │ └─────┬─────┘ └─────┬─────┘ └─────┬─────┘ │ │ │ ┌─────▼─────┐ ┌─────▼─────┐ ┌─────▼─────┐ │ 村级行政区 │ │ 村级行政区 │ │ 村级行政区 │ │ (662,238个)│ │ (662,238个)│ │ (662,238个)│ └───────────┘ └───────────┘ └───────────┘ 高级技巧自定义数据导出与处理一次性导出所有格式如果你需要同时获得JSON和CSV格式的数据可以使用build命令npm run build这个命令会依次执行数据格式转换确保所有文件同步更新。使用SQLite数据库项目还提供了SQLite数据库文件dist/data.sqlite你可以使用SQL查询灵活处理数据-- 查询某个省份的所有城市 SELECT * FROM cities WHERE provinceCode 110000; -- 查询某个城市的所有区县 SELECT * FROM areas WHERE cityCode 110100;自定义数据筛选你可以基于导出的数据进行二次处理比如只导出特定省份的数据// 示例筛选广东省的数据 const fs require(fs); const provinces JSON.parse(fs.readFileSync(dist/provinces.json, utf8)); const guangdong provinces.find(p p.name 广东省); console.log(guangdong); 实战应用场景从理论到实践场景一Web地址选择器开发如果你正在开发电商、物流或用户注册系统需要一个省市区三级联动选择器// 使用JSON数据快速构建地址选择器 fetch(dist/pca.json) .then(response response.json()) .then(data { // 数据已经按照层级组织好 // 可以直接用于前端地址选择组件 });场景二数据分析与可视化在进行区域数据分析时CSV格式的数据可以直接导入到Excel、Tableau等工具中使用npm run csv导出CSV文件用Excel打开dist/provinces.csv进行数据透视表分析制作区域分布图表场景三数据库迁移与集成如果你需要将数据集成到现有系统中导出CSV格式数据使用数据库导入工具如MySQL的LOAD DATA INFILE建立表关联关系实现API接口供应用调用场景四移动应用开发移动应用通常需要本地存储行政区划数据// React Native示例 import provinces from ./dist/provinces.json; import cities from ./dist/cities.json; // 在应用启动时加载数据 const loadAddressData async () { // 可以按需加载减少初始包体积 }; 最佳实践与注意事项数据更新策略虽然项目数据更新至2023年但在实际使用时需要注意定期检查更新- 行政区划每年都有调整数据验证- 在生产环境使用前进行数据验证备份原始数据- 保留一份原始数据用于对比性能优化建议处理大量数据时考虑以下优化按需加载不要一次性加载所有层级数据缓存机制对频繁访问的数据进行缓存增量更新只更新发生变化的数据常见问题解决Q: 数据文件太大怎么办A: 可以按需导出特定层级或特定省份的数据减少文件体积。Q: 如何获取特定格式的数据A: 项目支持JSON和CSV两种格式可以根据需要选择。Q: 数据准确性如何保证A: 数据来源于官方统计但行政区划会有变动建议结合实际业务需求进行验证。 总结让行政区划数据使用变得简单Administrative-divisions-of-China 项目通过简洁的命令行工具解决了中国行政区划数据获取和格式转换的难题。无论你是需要JSON格式用于前端开发还是CSV格式用于数据分析都能通过简单的命令快速获得所需数据。记住这5个核心技巧一键导出- 使用npm run json或npm run csv格式转换- 支持JSON和CSV无缝切换层级完整- 覆盖五级行政区划数据关系明确- 清晰的父子级关联关系灵活使用- 支持自定义筛选和处理现在就开始使用这个强大的工具让你的项目开发更加高效吧无论是构建地址选择器、进行地理数据分析还是开发需要行政区划信息的应用Administrative-divisions-of-China 都能为你提供可靠的数据支持。【免费下载链接】Administrative-divisions-of-China中华人民共和国行政区划省级省份、 地级城市、 县级区县、 乡级乡镇街道、 村级村委会居委会 中国省市区镇村二级三级四级五级联动地址数据。项目地址: https://gitcode.com/gh_mirrors/ad/Administrative-divisions-of-China创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

更多文章