中国行政区划五级数据开源库: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 即可找到,数据与说明均在仓库内)
关注格熊,持续分享最新免费资源!
- 随机文章
- 热门文章
- 热评文章
- iPhone 端的微信通知有延迟怎么办?这样设置能立马解决!
- Windows 10 21H2 太阳谷更新镜像发布,带你抢先体验(附下载)
- 这年头,信息差就是赚钱利器,你掌握了哪些信息差?
- AnyTXT Searcher 一款强大免费的文件搜索软件
- Windows 11 TPM 2.0 要求突然让虚拟机用户被锁定
- 换新手机了?30秒一键迁移手机数据,连微信聊天记录都能迁!
- 刚刚,微软决定将Edge浏览器改成Edge OS
- 一份好的学习资源就等于领路人,B站百万关注的优质资源合集!免费分享
扫描二维码推送至手机访问。
版权声明:本文由格熊发布,如需转载请注明出处。
免责声明:本站收集的内容,都来自网络,版权争议与本站无关。






