# ChinaAddressCrawler

**Repository Path**: li_yu_jiang/ChinaAddressCrawler

## Basic Information

- **Project Name**: ChinaAddressCrawler
- **Description**: 中国行政区划数据（1980-2024年）采集及转换（Java版），含JSON、CSV、SQL、GeoJSON格式，数据来源于中华人民共和国民政部，包括省、市、县三级数据。
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: https://qqtheme.cn
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 7
- **Created**: 2023-03-10
- **Last Updated**: 2026-09-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[//]: # (@formatter:off)

# ChinaAddressCrawler

> [中国行政区域抓取](https://gitee.com/li_yu_jiang/ChinaAddressCrawler)整理，运行环境建议：`OpenJDK 21 + IntelliJ IDEA`

> 国家统计局的数据已失效，放弃之，仅维护来源于国家民政部的数据，包括省级（省/直辖市/自治区/特别行政区）、地级（地级市/地区/自治州/盟）、县级（县/市辖区/县级市/自治县/旗/自治旗/特区/林区/矿区/工农区）。

- 中华人民共和国行政区划（**1980年-2024年民政部公开版本**）数据采集及格式转换程序。
- JSON 文件 [region_mca_{year}.json](./json/region_mca_2023.json) 为历年的中国行政区划的 JSON 格式的数据。
- JSON 文件 [region_mca_data.json](./json/region_mca_data.json) 为历年行政区划数据合并，*每年一更*，可直接用于根据区划代码查询省市区县信息。
- CSV 文件 [region_mca_{year}.csv](./csv/region_mca_2023.csv) 为历年的中国行政区划的 CSV 格式的数据。
- CSV 文件 [region_mca_data.csv](./csv/region_mca_data.csv) 为历年行政区划数据合并，*每年一更*，可直接用于根据区划代码查询省市区县信息。
- SQL 文件 [region_mca_{year}.sql](./sql/region_mca_2023.sql) 为历年的中国行政区划的 MySQL 格式的数据。
- SQL 文件 [region_mca_schema.sql](./sql/region_mca_schema.sql) 为中国行政区划数据的 MySQL 数据库表结构。
- SQL 文件 [region_mca_data.sql](./sql/region_mca_data.sql) 为历年行政区划数据合并，*每年一更*，可直接用于根据区划代码查询省市区县信息。
- GeoJSON 文件 [{code}.geoJson](./GeoJSON/100000.geoJson) 为带经纬度的行政区划数据，可直接用于根据经纬度查询省市区县信息。
- CSV 文件 [ok_data_level4.csv](./csv/ok_data_level4.csv)
  为 [AreaCity-JsSpider-StatsGov](https://gitee.com/xiangyuecn/AreaCity-JsSpider-StatsGov) 采集整理的行政区划数据，涵盖乡镇级别，比较齐全。

## 开放接口

```markdown
# 行政区划搜索接口文档

## 接口描述

行政区划搜索服务根据用户输入的年份和最大查询深度来查询相关的行政区划信息。

## 接口信息

- **接口地址**：`https://dmfw.mca.gov.cn/9095/xzqh/getList`
- **请求方式**：GET

## 请求参数

| 参数名称 | 是否必须 | 类型   | 默认值   | 描述                                                                                                 |
|----------|----------|--------|----------|------------------------------------------------------------------------------------------------------|
| year     | 否       | int    | 最新年版 | 年份，默认为最新年版                                                                                 |
| code     | 否       | String | -        | 行政区划代码                                                                                         |
| maxLevel | 是       | int    | -        | 最大查询深度，最多支持2级深度。0表示仅查询本级，1表示本级及下级区划，2表示查询本级、下级及下下级区划 |

## 响应参数

| 参数名称 | 描述         | 类型     |
|----------|--------------|----------|
| data     | 返回结果集   | Object[] |
| code     | 行政区划代码 | String   |
| name     | 标准名称     | String   |
| level    | 行政区划级别 | int      |
| type     | 行政区划单位 | String   |
| children | 子级行政区划 | Object[] |
| message  | 服务信息     | String   |
| status   | 服务状态码   | int      |
| total    | 总条数       | int      |

## 字段说明

### level（行政区划级别）

| 值 | 含义                                       |
|----|--------------------------------------------|
| 0  | 根节点（全国）                             |
| 1  | 省级（省、直辖市、自治区、特别行政区）     |
| 2  | 地级（地级市、自治州、盟、地区）           |
| 3  | 县级（市辖区、县级市、县、自治县、林区等） |

### type（行政区划单位）

常见取值包括：省、直辖市、自治区、特别行政区、地级市、自治州、盟、地区、市辖区、县级市、县、自治县、林区等。

## 备注

1. `maxLevel` 为必填参数，最多支持 2 级深度。
2. 响应中的 `data` 为树形结构，通过 `children` 字段嵌套子级行政区划。
3. 台湾省数据中 `code` 为 `"资料暂缺"`，`children` 为 `null`。
```

## 参考资料

- [首页>民政数据>统计数据>2024年中华人民共和国县以上行政区划代码](https://www.mca.gov.cn/mzsj/xzqh/2025/202401xzqh.html)
- ~~[首页>民政数据>统计数据>2023年中华人民共和国县以上行政区划代码](https://www.mca.gov.cn/mzsj/xzqh/2023/202301xzqh.html)~~
- ~~[首页>民政数据>统计数据>2022年中华人民共和国县以上行政区划代码](https://www.mca.gov.cn/mzsj/xzqh/2022/202201xzqh.html)~~
- ~~[首页>民政数据>统计数据>2021年中华人民共和国县以上行政区划代码](https://www.mca.gov.cn/mzsj/xzqh/2021/20211201.html)~~
- ~~[首页>民政数据>统计数据>2020年中华人民共和国县以上行政区划代码](https://www.mca.gov.cn/mzsj/xzqh/2020/20201201.html)~~
- [首页>接口服务>行政区划搜索](https://dmfw.mca.gov.cn/interface.html)
- [首页>行政区划代码](https://dmfw.mca.gov.cn/XzqhVersionPublish.html)
- [首页>信息公开>统计标准>国家统计标准>统计用区划代码和城乡划分代码编制规则](https://www.stats.gov.cn/xxgk/tjbz/gjtjbz/201310/t20131031_1758902.html)
- [首页/推荐性国家标准查询/GB/T 2260-2007/中华人民共和国行政区划代码](https://openstd.samr.gov.cn/bzgk/gb/newGbInfo?hcno=C9C488FD717AFDCD52157F41C3302C6D)

## 开源协议

```
Copyright (c) 2024-present 贵州纳雍穿青人@山野羡民（1032694760@qq.com）
ChinaAddressCrawler is licensed under Mulan PSL v2.
You can use this software according to the terms and conditions of the Mulan
PSL v2.
You may obtain a copy of Mulan PSL v2 at:
         https://license.coscl.org.cn/MulanPSL2
THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY
KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
NON-INFRINGEMENT, MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
See the Mulan PSL v2 for more details.
```