电商四级地址库查询
电商四级地址库查询,查询全国包括省、市、区、街道等4级地址库。 如果特定电商场景要用到对应的地址code,则传入对应电商平台标识。
配置说明
- 是否需要商家授权:不需要
- 权限名称:电商四级地址库查询
1.请求参数:
请求URL:
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
appid | String | 是 | 合作伙伴AppId | |
timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
sign | String | 是 | ||
op | int | 是 | 1 | 1:淘宝 |
parent_code | int | 否 | 0 | 0表示根级节点,为全国的省级 |
name | String | 否 | 三里屯 | 省或市或区或街道的名称,配合level参数 |
level | String | 否 | Town | 表示查询哪级地址,如:Province :省,City:市 ,District :(区), Town: 街道,配合name参数 |
2. 请求示例代码(Java)
@Test
public void addrQuery() throws Exception {
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("op","1" );
data.put("parent_code","0" );
// 参数签名
data.put("sign", Utils.Sign(data,Config.AppSecret));
doHttpRequest(Config.AddrQueryUrl, data);
}
3. 返回结果
返回结果如下
{
"code": 0,
"message": "ok",
"data": [
{
"parent_code": 0,
"code": 310000000000,
"province": "",
"city": "",
"district": "",
"name": "上海",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 530000000000,
"province": "",
"city": "",
"district": "",
"name": "云南省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 150000000000,
"province": "",
"city": "",
"district": "",
"name": "内蒙古自治区",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 110000000000,
"province": "",
"city": "",
"district": "",
"name": "北京",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 220000000000,
"province": "",
"city": "",
"district": "",
"name": "吉林省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 510000000000,
"province": "",
"city": "",
"district": "",
"name": "四川省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 120000000000,
"province": "",
"city": "",
"district": "",
"name": "天津",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 640000000000,
"province": "",
"city": "",
"district": "",
"name": "宁夏回族自治区",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 340000000000,
"province": "",
"city": "",
"district": "",
"name": "安徽省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 370000000000,
"province": "",
"city": "",
"district": "",
"name": "山东省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 140000000000,
"province": "",
"city": "",
"district": "",
"name": "山西省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 440000000000,
"province": "",
"city": "",
"district": "",
"name": "广东省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 450000000000,
"province": "",
"city": "",
"district": "",
"name": "广西壮族自治区",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 650000000000,
"province": "",
"city": "",
"district": "",
"name": "新疆维吾尔自治区",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 320000000000,
"province": "",
"city": "",
"district": "",
"name": "江苏省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 360000000000,
"province": "",
"city": "",
"district": "",
"name": "江西省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 130000000000,
"province": "",
"city": "",
"district": "",
"name": "河北省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 410000000000,
"province": "",
"city": "",
"district": "",
"name": "河南省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 330000000000,
"province": "",
"city": "",
"district": "",
"name": "浙江省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 460000000000,
"province": "",
"city": "",
"district": "",
"name": "海南省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 420000000000,
"province": "",
"city": "",
"district": "",
"name": "湖北省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 430000000000,
"province": "",
"city": "",
"district": "",
"name": "湖南省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 620000000000,
"province": "",
"city": "",
"district": "",
"name": "甘肃省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 350000000000,
"province": "",
"city": "",
"district": "",
"name": "福建省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 540000000000,
"province": "",
"city": "",
"district": "",
"name": "西藏自治区",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 520000000000,
"province": "",
"city": "",
"district": "",
"name": "贵州省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 210000000000,
"province": "",
"city": "",
"district": "",
"name": "辽宁省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 500000000000,
"province": "",
"city": "",
"district": "",
"name": "重庆",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 610000000000,
"province": "",
"city": "",
"district": "",
"name": "陕西省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 630000000000,
"province": "",
"city": "",
"district": "",
"name": "青海省",
"level": "Province",
"op": 1
},
{
"parent_code": 0,
"code": 230000000000,
"province": "",
"city": "",
"district": "",
"name": "黑龙江省",
"level": "Province",
"op": 1
}
],
"trace_id": ""
}
返回code为0表示成功, 非0为失败,失败时message会有失败原因。
文档更新时间: 2025-03-21 14:38 作者:admin