chinese_regions

中华人民共和国民政部区划地名司官方公布的行政区划信息数据，含省/直辖市、市、区/县级行政区划代码及名称。港澳台地区等均已包含。

当前数据最后更新于 2024 年 5 月 14 日，根据中华人民共和国民政部于 2024 年 04 月 25 日最新发布的数据生成，一般为调整某地（或数地）行政区后进行相应更新，例如撤并、县改区、市直辖等情况。对于具体行政区划变更情况，可参见更新日志

安装

// npm
npm i chinese_regions
// pnpm
pnpm add chinese_regions

import Regions from "chinese_regions" with { type: "json" };
console.log(Regions.province.length);
console.log(Regions.city.length);
console.log(Regions.county.length);

P.S. The old 'assert' keyword has been deprecated, see https://github.com/tc39/proposal-import-attributes#history for more detail.

数据结构

{
  // 省级数据集
  "province": [
    {
      "code": 370000, // 当前行政区划代码
      "name": "山东省" // 当前行政区划名称
    }
  ],
  // 市级数据集
  "city": [
    {
      "p_code": 370000, // 所属省级行政区划代码
      "p_name": "山东省", // 所属省级行政区划名称
      "code": 370200,
      "name": "青岛市"
    }
  ],
  // 区县级数据集
  "county": [
    {
      "p_code": 370000,
      "p_name": "山东省",
      "c_code": 370200, // 所属市级行政区划代码
      "c_name": "青岛市", // 所属市级行政区划代码
      "code": 370202,
      "name": "市南区"
    }
  ]
}

以山东省青岛市相关的部分数据为例：

{
  "province": [
    {
      "code": 370000,
      "name": "山东省"
    }
  ],
  "city": [
    {
      "p_code": 370000,
      "p_name": "山东省",
      "code": 371300,
      "name": "临沂市"
    },
    {
      "p_code": 370000,
      "p_name": "山东省",
      "code": 370200,
      "name": "青岛市"
    },
    {
      "p_code": 370000,
      "p_name": "山东省",
      "code": 370700,
      "name": "潍坊市"
    }
  ],
  "county": [
    {
      "p_code": 370000,
      "p_name": "山东省",
      "c_code": 370200,
      "c_name": "青岛市",
      "code": 370211,
      "name": "黄岛区"
    },
    {
      "p_code": 370000,
      "p_name": "山东省",
      "c_code": 370200,
      "c_name": "青岛市",
      "code": 370283,
      "name": "平度市"
    },
    {
      "p_code": 370000,
      "p_name": "山东省",
      "c_code": 370200,
      "c_name": "青岛市",
      "code": 370215,
      "name": "即墨区"
    }
  ]
}

特别的，北京、天津、上海、重庆等直辖市的相关数据中，省、市信息是相同的；港澳台地区的部分数据中，由于民政部未发布正式数据，或暂时沿用了约定俗成的“堂区”等教源分区，省、市、区/县信息暂时也是相同的。

应用场景

前端开发

适用于级联选择器等组件，推荐部署到 CDN。

1. 输出并选择 province 键下的省级行政区
2. 根据 province 值输出 city 键下的市级行政区
3. 根据 city 值输出 county 键下的区/县级行政区

后端开发

适用于查询构建器等业务

1. 引入 all.min.json 文件并解析为所需类型
2. 保存数据到缓存层、持久层，或部署到组件库进行调用