china-division 2.0
中国行政区划查询工具
Requires Python: >=3.6
Keywords: china administrative division

# China Division 中国行政区划查询工具
        
        [![PyPI version](https://img.shields.io/pypi/v/china-division)](https://pypi.org/project/china-division/)
        [![Python versions](https://img.shields.io/pypi/pyversions/china-division)](https://pypi.org/project/china-division/)
        
        一个高效查询中国行政区划的Python库，支持：
        - 按代码或名称查询行政区划
        - 智能分级匹配算法
        - 上下级关系查询
        
        ## 安装方式
        
        ```bash
        pip install china-division
        ```
        
        ## 快速开始
        
        ```python
        from china_division import search_division, get_division_info
        
        # 通过名称查询
        print(search_division("阿鲁科尔沁旗"))  # 输出: "150421"
        print(search_division("铁东"))         # 输出: "210302:辽宁省鞍山市铁东区|220303:吉林省四平市铁东区"
        
        # 通过代码查询
        print(get_division_info("150421"))     # 输出: "内蒙古自治区赤峰市阿鲁科尔沁旗"
        ```
        
        ## 主要功能
        
        ### 1. 行政区划查询
        
        ```python
        # 搜索行政区划（支持模糊匹配）
        result = search_division("北京朝阳")
        
        # 获取完整信息
        info = get_division_info("110105")  # 北京市朝阳区
        ```
        
        ### 2. 层级关系查询
        
        ```python
        from china_division import get_parent_division, get_child_divisions
        
        # 获取上级行政区划
        parent = get_parent_division("150421")  # ("150400", "赤峰市")
        
        # 获取下级行政区划
        children = get_child_divisions("110000")  # [("110101", "东城区"), ...]
        ```
        
        ### 3. 智能搜索特性
        
        - **分级匹配**：`search_division("内蒙阿鲁")` → 自动匹配"阿鲁科尔沁旗"
        - **多结果合并**：多个结果用`|`分隔显示
        - **容错处理**：无结果返回提示信息
        
        ## 数据来源
        
        内置最新行政区划数据，包含：
        - 省级行政区(23省、5自治区、4直辖市、2特别行政区)
        - 地级市(300+)
        - 县级区划(2800+)
        
        ## 贡献指南
        
        欢迎提交Issue或Pull Request：
        1. Fork项目
        2. 创建分支(`git checkout -b feature/your-feature`)
        3. 提交更改(`git commit -am 'Add some feature'`)
        4. 推送到分支(`git push origin feature/your-feature`)
        5. 创建Pull Request
        
        ## 许可证
        
        [MIT License](LICENSE)
        
        
        ## 版本说明
        
        ### 与 chinese_administrative_divisions 的关系
        
        本项目是原 chinese_administrative_divisions 库的升级版本，主要改进包括：
        
        | 特性                     | 本版本 (china-division)         | 旧版本 (chinese_administrative_divisions) |
        |------------------------------------|-------------------------------------|--------------------------------------------|
        | **包名称**                 | china-division               | chinese_administrative_divisions       
        |                        
        | **查询接口**                | 统一字符串输出格式             |  统一字符串输出格式                      |                        
        |
        | **搜索算法**                | 智能分级匹配                 | 基础关键词匹配                            |
        | **数据更新**                | 2023年最新行政区划             | 2023年最新行政区划                                |  
        | **依赖关系**                | 零依赖                     | 零依赖                            |
        
        ## 迁移指南
        
        旧版本用户升级建议：
        
        Python
        #旧版代码
        from chinese_administrative_divisions import get_division
        
        #新版替代方案
        from china_division import search_division, get_division_info
        
        #查询逻辑需要调整（新版始终返回字符串）
        result = search_division("朝阳区")  # 返回 "110105:北京市朝阳区"
        
        ## 版本兼容性提示
        
        本版本不保证与旧版API完全兼容，主要变更：
        - 删除了一些旧版函数
        - 统一了返回格式
        - 优化了搜索算法