中国行政区划五级数据开源库:2.1 万 Star,省市区镇村一键联动(附下载)
【导语】做地址选择、区域统计、快递下单,总绕不开省市区县这一堆数据。Administrative-divisions-of-China 是 2.1 万 Star 的中国行政区划五级开源数据集,省市区镇村全都有,JSON/CSV/SQLite 直接下载。但要提醒:数据已停更在 2023 年,用前先看文末说明。
一、这是什么?五级行政区划全都有
它是开发者 modood 维护的一份中国行政区划开源数据集,把全国划分成五个层级:省级(省/直辖市/自治区)、地级(城市)、县级(区县)、乡级(乡镇街道)、村级(村委会居委会)。
数据来自国家统计局。项目目前有约 2.1 万 Star、7.2K Fork,是同类中文地址数据里用得最广的一份,采用 WTFPL 协议——近乎无限制,基本可以随意使用。
二、提供哪些数据?格式齐全
它把每一级数据都单独导出成 JSON 和 CSV 两种格式,方便直接进前端或数据库:
- 单级数据:provinces(省)、cities(市)、areas(区县)、streets(乡镇街道)、villages(村),每级一个 JSON + 一个 CSV;
- 联动数据:pc(省+市二级)、pca(省市县三级)、pcas(省市县乡四级),每种都另有一份带 -code 编码的版本,做地址联动组件直接拿来用;
- 数据库:自带 data.sqlite,可自行迁移到 MySQL、Oracle、MSSQL 等;
- 打包下载:Releases 页面能一次下载全部文件,不用逐个抓。
三、典型用途
只要你的业务涉及"中国地址",这份数据基本都能派上用场:
- 网页/APP 里的省市区三级、四级地址联动选择器;
- 订单、快递、用户资料里的省市区县结构化存储与校验;
- 区域销售统计、地图可视化、按区域做数据看板;
- 需要行政区划代码(六位/九位/十二位)的报表与系统对接。
四、怎么用?(三步上手)
第一步:到 GitHub 仓库的 dist 目录按需要下载 JSON/CSV,或到 Releases 打包下载全部。
第二步:前端项目直接把 pc.json / pca.json 放进静态资源,写联动组件读取;后端把数据导入数据库,按 code 字段(如 13=河北省、1301=石家庄市、130111=栾城区)建立关联。
第三步:如果只要部分层级,用现成的单级文件即可;要完整层级就用联动文件或 sqlite 库自己查。
五、两个必须知道的坑
数据已经停更。仓库明确写着"本项目数据不再更新",最后更新到 2023 年统计用区划代码(截止 2023-06-30,发布 2023-09-11)。原因是自 2024 年 10 月起,国家统计局不再公开具体区划代码,只公开标准方法。也就是说,近两年新设、撤并、改名的区县可能不在里面——对数据准确性要求高的场景,务必先用最新官方名录核对、补齐。
五级联动没有现成文件。村级数据只有单级文件(villages),官方联动包只做到四级(pcas),需要省市县乡村五级联动的话得自己按 code 关系拼。
项目地址:github.com/modood/Administrative-divisions-of-China(仓库搜索 modood/AdmiNISTrative-divisions-of-China 即可找到,数据与说明均在仓库内)
关注格熊,持续分享最新免费资源!
- 随机文章
- 热门文章
- 热评文章
- 介绍一款无广告、无流氓、无捆绑、无后门的纯净PE工具,装系统必备
- 设计小技巧:排布元素的时候要学会“透气”
- 小米召开春季发布会,这样的安卓机皇你可满意?
- 微软福利,教大家怎么把 Win 7 免费升级到 Windows 10
- 导学号APP(安卓)一款专为中小学生打造的专业辅导软件,免费
- 云豹录屏(电脑)一款非常不错的免费录屏软件,体积小巧方便
- 免费字体网站,附289款免费可商用中文字体合集下载
- 微信小号要来了!无需绑定手机号!
扫描二维码推送至手机访问。
版权声明:本文由格熊发布,如需转载请注明出处。
免责声明:本站收集的内容,都来自网络,版权争议与本站无关。







