uiwjs / province-city-china Goto Github PK

View Code? Open in Web Editor NEW

2.2K 30.0 527.0 15.8 MB

🇨🇳最全最新**【省、市、区县、乡镇街道】json,csv,sql数据

Home Page: https://uiwjs.github.io/province-city-china

License: MIT License

JavaScript 100.00%

province-city-china query-china-province city sql csv gb gb2260 china uiw address

province-city-china's Introduction

中华人民共和国行政区划代码

中华人民共和国行政区划（五级）：省级、地级、县级、乡级和村级。来自中华人民共和国民政部，用于查询**省，市和区数据的网站。

数据更新时间：2021/03/22 15:39:04 GMT+0800 (**标准时间)

数据更新 Diff

安装

npm install province-city-china --save-dev

包名	说明	大小
province-city-china	包含所有包内容	-
@province-city-china/country	国家和地区代码列表
@province-city-china/data	总数据(省/地/县/乡)
@province-city-china/province	省级(省/直辖市/特别行政区)
@province-city-china/city	地级(城市)
@province-city-china/area	县级(区县)
@province-city-china/town	乡级(乡镇/街)
@province-city-china/level	总数据(省/地/县/乡)层级数据
@province-city-china/utils	提供使用数据方法
@province-city-china/types	类型文件	-
@province-city-china/district-code	国内长途电话区号	-

使用

const { data, province, city, area, town } = require('province-city-china/data');

data - 总数据(省/地/县/乡)
province - 省级(省/直辖市/特别行政区)
city - 地级(城市)
area - 县级(区县)
town - 乡级(乡镇/街)

所有数据

const provinces = require('province-city-china/dist/data.json');
// provinces 输出 ===>
[
  {"code":"110000","name":"北京市","province":"11","city":0,"area":0,"town":0},
  {"code":"110101","name":"东城区","province":"11","city":"01","area":"01","town":0},
  {"code":"110102","name":"西城区","province":"11","city":"01","area":"02","town":0},
  {"code":"110105","name":"朝阳区","province":"11","city":"01","area":"05","town":0},
  ....
]

规则：

province - 省级(省/直辖市/特别行政区) - city=0, area=0, town=0
city - 地级(城市) - area=0, town=0
area - 县级(区县) - town=0 其它不为 0
town - 乡级(乡镇/街) - 所有值不为 0

province 第一位表示：华北区1，东北区2，华东区3，中南区4，西南区5，西北区6。如 湖北省 -> 42 以 4 开头，表示为 中南区。

获取城市数据

const city = require('province-city-china/dist/city.json');
// city 输出 ===>
[
  {"code":"01","name":"石家庄市","province":"13"},
  {"code":"02","name":"唐山市","province":"13"},
  {"code":"03","name":"秦皇岛市","province":"13"},
  {"code":"04","name":"邯郸市","province":"13"},
  {"code":"05","name":"邢台市","province":"13"},
  ....
]

说明：

code - 城市代码
name - 城市名称
province - 省/直辖市/特别行政区代码

更多数据

可以通过 UNPKG 下载使用 CDN 资源: https://unpkg.com/province-city-china/dist/

