limichange / administrative-divisions-of-china

**行政区划数据：省份、城市、区县、乡镇

Administrative-divisions-of-China

中华人民共和国行政区划：省份、城市、区县、乡镇（街道）

• 数据来源（国家统计局）：
  • 中华人民共和国国家统计局-行政区划代码
  • 中华人民共和国国家统计局-统计用区划和城乡划分代码
• 本项目已更新至：
  • 最新县及县以上行政区划代码（截止时间：2015-9-30，发布时间：2016-08-09）
  • 2015年统计用区划代码和城乡划分代码（截止时间：2015-09-30，发布时间：2016-07-27）

JSON

文件列表	下载地址
省份数据	provinces.json
城市数据	cities.json
区县数据	areas.json
乡镇（街道）数据	streets.json
“省份、城市” 二级联动数据	address2.json
“省份、城市、区县” 三级联动数据	address3.json
“省份、城市、区县、乡镇” 四级联动数据	address4.json

TEST

$ npm test

> mocha -t 5000

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

  8 passing (12ms)

NPM(不建议)

注意：

由于 require 为同步操作，出于性能考虑，不建议使用 Node 模块这种方式。

原因参考 Node.js Modules。 因此建议 下载 JSON 文件。

安装：

$ npm install --save china-division

使用：

var chinaDivision = require('china-division');

// 省份数据
var provinces = chinaDivision.provinces;

// 城市数据
var cities = chinaDivision.cities;

// 区县数据
var areas = chinaDivision.areas;

// 乡镇（街道）数据
var streets = chinaDivision.streets;

// “省、市” 二级联动数据
var address2 = chinaDivision.address2;

// “省、市、区” 三级联动数据
var address3 = chinaDivision.address3;

// “省、市、区、镇” 四级联动数据
var address4 = chinaDivision.address4;

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 MIT License.