跳转到内容
Cheeli 文档
返回官网

查询地址区域

查询标准地址区域代码信息, 基于国家统计局的行政区域代码。

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/logistices/areas/get

参数名类型说明示例
appidString合作伙伴AppIduwkahf@jfs92
timestampString当前时间戳
tb_seller_nickString淘宝卖家店铺登录账号，非店铺名称kingdo
signStringtrue999de41d862efaa6f1084ead3b3ba480

二、请求示例代码

Java

@Test
    public void  TaoBaoGetAreas() throws Exception {


        String tb_seller_nick = Config.TBSellerNick ;
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("tb_seller_nick", tb_seller_nick);
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        doHttpRequest(Config.TaoBaoGetAreasUrl ,data);


    }

三、返回结果

由于本接口返回全量数据，为方便篇幅，数据做了删减。以接口实际返回数据准。

{
  "code": 0,
  "message": "ok",
  "data": [
    {
      "id": 1,
      "type": 1,
      "name": "中国",
      "parent_id": 0,
      "zip": ""
    },


    {
      "id": 659002,
      "type": 4,
      "name": "阿拉尔市",
      "parent_id": 650000,
      "zip": "843300"
    },
    {
      "id": 659003,
      "type": 4,
      "name": "图木舒克市",
      "parent_id": 650000,
      "zip": "843806"
    },
    {
      "id": 659000,
      "type": 3,
      "name": "可克达拉市",
      "parent_id": 650000,
      "zip": ""
    },
    {
      "id": 659001,
      "type": 4,
      "name": "石河子市",
      "parent_id": 650000,
      "zip": "832000"
    },
    {
      "id": 659006,
      "type": 4,
      "name": "铁门关市",
      "parent_id": 650000,
      "zip": ""
    },
    {
      "id": 659007,
      "type": 4,
      "name": "双河市",
      "parent_id": 650000,
      "zip": ""
    },
    {
      "id": 659004,
      "type": 4,
      "name": "五家渠市",
      "parent_id": 650000,
      "zip": "831300"
    },
    {
      "id": 659005,
      "type": 4,
      "name": "北屯市",
      "parent_id": 650000,
      "zip": ""
    },
    {
      "id": 659010,
      "type": 4,
      "name": "胡杨河市",
      "parent_id": 650000,
      "zip": ""
    },
    {
      "id": 659011,
      "type": 4,
      "name": "新星市",
      "parent_id": 650000,
      "zip": ""
    },
    {
      "id": 659008,
      "type": 4,
      "name": "可克达拉市",
      "parent_id": 650000,
      "zip": ""
    },
    {
      "id": 659009,
      "type": 4,
      "name": "昆玉市",
      "parent_id": 650000,
      "zip": ""
    },
    {
      "id": 530000,
      "type": 2,
      "name": "云南省",
      "parent_id": 1,
      "zip": ""
    },
    {
      "id": 530111,
      "type": 4,
      "name": "官渡区",
      "parent_id": 530100,
      "zip": "650220"
    },
    {
      "id": 530100,
      "type": 3,
      "name": "昆明市",
      "parent_id": 530000,
      "zip": "650000"
    },
    {
      "id": 530102,
      "type": 4,
      "name": "五华区",
      "parent_id": 530100,
      "zip": "650032"
    },
    {
      "id": 530103,
      "type": 4,
      "name": "盘龙区",
      "parent_id": 530100,
      "zip": "650051"
    },
    {
      "id": 530121,
      "type": 4,
      "name": "呈贡区",
      "parent_id": 530100,
      "zip": "650500"
    },
    {
      "id": 530122,
      "type": 4,
      "name": "晋宁区",
      "parent_id": 530100,
      "zip": "650600"
    },
    {
      "id": 530124,
      "type": 4,
      "name": "富民县",
      "parent_id": 530100,
      "zip": "650400"
    },
    {
      "id": 530125,
      "type": 4,
      "name": "宜良县",
      "parent_id": 530100,
      "zip": "652100"
    },
    {
      "id": 530126,
      "type": 4,
      "name": "石林彝族自治县",
      "parent_id": 530100,
      "zip": "652200"
    },
    {
      "id": 530127,
      "type": 4,
      "name": "嵩明县",
      "parent_id": 530100,
      "zip": "651700"
    },
    {
      "id": 530112,
      "type": 4,
      "name": "西山区",
      "parent_id": 530100,
      "zip": "650100"
    },
    {
      "id": 530113,
      "type": 4,
      "name": "东川区",
      "parent_id": 530100,
      "zip": "654100"
    },
    {
      "id": 530128,
      "type": 4,
      "name": "禄劝彝族苗族自治县",
      "parent_id": 530100,
      "zip": "651500"
    },
    {
      "id": 530129,
      "type": 4,
      "name": "寻甸回族彝族自治县",
      "parent_id": 530100,
      "zip": "655200"
    },
    {
      "id": 530181,
      "type": 4,
      "name": "安宁市",
      "parent_id": 530100,
      "zip": "650300"
    },
    {
      "id": 530182,
      "type": 4,
      "name": "其它区",
      "parent_id": 530100,
      "zip": ""
    },
    {
      "id": 530300,
      "type": 3,
      "name": "曲靖市",
      "parent_id": 530000,
      "zip": "655000"
    },
    {
      "id": 530302,
      "type": 4,
      "name": "麒麟区",
      "parent_id": 530300,
      "zip": "655000"
    }
  ]
}

说明： code为0表示成功，非0为失败，tid为本次发货的订单号, message会包含失败原因。

四、返回参数说明

参数名称类型示例值描述
datadata[]地址区域信息列表。
idNumber255标准行政区域代码。
typeNumber1区域类型。
area: 区域
1: country/国家;
2: province/省/自治区/直辖市;
3: city/地区(省下面的地级市);
4: district/县/市(县级市)/区;
abroad: 海外。比如北京市的 area_type = 2, 朝阳区是北京市的一个区, 所以朝阳区的 area_type = 4。
nameString北京市地域名称。如北京市、杭州市、西湖区，每一个 area_id 都代表了一个具体的地区。
parent_idNumber141141父节点区域标识。如北京市的 area_id 是 110100，朝阳区是北京市的一个区，所以朝阳区的 parent_id 就是北京市的 area_id。
zipString421403