文件列表	JSON	CSV	SQL	CDN
国家和地区代码列表(#13)	country.json (min)	country.csv	-	csv / json
总数据(省/地/县/乡)	data.json (min)	data.csv	data.sql	data.sql / csv / json
总数据(省/地/县/乡)层级数据	level.json (min)	-	-	level.json
省级(省/直辖市/特别行政区)	province.json (min)	province.csv	-	province.json / csv
地级(城市)	city.json (min)	city.csv	-	city.json / csv
县级(区县)	area.json (min)	area.csv	-	area.json / csv
乡级(乡镇/街)	town.json (min)	town.csv	-	town.json / csv
县市区没有乡级数据	not-found-town.json (min)	-	-	not-found-town.json
香港澳门<区>数据	hongkong.json macau.json	hongkong.csv / macau.csv	-	hongkong.json (csv) macau.json (csv)
国内长途电话区号	district-code.json	district-code.csv	-	district-code.json / csv

更多 CDN 数据访问

✅ > <省>数据：34
  ✔ 数据保存: data/province.json
  ✔ 数据保存: data/province.csv
  ✔ 数据保存: data/province.min.json
✅ > <市>数据：337
  ✔ 数据保存: data/city.json
  ✔ 数据保存: data/city.csv
  ✔ 数据保存: data/city.min.json
✅ > <区>数据：2846
  ✔ 数据保存: data/area.json
  ✔ 数据保存: data/area.csv
  ✔ 数据保存: data/area.min.json
✅ > <省><市><区>总数据：3217
  ✔ 数据保存: data/data.json
  ✔ 数据保存: data/data.min.json
  ✔ 数据保存: data/data.csv
✅ > <省市区>层级数据：
  ✔ 数据保存: data/level.json
  ✔ 数据保存: data/level.min.json

国家和地区代码列表

country.json | country.min.json | country.csv

id=序号、cnname=中文简称、name=英文简称、fullname=英文全称、alpha2=两字母代码、alpha3=三字母代码、numeric=数字代码

[
  {
    "id": 1,
    "cnname": "阿富汗",
    "name": "Afghanistan",
    "fullname": "the Islamic Republic of Afghanistan",
    "alpha2": "AF",
    "alpha3": "AFG",
    "town": 4
  },
  {
    "id": 45,
    "cnname": "**",
    "name": "China",
    "fullname": "the People's Republic of China",
    "alpha2": "CN",
    "alpha3": "CHN",
    "town": 156
  }
  // ...
]

压缩数据说明 country.min.json

id: 'i'
cnname: 'c'
name: 'n'
fullname: 'f'
alpha2: 'a2'
alpha3: 'a3'
numeric: 'r'

总数据(省/地/县/乡)

data.json | data.min.json | data.csv | data.sql

包含香港澳门<区>数据

[
  {
    "code": "110000",
    "name": "北京市",
    "province": "11",
    "city": 0,
    "area": 0,
    "town": 0
  },
  // ...
]

压缩数据说明 data.min.json

code: 'c'
name: 'n'
province: 'p'
city: 'y'
area: 'a'
town: 't'

省/地/县/乡层级数据

level.json | level.min.json

包含香港澳门<区>数据

[
  {
    "code": "420000",
    "name": "湖北省",
    "province": "42",
    "children": [
      {
        "code": "420100",
        "name": "武汉市",
        "province": "42",
        "city": "01",
        "children": [
          {
            "code": "420102",
            "name": "江岸区",
            "province": "42",
            "city": "01",
            "area": "02"
          },
          // ...
        ]
      }
      // ...
    ]
  }
  // ...
]

压缩数据说明 level.min.json

code: 'c'
name: 'n'
province: 'p'
city: 'y'
area: 'a'
children: 'd'

省级(省/直辖市/特别行政区)

province.json | province.min.json | province.csv

[
  {
    "code": "110000",
    "name": "北京市",
    "province": "11"
  },
  {
    "code": "120000",
    "name": "天津市",
    "province": "12"
  },
  // ...
]

压缩数据说明 level.min.json

code: 'c'
name: 'n'
province: 'p'
city: 'y'
area: 'a'
children: 'd'

地级(城市)

city.json | city.min.json | city.csv

[
  {
    "code": "130100",
    "name": "石家庄市",
    "province": "13",
    "city": "01"
  },
  // ...
]

压缩数据说明 city.min.json

code: 'c'
name: 'n'
province: 'p'
city: 'y'

县级(区县)

area.json | area.min.json | area.csv

[
  {
    "code": "110101",
    "name": "东城区",
    "province": "11",
    "city": "01",
    "area": "01"
  },
  // ...
]

压缩数据说明 city.min.json

code: 'c'
name: 'n'
province: 'p'
city: 'y'
area: 'a'

乡级(乡镇/街)

town.json | town.min.json | town.csv

[
  {
    "code": "110101001000",
    "name": "东华门街道",
    "province": "11",
    "city": "01",
    "area": "01",
    "town": "001000"
  },
  // ...
]

压缩数据说明 city.min.json

code: 'c'
name: 'n'
province: 'p'
city: 'y'
area: 'a'
town: 't'

县市区没有乡级数据

not-found-town.json | not-found-town.min.json

[
  {
    "code": "659010",
    "name": "胡杨河市",
    "province": "65",
    "city": "90",
    "area": "10",
    "town": 0
  },
  // ...
]

压缩数据说明 not-found-town.min.json

code: 'c'
name: 'n'
province: 'p'
city: 'y'
area: 'a'
town: 't'

香港澳门<区>数据

hongkong.json | hongkong.csv | macau.json | macau.csv

[
  {
    "code": "810002",
    "name": "湾仔区",
    "province": "81",
    "city": "00",
    "area": "02"
  },
  // ...
]

国内长途电话区号

district-code.json | district-code.csv

[
  { "name": "北京市", "code": "010" },
  // ...
]

脚本获取数据说明

① 获取<省><市>数据

在中华人民共和国民政部-总省市区数据上有完整的公开省市区数据。

获取省数据： http://www.mca.gov.cn/article/sj/xzqh/2020/20201201.html

② 校验四个<自治区直辖县级行政区划> & 以及其它数据

省市区数据来源于 ~~中华人民共和国民政部-总省市区数据~~，数据太老，自治区直辖县级行政区划 中有数据不存在，校验此数据。

🚧 注意：部分省份下面有 省直辖县级行政区划 如(湖北省、河南省等)，需要将此部分数据重新爬下来进行校验数据，如 [**维吾尔自治区-自治区直辖县级行政区划] 缺 新星市。

为提升速度，通过 标记 校验哪些特殊省份有这类数据。

http://www.stats.gov.cn/tjsj/tjbz/tjyqhdmhcxhfdm/2021/<省>/<省><自治区直辖县级行政区划>.html

- 42 湖北省         -> # 自治区直辖县级行政区划
- 46 海南省         -> # 自治区直辖县级行政区划
- 65 **维吾尔自治区 -> # 自治区直辖县级行政区划
- 41 河南省         -> # 省直辖县级行政区划
# - 46 重庆市 -> 🚧 县
# - 23 黑龙江省 -> 🚧 大兴安岭地区

上面 4 个省区比较特殊的 自治区直辖县级行政区划，都有独立的 城市 代码，里面的数据拥有 区 代码，所以放到 区 数据中，例如：湖北省的 自治区直辖县级行政区划 编码为 90

[
  { code: '429004', name: '仙桃市', province: '42', city: '90' },
  { code: '429005', name: '潜江市', province: '42', city: '90' },
  { code: '429006', name: '天门市', province: '42', city: '90' },
  { code: '429021', name: '神农架林区', province: '42', city: '90' }
]

③ 处理四个<北京市|上海市|天津市|重庆市>直辖市数据

在 ① 步已获取直辖市数据：http://www.mca.gov.cn/article/sj/xzqh/2020/20201201.html

🚧 这里只是在生成层级数据的时候，需要特殊处理，因为它只有市区数据。

④ 分别存储<省><市><区>数据

分别存储 <省><市><区> 提供 csv, min.json, level.json, level.min.json 等数据。

⑤ 缓存<区>数据

此数据用于<街道>数据获取，避免中断从头爬数据。

⑥ 通过<街道>数据获取街道数据

□□□□□□  □□□  □□□
┈┈┬┈┈┈  ┈┬┈  ┈┬┈
  ╰┈┈┈┈┈┈┆┈┈┈┈┆┈┈┈┈→ ¹<省市区>代码
         ╰┈┈┈┈┆┈┈┈┈→ ²<乡镇街道>代码
              ╰┈┈┈┈→ ³<居民委员会>和<村民委员会>的代码

第²二段代码

001—099 表示街道的代码，应在本地区的范围内由小到大顺序编写；
100—199 表示镇的代码，应在本地区的范围内由小到大顺序编写；
200—399 表示乡的代码，应在本地区的范围内由小到大顺序编写；
400—599 表示政企合一单位的代码，应在本地区的范围内由小到大顺序编写。

第³三段代码

居民委员会的代码从001—199由小到大顺序编写；
村民委员会的代码从200-399由小到大顺序编写。

参考链接

Contributors

License

MIT

province-city-china's People

Contributors

Stargazers

Watchers

Forkers

lymanlai cuitymiko yongbaowang hfhna idokit ehangwork shaipe shi-yc haochenxin 2050utopia gitshujian lichengtao1989 showsmall wuwx yanzishang rory602 zhlf1987 woodfizky gonnavis oldfu phixcn ninomiyaaaa lb491798689 devilandbird haptear jooooooop jasen515 libin1991 aracta sz-p gangganghao andyoung zhangming12 monkeyfx yj445649862 paopao7 gitqqqhs wuyad ronyland wittech greatxj vibes-ins shuperry andq00 qichaoran imakan mayrain1999 hanyingzhong richard32 fit-clay gelory1 18827676454 shfshanyue astra-zhao yananxiao gzes00201 taohyson baitongda galenchou crackercat zjz6b6 glen9527 chenmocoder friday5xue pengfeizuo simplephp jiangwei0000 deimos-99 tenghui-kooboo ducky-yfh baisheng memorybx hugh87 longjl k-liaojiale yxyufo110 wmengs ljy201992 xiaokangran yetland programmerhuang yohanceli zorobabbage dingyangwei9999 ustczeng liaowanglw mugbya debugksir kawhi123456 super1117 bmd080 fengbuliao chenbo-hhu 365-w liuchenxuxy zjxstjg zsfbradley mr-yangcheng morrle caitlingao

province-city-china's Issues

没有从属关系呀

如：

xx省
- xx市1
  * xx镇2
  - xx县城1
  - xx县城2
- xx市1
  * xx镇2
  - xx县城1
  - xx县城2

readme的更新时间写错啦

https://github.com/uiwjs/province-city-china/blame/master/README.md#L10

2019-03-06 should be 2020-03-06 :)

