Metadata-Version: 2.1
Name: china-district
Version: 0.0.5
Summary: an useful tool for getting Chinese district data from GaodeMap
Home-page: https://github.com/xugongli/china-district
Author: soaringsoul
Author-email: 951683309@qq.com
License: UNKNOWN
Description: china_district [![latest_version]][pypi_version] [![License]][license_url] [![python_version]][python_version]
        ========
        
        
        
        
        china_district是根据关键词获取行政区域信息的python库。
        
        是对高德地图开放平台的行政区域查询接口进行了封装。
        
        
        
        安装
        ------------
        
            pip install china-district
        
        依赖库
        ---------
        
        `requests=2.22.0`
        
        ## 基础使用示例
        
        基础使用，默认使用作者自己的高德地图开发者key，每天上限调用30万次。超过这个限制将无法使用。
        
        
            >>> In [1]: from china_district import District
            # 初始化District,默认只返回下一级行政区，不返回行政区边界坐标点
            >>> In [2]: d=District()
            
            >>> In [3]: d.get("武侯区")
            {'status': '1',
             'info': 'OK',
             'infocode': '10000',
             'count': '1',
             'suggestion': {'keywords': [], 'cities': []},
             'districts': [{'citycode': '028',
               'adcode': '510107',
               'name': '武侯区',
               'center': '104.05167,30.630862',
               'level': 'district',
               'districts': [{'citycode': '028',
                 'adcode': '510107',
                 'name': '金花桥街道',
                 'center': '103.973,30.6029',
                 'level': 'street',
                 'districts': []},
            ……}
            # 将当前搜索结果(json对象)写入到当前目录，默认文件名"搜索关键词.json"
            >>> d.to_json("武侯区")
            	写入本地完成...
        ​    
        高级使用示例
        ------------------
        
        ``` d.get("武侯区")
        >>> In [1]: from china_district import District
        # 初始化District,key为高德地图开发者key,subdistrict设置显示下级行政区级数，extensions设置行政区信息中是否返回行政区边界坐标点，”base"不返回，“all"返回
        
        >>> In [5]:d = District(key="182ad5d7061ed1e421091c22089c3677",subdistrict=3,extensions="all")
        
        Out[6]: 
        {'status': '1',
         'info': 'OK',
         'infocode': '10000',
         'count': '1',
         'suggestion': {'keywords': [], 'cities': []},
         'districts': [{'citycode': '028',
           'adcode': '510107',
           'name': '武侯区',
           'polyline': '103.949841,30.658586;103.949928,30.658864;103.950137,30.659044;103.950415,30.659121;103.950667,30.6591;103.952425,30.658587;103.952869,30.658525;103.95333,30.658589;103.953
        687,30.658726;103.953966,30.658948;103.954261,30.659335;103.954984,30.660906;103.955149,30.661113;103.955472,30.661348;103.95575,30.661423;103.956107,30.661436;103.957439,30.661364;103.957……```}
        
        ```
        
        ## 请求参数说明
        
        
        
        | 参数名      | 含义             | 规则说明                                                     | 是否必须 | 缺省值 |
        | :---------- | :--------------- | :----------------------------------------------------------- | :------- | :----- |
        | key         | 请求服务权限标识 | 用户在高德地图官网[申请Web服务API类型KEY](https://lbs.amap.com/dev/) | 可选     | 无     |
        | keywords    | 查询关键字       | 规则：只支持单个关键词语搜索关键词支持：行政区名称、citycode、adcode例如，在subdistrict=2，搜索省份（例如山东），能够显示市（例如济南），区（例如历下区）adcode信息可参考[城市编码表](https://lbs.amap.com/api/webservice/download)获取 | 可选     | 无     |
        | subdistrict | 子级行政区       | 规则：设置显示下级行政区级数（行政区级别包括：国家、省/直辖市、市、区/县、乡镇/街道多级数据）可选值：0、1、2、3等数字，并以此类推0：不返回下级行政区；1：返回下一级行政区；2：返回下两级行政区；3：返回下三级行政区； 需要在此特殊说明，目前部分城市和省直辖县因为没有区县的概念，故在市级下方直接显示街道。例如：广东-东莞、海南-文昌市 | 可选     | 1      |
        | extensions  | 返回结果控制     | 此项控制行政区信息中返回行政区边界坐标点； 可选值：base、all;base:不返回行政区边界坐标点；all:只返回当前查询district的边界值，不返回子节点的边界值；目前**不能**返回乡镇/街道级别的边界值 | 可选     | base   |
        
        
        ## 了解更多
        
        高德地图行政区域查询接口：https://lbs.amap.com/api/webservice/guide/api/district
        
        License
        -------
        Licensed under the MIT License.
        
        
        [License]:         https://img.shields.io/github/license/xugongli/china-district.svg
        [license_url]:     https://github.com/xugongli/china-district/blob/master/LICENSE
        [latest_version]:            https://img.shields.io/pypi/v/china_district.svg
        [pypi_version]: https://pypi.org/project/china-district/
        [python_version]: https://img.shields.io/pypi/pyversions/china_district.svg
        
Platform: UNKNOWN
Classifier: Framework :: Scrapy
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.5
Description-Content-Type: text/markdown
