全国五级行政区划数据集。
如果你做过电商、物流、政务系统,应该都遇到过这种情况,产品经理一句话:“我们要做地址选择功能,要从省一直选到村。”
听起来不复杂,真动手你就知道坑有多深:
-
数据东拼西凑,不完整、不统一;
-
有的省市对不上,有的区县找不到;
-
乡镇、村级信息更是稀缺;
-
格式乱七八糟,还得自己清洗、转换、建表……
我就踩过一次这个坑,硬是搞了三天才凑齐能用的版本,差点被劝退。
Administrative-divisions-of-China
偶然之中发现这个项目:Administrative-divisions-of-China,真的是独立开发者的及时雨。

它直接帮你把全国的行政区划,从省级到村级,一共五个层级,全都整理好,而且是2023年6月30日最新版的数据,来源于国家统计局,权威又可靠。

具体包括:
-
省级(省份、直辖市、自治区)
-
地级(城市)
-
县级(区县)
-
乡级(乡镇、街道)
-
村级(村委会、居委会)
数据格式全家桶,直接开箱即用

它不只是给你原始数据,还帮你准备好了各种实用格式:
-
JSON(provinces.json, cities.json, areas.json, streets.json, villages.json)
-
CSV(同上)
-
联动数据(pc.json, pca.json, pcas.json)
-
SQLite 数据库(data.sqlite)
什么意思呢? 就是你完全不用自己爬、自己转、自己建表,直接下载就能用。
开发示例:三级/五级联动秒实现
比如做三级联动,只需要几行代码:
import pcaData from './pca.json';
const provinces = pcaData;
const cities = provinces.find(p => p.code === selectedProvince).children;
const areas = cities.find(c => c.code === selectedCity).children;
五级联动?没问题,它也有对应的完整数据。 而且还有带行政区划代码的版本(pca-code.json),方便你做数据库关联。
如果需要 MySQL、Oracle、MSSQL 版本?直接用 SQLite 导出迁移就行,连字段结构都帮你设计好了。
节省的不只是时间
以前整理这类数据,可能要花 3~5 天;现在,下载导入,十分钟就搞定。 省下的时间,可以去写更多业务逻辑,甚至…摸一会儿鱼。
适用场景更是多到数不清:
-
电商地址选择
-
物流区域管理
-
人员信息管理系统
-
地图应用
-
数据分析和可视化
-
政务系统
总结
这种基础数据,自己整理真的费时又费力。
有人愿意帮我们做好、维护好,还免费开源出来,这就是对开发者最大的善意。
兄弟们,别瞎折腾了,现成的轮子不香吗?
项目地址:https://github.com/modood/Administrative-divisions-of-China