市级数据缺失

感谢作者辛苦维护数据，现在针对省级下设行政区发现一些问题：

河南省缺失：’济源市‘
**下缺失 '石河子市', '阿拉尔市', '图木舒克市', '五家渠市', '北屯市', '铁门关市', '双河市', '可克达拉市', '昆玉市', '胡杨河市'
湖北的几个县级行政区：'仙桃市', '潜江市', '天门市', '神农架林区' 看现在是单独归类的，是否放到湖北省下
海南下县市直管了，缺失：'五指山市', '琼海市', '文昌市', '万宁市', '东方市', '定安县', '屯昌县', '澄迈县', '临高县', '白沙黎族自治县', '昌江黎族自治县', '乐东黎族自治县', '陵水黎族自治县', '保亭黎族苗族自治县', '琼中黎族苗族自治县'

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Other Branches

These updates are pending. To force PRs open, click the checkbox below.

chore(deps): update actions/checkout action to v4
chore(deps): update actions/setup-node action to v4
chore(deps): update peaceiris/actions-gh-pages action to v4

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

chore(deps): update dependency fs-extra to ~10.1.0
chore(deps): update dependency fs-extra to v11
chore(deps): update dependency superagent to v8
fix(deps): update dependency lerna to v8
Click on this checkbox to rebase all open PRs at once

