/Administrative-divisions-of-China

中华人民共和国行政区划数据:省份、城市、区县、乡镇,省市区镇三级四级联动数据。

Primary LanguageJavaScriptDo What The F*ck You Want To Public LicenseWTFPL

Administrative-divisions-of-China

code style dependencies npm downloads license

中华人民共和国行政区划:省份、城市、区县、乡镇(街道)

JSON

文件列表 下载地址
省份数据 provinces.json
城市数据 cities.json
区县数据 areas.json
乡镇(街道)数据 streets.json
“省份、城市” 二级联动数据 pc.json
“省份、城市” 二级联动数据(带编码) pc-code.json
“省份、城市、区县” 三级联动数据 pca.json
“省份、城市、区县” 三级联动数据(带编码) pca-code.json
“省份、城市、区县、乡镇” 四级联动数据 pcas.json
“省份、城市、区县、乡镇” 四级联动数据(带编码) pcas-code.json

提示:需要打包下载全部文件,请看 Releases

Usage

抓取并导出最新数据

$ npm install

$ npm run build
[1/1] 正在抓取省份、城市和区县数据...
[1/2848] 正在抓取乡镇数据,当前区县: 110105 朝阳区
[2/2848] 正在抓取乡镇数据,当前区县: 110101 东城区
[3/2848] 正在抓取乡镇数据,当前区县: 110106 丰台区
[4/2848] 正在抓取乡镇数据,当前区县: 110109 门头沟区
[5/2848] 正在抓取乡镇数据,当前区县: 110112 通州区
[6/2848] 正在抓取乡镇数据,当前区县: 110102 西城区
[7/2848] 正在抓取乡镇数据,当前区县: 110107 石景山区
[8/2848] 正在抓取乡镇数据,当前区县: 110111 房山区
[9/2848] 正在抓取乡镇数据,当前区县: 110108 海淀区
[10/2848] 正在抓取乡镇数据,当前区县: 110113 顺义区
...
[2841/2848] 正在抓取乡镇数据,当前区县: 659006 铁门关市
[2842/2848] 正在抓取乡镇数据,当前区县: 210522 桓仁满族自治县
[2843/2848] 正在抓取乡镇数据,当前区县: 210881 盖州市
[2844/2848] 正在抓取乡镇数据,当前区县: 130902 新华区
[2845/2848] 正在抓取乡镇数据,当前区县: 150782 牙克石市
[2846/2848] 正在抓取乡镇数据,当前区县: 542421 那曲县
[2847/2848] 正在抓取乡镇数据,当前区县: 610122 蓝田县
[2848/2848] 正在抓取乡镇数据,当前区县: 610322 凤翔县
[1/5] 正在导出 “省份” JSON 数据...
[2/5] 正在导出 “城市” JSON 数据...
[3/5] 正在导出 “区县” JSON 数据...
[4/5] 正在导出 “乡镇” JSON 数据...
[5/5] 数据抓取完成!
[1/4] 正在导出 “省份、城市” 二级联动数据...
[2/4] 正在导出 “省份、城市、区县” 三级联动数据...
[3/4] 正在导出 “省份、城市、区县、乡镇” 四级联动数据...该步骤操作数据较多,比较耗时,请耐心等候...
[4/4] 数据更新完成!

提示:

由于抓取乡镇数据为异步操作,每次输出的乡镇数据顺序可能不同

但是不会影响其它数据的顺序以及所有数据的完整性。

Testing

$ npm test

> eslint . && mocha -t 5000

  中华人民共和国行政区划:
    ✓ 省份数据
    ✓ 城市数据
    ✓ 区县数据
    ✓ 乡镇数据
    ✓ “省份、城市” 二级联动数据
    ✓ “省份、城市、区县” 三级联动数据
    ✓ “省份、城市、区县、乡镇” 四级联动数据
    ✓ “某省、某市、某县、某镇” 不存在

  8 passing (12ms)

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

License

this repo is released under the WTFPL – Do What the Fuck You Want to Public License.