chinese_regions

中华人民共和国民政部省、市、区/县级行政区划代码及名称。港澳台地区等均已包含。当前版本最后更新于2021年9月29日,根据中华人民共和国民政部于2021年01月04日最新发布的数据生成。

Usage no npm install needed!

<script type="module">
  import chineseRegions from 'https://cdn.skypack.dev/chinese_regions';
</script>

README

chinese_regions

npm npm bundle size

中国省、市、区/县级行政区划代码及名称。港澳台地区等均已包含。

数据根据中华人民共和国民政部官方发布的数据更新,一般为调整某地(或数地)行政区后进行相应更新,例如撤并、县改区、市直辖等情况。

安装

npm i chinese_regions

import Regions from 'chinese_regions'

数据结构

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

{
  "province": [
    {
        "code": "370000",
        "name": "山东省"
    }
  ],
  "city": [
    {
      "p_code": "370000",
      "p_name": "山东省",
      "code": "370200",
      "name": "青岛市"
    },
    {
      "p_code": "370000",
      "p_name": "山东省",
      "code": "370100",
      "name": "济南市"
    },
    {
      "p_code": "370000",
      "p_name": "山东省",
      "code": "370600",
      "name": "烟台市"
    },
    {
      "p_code": "370000",
      "p_name": "山东省",
      "code": "370700",
      "name": "潍坊市"
    }
  ],
  "county": [
    {
      "p_code": "370000",
      "p_name": "山东省",
      "c_code": "370200",
      "c_name": "青岛市",
      "code": "370202",
      "name": "市南区"
    },
    {
      "p_code": "370000",
      "p_name": "山东省",
      "c_code": "370200",
      "c_name": "青岛市",
      "code": "370203",
      "name": "市北区"
    },
    {
      "p_code": "370000",
      "p_name": "山东省",
      "c_code": "370200",
      "c_name": "青岛市",
      "code": "370211",
      "name": "黄岛区"
    },
    {
      "p_code": "370000",
      "p_name": "山东省",
      "c_code": "370200",
      "c_name": "青岛市",
      "code": "370212",
      "name": "崂山区"
    },
    {
      "p_code": "370000",
      "p_name": "山东省",
      "c_code": "370200",
      "c_name": "青岛市",
      "code": "370213",
      "name": "李沧区"
    },
    {
      "p_code": "370000",
      "p_name": "山东省",
      "c_code": "370200",
      "c_name": "青岛市",
      "code": "370214",
      "name": "城阳区"
    }
  ]
}

特别的,北京、天津、上海、重庆等直辖市的相关数据中,省、市信息是相同的;港澳台地区的相关数据中,由于民政部未发布正式数据,省、市、区/县信息暂时也是相同的。

应用场景

前端

适用于级联选择器等组件

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

后端

适用于查询构建器等业务

  1. 引入all.min.json文件并解析为所需类型
  2. 保存数据到数据库的相关表,例如region等