cn / gb2260 Goto Github PK

View Code? Open in Web Editor NEW

1.5K 77.0 209.0 2.39 MB

中华人民共和国国家标准 GB/T 2260 行政区划代码

Shell 0.97% Python 97.14% Makefile 1.89%

gb2260

gb2260's People

Contributors

Stargazers

Watchers

Forkers

lidan3959 bingostyle upan hechangbin lessismore100 ckid chenglin1081 jpomichael junjiemao eggao zhenghj7 lucio-c gitter-badger dizhu yuolsoja voidexception itommyyang weiki516 yzhengelementum fatelei liwzhi flyeven sundebin bsovereign stardustliu wangjun zhanhb geographerwang timothyqiu chenkovsky npcchina xsls daya-prac mrmodoor moneysail ftao darkit diamondbigdata malongge kevinsusr hye windysay zhangyingwei-resources shycool yang123vc tombloon kittencup tkizm1 n37r06u3 msntop appla e42s secti6n sqsy tempdban qhxin ldw4033 easybest puresteelzhang remtechteam liudongqi localchart rouxyang wozzup dawn520 gdzzzyyy judyyan pinkuburu maslke skykingf leihentulong zhousuhang codingforsolon harlim onepiecehan oldleader lonelygo yangkaifei twangjie windfarer odinman meetzhangzhen hybomyth lunaczp icersummer xiaoshuai999 billryan chakla cooliean boneyao luyunyyyyy fedkey andoryuuta small-bug loganryanjing tanxunge quinnchiu dangx kyinfopuyu hijack-x

gb2260's Issues

pinyin data

Add pinyin name in txt files:

110000  北京市   běi-jīng-shì

my github issue 20180320

mm

Spec v1

GB2260 目前已经有 6 种语言实现了，各个语言的版本与 spec 的版本无法一一对应，打算新的 spec 从版本 1 开始，各语言的版本命名：spec-version.data-update.lang-version

比如新的 spec 为 v1，数据第 2 次更新，那么 cn/GB2260 这个库会打一个 1.2 的 tag，cn/GB2260.js 这个 JavaScript 的实现的版本则是 1.2.0，JS 库修正自己代码的 bug 后有更新的话则版本变为 1.2.1。

@cn/gb2260

标准

完成 spec 的定义

revision - source 标注来源
load data 定义，支持多数据源
空数据定义

语言实现

UI 实现

实现一组 UI picker 组件

Rust 实现

https://github.com/messense/GB2260.rs

I have done a similar work in python-stdnum

I have done a similar work in python-stdnum:

Is there any help we could take from it?

Maintainer List

Each language implementation should have a maintainer.

Here is a list according to the current active status:

Agreed?

BTW @damonchen could you move Go lang implementation to cn group?

Spec v0.3

Notes on next release:

file format: tsv
tsv format: source revision code name
revision format: yyyymm

IRC / librelist / Gitter

需要一个沟通工具，issue 还是不太适合讨论。大家投票选一下吧：

IRC (freenode)
Mail list (librelist)
Gitter

另外还可以选 Slack 和 Bearychat，但是这两者不公开，不推荐使用。

JSON Data

Generate a common JSON tree data for every language.

Here is a demo:

{
  "11": {
    "name": "北京市",
    "code": "110000",
    "prefectures": {
      "1101": {
        "name": "市辖区",
        "code": "110100",
        "counties": {
          "110101": {
            "name": "东城区",
            "code": "110101"
          },
          "110102": {
            "name": "西城区",
            "code": "110102"
          }
          // ...
        }
      }
      // ...
    }
  }
  // ...
}

.net 的版本没有列出

我看.net 版本已经有了，但是没有列出来。

行政区划变更

国家新发布的行政区划变更情况未入库

我写了`Elixir`的实现, 如何贡献出来?

https://github.com/LcpMarvel/gb2260

加入 Ruby 实现

https://github.com/wolflee/GB2260.rb

Spec 的数据结构中 year 允许为空不合理

目前的 Specification 中基础数据结构的 year 字段是这样的：

Optional. The revision year, and empty means "latest".

