cn / gb2260.js

The NodeJS implementation for looking up Chinese administrative divisions.

GB/T 2260

The latest GB/T 2260 codes. Read the GB2260 Specification.

Installation

Install with npm:

$ npm install gb2260 --save

Usage

var gb2260 = require('gb2260');
// register revision data
gb2260.register('201410', require('gb2260/lib/201410'))

GB2260

var gb = new gb2260.GB2260(revision);

Interface for GB2260.

.get(code)

Get division for the given code.

var division = gb.get("110105")
// <GB/T 2260-201410> 110105 北京市 市辖区 朝阳区

division.name
// 朝阳区
division.code
// 110105
division.revision
// 201410

division.province
// <GB/T 2260-201410> 110000 北京市
division.prefecture
// <GB/T 2260-201410> 110100 市辖区

division.toJSON()
// { name: '朝阳区', code: '110105', revision: 201410 }
division.toString()
// 北京市 市辖区 朝阳区
division.valueOf()
// 北京市 市辖区 朝阳区

.provinces()

Return a list of provinces in Division data structure.

gb.provinces()

.prefectures(code)

Return a list of prefecture level cities in Division data structure.

gb.prefectures(110000)

.counties(code)

Return a list of counties in Division data structure.

gb.counties(110100)

revisions()

Return a list of available revisions.

gb2260.revisions()
// [ '201410', '201308', ..., '200212']

License

MIT.

gb2260.js's Issues

某些division不存在

某些division在所有json中都查不到数据，如1986年登记的412828就没有数据，是否缺失某些历史版本的数据？

Browser support

能把最新版本打个tag发布下npm么

切换 revision 的问题

实际使用如下

var gb2260 = require('gb2260');

// register revision data
gb2260.register('201410', require('gb2260/lib/201410'));

var gb = new gb2260.GB2260();//文档里的 revision 不知道是什么东东，不传都可以啊
gb.get('430421');

难道不能只传入一个参数来切换 revision 么？实际使用中可能需要在多个 年份的 数据中切换，类似于下面这种使用方法。

var gb2260 = require('gb2260');
var revisions = gb2260.revisions();
var gb = new gb2260.GB2260(revisions[0]);
gb.get('430421');
// 如果查不到数据可以依次从 revisions[0] 切换到 revisions[revisions.length-1] 查询

还有就是，README 文档中写得不是很清楚

Usage

var gb2260 = require('gb2260');
// register revision data
gb2260.register('201410', require('gb2260/lib/201410'))

GB2260

var gb = new gb2260.GB2260(revision);

Usage 和 GB2260 中间明显是中断的感觉啊

• gb2260.register 必须传入两个参数么？
• gb2260.GB2260(revision) 中的 revision 传入数据是什么？是可选的么？

如果能得到回答，不尽感激，谢谢

最近有推送新版本的计划么？

如题，本来想自己动手丰衣足食的，不过我电脑的py貌似有问题，构建 GB2260 包的时候总是报错。

请问什么**省下面的数据是没有么