Detected dependencies

github-actions

.github/workflows/ci.yml

actions/checkout v3

actions/setup-node v3

peaceiris/actions-gh-pages v3

ncipollo/release-action v1

npm

package.json

lerna ^5.6.2

packages/area/package.json

packages/city/package.json

packages/core/package.json

cheerio ~1.0.0-rc.10

csvtojson ~2.0.10

fs-extra ~10.0.1

superagent ~7.1.1

superagent-charset ~1.2.0

packages/country/package.json

packages/data/package.json

packages/district-code/package.json

packages/level/package.json

packages/province/package.json

packages/town/package.json

packages/types/package.json

packages/utils/package.json

Check this box to trigger a request for Renovate to run again on this repository

地区区号？

考虑不考虑加上这些信息

地区的区号 010， 021
地区的简称，例如京、津
车牌号，沪A、沪B

level.min.json缺失

level.min.json什么时候东莞市，中山市，三沙市，儋州市，嘉峪关市的镇数据补上

掘金上看到兄弟的这个干货，省了俺很多时间，有个问题

掘金上看到兄弟的这个干货，省了俺很多时间，有个问题想请教一把：以后像区，镇之类有新增了，如何进行增量维护呢？
现在头一次用可以直接把那个data.sql直接入表就行了，但以后有了新的区，镇就不能删了表重新导入啦，怎么增量处理呢？

