文 档 中 心 / Document Center
搜索 管理中心
壹川接口文档V3
获取地区数据列表
更新时间:2018-04-16 16:29:14   更新人员:叶洋   文档状态:完成 #152    测试接口
摘要
获取地区数据列表
  1. 接口基本信息
    接口名称:获取地区列表
    请求方法:GET
    接口地址:district
    登录验证:否
  2. 请求参数
    参数名 参数 数据类型 是否必须 示例值 说明
    page 分页 int 默认不传为1
    row 每页数量 int 默认不传为15
    pid 上级id int
    level 查询级别 string 可选值有:country国,province省,city市,district区,street街
    firstword 名称拼音首字母 string 模糊匹配
    name 名称 string 模糊匹配中文行政区划地名
  3. 响应数据参数
    参数名 参数 数据类型 示例值 说明
    id ID int 存储在系统中的ID值
    pid 上级id int 其上级区划id
    sort 显示排序值 int 显示排序值,从小往大排
    center_lng 区域中心经度 float 中心经度值
    center_lat 区域中心纬度 float 中心坐标上的纬度值
    adcode 地区代码 string 对应高德的地区代码,该值不唯一
    citycode 城市代码 string 对应高德citycode
    zipcode 邮编 string 邮编
    level 地区级别 string 返回值有:country国,provice省,city市,district区,street街
    firstword 名称拼音首字母 string 指的是简称的
    name 简称 string 地区简称,如『四川省』简称『四川』
    fullname 全称 string 地区全称
  4. 请求示例
    请求例子:
     
    apirq('district', {
        data: {
            "row": 10,
            "pid": 1
        }
    }) 
    
    返回数据结果:
     
    {
        "code": 0,
        "msg": "ok",
        "time": "1523867255",
        "data": {
            "page": 1,
            "row": 10,
            "count": 10,
            "total_count": 34,
            "total_page": 4,
            "lists": [
                {
                    "id": 2,
                    "pid": 1,
                    "sort": 0,
                    "center_lng": "116.407394",
                    "center_lat": "39.904211",
                    "adcode": "110000",
                    "citycode": "010",
                    "zipcode": "",
                    "level": "province",
                    "firstword": "bjs",
                    "name": "北京市",
                    "fullname": "北京市"
                },
                {
                    "id": 361,
                    "pid": 1,
                    "sort": 0,
                    "center_lng": "106.551643",
                    "center_lat": "29.562849",
                    "adcode": "500000",
                    "citycode": "023",
                    "zipcode": "",
                    "level": "province",
                    "firstword": "zqs",
                    "name": "重庆市",
                    "fullname": "重庆市"
                },
                {
                    "id": 1569,
                    "pid": 1,
                    "sort": 0,
                    "center_lng": "113.543028",
                    "center_lat": "22.186835",
                    "adcode": "820000",
                    "citycode": "1853",
                    "zipcode": "",
                    "level": "province",
                    "firstword": "amtbhzq",
                    "name": "澳门特别行政区",
                    "fullname": "澳门特别行政区"
                },
                {
                    "id": 1578,
                    "pid": 1,
                    "sort": 0,
                    "center_lng": "113.266410",
                    "center_lat": "23.132324",
                    "adcode": "440000",
                    "citycode": "",
                    "zipcode": "",
                    "level": "province",
                    "firstword": "gds",
                    "name": "广东省",
                    "fullname": "广东省"
                },
                {
                    "id": 3462,
                    "pid": 1,
                    "sort": 0,
                    "center_lng": "119.295143",
                    "center_lat": "26.100779",
                    "adcode": "350000",
                    "citycode": "",
                    "zipcode": "",
                    "level": "province",
                    "firstword": "fjs",
                    "name": "福建省",
                    "fullname": "福建省"
                },
                {
                    "id": 4657,
                    "pid": 1,
                    "sort": 0,
                    "center_lng": "110.349228",
                    "center_lat": "20.017377",
                    "adcode": "460000",
                    "citycode": "",
                    "zipcode": "",
                    "level": "province",
                    "firstword": "hns",
                    "name": "海南省",
                    "fullname": "海南省"
                },
                {
                    "id": 4926,
                    "pid": 1,
                    "sort": 0,
                    "center_lng": "112.562678",
                    "center_lat": "37.873499",
                    "adcode": "140000",
                    "citycode": "",
                    "zipcode": "",
                    "level": "province",
                    "firstword": "sxs",
                    "name": "山西省",
                    "fullname": "山西省"
                },
                {
                    "id": 6453,
                    "pid": 1,
                    "sort": 0,
                    "center_lng": "121.509062",
                    "center_lat": "25.044332",
                    "adcode": "710000",
                    "citycode": "1886",
                    "zipcode": "",
                    "level": "province",
                    "firstword": "tws",
                    "name": "台湾省",
                    "fullname": "台湾省"
                },
                {
                    "id": 6454,
                    "pid": 1,
                    "sort": 0,
                    "center_lng": "106.705460",
                    "center_lat": "26.600055",
                    "adcode": "520000",
                    "citycode": "",
                    "zipcode": "",
                    "level": "province",
                    "firstword": "gzs",
                    "name": "贵州省",
                    "fullname": "贵州省"
                },
                {
                    "id": 8074,
                    "pid": 1,
                    "sort": 0,
                    "center_lng": "108.327546",
                    "center_lat": "22.815478",
                    "adcode": "450000",
                    "citycode": "",
                    "zipcode": "",
                    "level": "province",
                    "firstword": "gxzzzzq",
                    "name": "广西壮族自治区",
                    "fullname": "广西壮族自治区"
                }
            ]
        }
    } 
    
本书创建于 2018-03-30 12:03:13 ?如有疑问,请联系技术人员