这么做的最大问题，就是对版本的依赖：例如 new GB2260("2014").get("110103").year 目前返回的是 null，但同样的客户代码，在若干年后更新了版本后返回的可能变成 2014，因为最新版本可能已经是 2018 年了。

其次，对 year 的这种处理，实际上是重载了这一字段的含义。使其不再表示单一的「年份版本」，同时还表示了「是否是最新版本」。而且从目前的 Spec 中还无法得知「最新版本」到底是哪一版。

我觉得在数据结构层面上允许为空，事实上让使用变得更加麻烦。可以仅在参数处允许用空值表示「最新版本」作为最新一年的缺省值，实际数据结构中始终用具体的年份，以达到统一。同时新增一个常量表示最新的版本的 year，以满足检查某个 Division 是否是最新版本的需求。

来源是否准确

查询资料的过程中，发现作为推荐标准的 GB/T 2260，至少存在 GB/T 2260-2002 和 GB/T 2260-2007 两个版本，而且 GB/T 2260-2007 是直接代替 GB/T 2260-2002 的。

而 Repo 中从国家统计局网站抓取的数据，2002 至 2007 之间每一年都有新版本。这些数据显然不属于 GB/T 2260 的任何版本。

所以，似乎国家统计局网站上公布的行政区划代码实际上并不是 GB/T 2260 的代码。至少 2002 至 2007 年间的不是。

Spec 对历史查询不友好

GB2260 本身并不向后兼容，例如北京崇文区 110103 在 2009 以后的版本中是不存在的。

目前的 Spec 中 GB2260 接口都必须对应到具体的年，与 GB2260 本身是一致的。那么通过 `new GB2260("2014").get("110103") 应该是得不到结果的。

目前的 Spec 不支持在各个历史版本中查询。例如查询 110103 可以：

GB2260.search("110103")  // 在所有历史版本中查询
GB2260.search("110103", ["2009", "2011"])  // 在 2009 和 2011 版本中查询

// =>
{
    "code": "110103",
    "name": "崇文区",
    "year": "2009",
}

GB2260.search("110103", ["2007", "2008"])  // 得到 2008 版本

如果想要基于目前的 Spec 实现这个函数的话，不带参数的版本因为 Spec 中未给出 year 可选范围，几乎无法进行编写。

spec on not found

定义未找到 code 时返回什么？

the latest source.tsv

不同语言的版本可以做成不同的branch，不应该混在一个branch里

比如python branch，nodejs branch。这样如何？

MCA 源中部分地级行政区缺失

MCA 源中，所有 revision 都有部分地级行政区缺失，例如 110101（北京东城区）对应的地级行政区 110100 不存在。（对应标准及 STATS 源中，该地级行政区为「市辖区」）

所有直辖市都有缺失情况，但也有其它省份存在特殊情况，例如 201801 版本中，以下县级行政区缺少对应的地级行政区：

济源市河南省
仙桃市湖北省
潜江市湖北省
天门市湖北省
神农架林区湖北省
五指山市海南省
琼海市海南省
文昌市海南省
万宁市海南省
东方市海南省
定安县海南省
屯昌县海南省
澄迈县海南省
临高县海南省
白沙黎族自治县海南省
昌江黎族自治县海南省
乐东黎族自治县海南省
陵水黎族自治县海南省
保亭黎族苗族自治县海南省
琼中黎族苗族自治县海南省
石河子市 **维吾尔自治区
阿拉尔市 **维吾尔自治区
图木舒克市 **维吾尔自治区
五家渠市 **维吾尔自治区
北屯市 **维吾尔自治区
铁门关市 **维吾尔自治区
双河市 **维吾尔自治区
可克达拉市 **维吾尔自治区
昆玉市 **维吾尔自治区

首先，这影响 Spec 中 Division.province 属性的定义，该属性只有在对省级行政区对象调用时才允许为空值。

其次，由于地级行政区缺失，使用 GB2260.provinces() & GB2260.prefectures(province_code) & GB2260.counties(prefecture_code) 三级遍历行政区划时，无法到遍历到这些县级行政区。

似乎需要想个解决方法。

GB2260 与邮编对应

GB2260 Code <-> Post Code