压缩数据说明错误

@province-city-china 包中 readme 压缩数据说明 city 为 y ，但实际 level.min.json 中 city 为 d

使用主包尝试访问 country 相关数据时，没按预期工作

import ProvinceCityChinaCountryList from "province-city-china/dist/country.json";

//似乎是声明类型
let test1: ProvinceCityChinaCountryList = [];//咦？居然不是值类型，而是声明类型？
test1.sort();//似乎是

//尝试使用值类型
let test2 = ProvinceCityChinaCountryList;//尝试直接使用时： “ProvinceCityChinaCountryList”仅表示类型，但在此处却作为值使用。ts(2693)

直辖市缺少市辖区的中间层级

感谢作者提供的开源组件，看到之前有人提过这个Issues了，但是并未解决 #10 #17
使用的是level数据

非直辖市：省 > 市 > 区三级

直辖市：市 > 区二级

比如北京，children 直接是区，应该是北京 > 市辖区 > 区三级。

目前是：
[
{
"code": "110000",
"name": "北京市",
"province": "11",
"children": [
{
"code": "110101",
"name": "东城区",
"province": "11",
"city": "01",
"area": "01"
},
......
]

直辖区需加一级children 市辖区
[
{
"code": "110000",
"name": "北京市",
"province": "11",
"children": [
{
"code": "110100",
"name": "市辖区",
"province": "11",
"city": "01",
"children": [
{
"code": "110101",
"name": "东城区",
"province": "11",
"city": "01",
"area": "01"
},
......
},
......
]

缺少市辖区这一级导致数据格式不一致。

建议使用新地址，更新下数据。谢谢啦。

关于数据维护

我看历史 commit 中，对于一些行政区划变更，是直接删除旧代码添加新代码，这种方法大部分时候会导致基于此库的代码发生异常。

一个合理的方案应当为添加一个deprecated字段用来标记这个行政区划已经不应该再使用。

可否加入经纬度信息

参考 https://github.com/kakuilan/china_area_mysql 的中的经纬度信息

Recommend Projects

React

A declarative, efficient, and flexible JavaScript library for building user interfaces.
Vue.js

🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript

TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
TensorFlow

An Open Source Machine Learning Framework for Everyone
Django

The Web framework for perfectionists with deadlines.
Laravel

A PHP framework for web artisans
D3

Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

javascript

JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
web

Some thing interesting about web. New door for the world.
server

A server is a program made to process requests and deliver data to clients.
Machine learning

Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Visualization

Some thing interesting about visualization, use data art
Game

Some thing interesting about game, make everyone happy.

Recommend Org

Facebook

We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft

Open source projects and samples from Microsoft.
Google

Google ❤️ Open Source for everyone.
Alibaba

Alibaba Open Source for everyone
D3

Data-Driven Documents codes.
Tencent

China tencent open source team.