快宝开放平台地址清洗接口 HarmonyOS 鸿蒙Next

快宝开放平台地址清洗接口 HarmonyOS 鸿蒙Next 地址清洗

应用场景

1. 电商平台、电商ERP、物流应用等需要对客户输入的地址信息进行清洗、识别，转化为包含省、市、区、乡镇街道、详细地址等结构化信息。
2. 需要将包含了不规范的行政区域名称、过时的旧称呼、已经撤销或合并的行政区域名称的地址，转化为规范、最新、准确的行政区域名称。
3. 给定的地址不完整，需要补全省、市、区县、乡镇等信息。

主要功能

1. 将包含地址信息的文本，识别为结构化的地址信息，返回省、市、区、乡镇、详细地址等分段信息，能够智能补全缺失的行政区域，过滤掉重复、冗余信息。
2. 对于包含了不规范的行政区域名称、过时的旧称呼、已经撤销或合并的行政区域名称的地址，可以通过该接口解析为规范、最新、准确的行政区域名称。
3. 返回行政区域全称、简称、代码等详细信息。

额外说明

技术咨询请加微信：kuaibao135

接口名称

cloud.address.cleanse

公共参数

请求地址

公共请求参数

公共响应参数

请求参数

响应参数

请求示例

import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;

import java.util.Map;
import java.util.HashMap;

import java.util.Date;

public class Request {

public static void main(String[] args) {
String host = "http://kop.kuaidihelp.com";
String path = "/api";
String requestMethod = "POST";
Map<String, String> headers = new HashMap<>();
//根据API的要求，定义相对应的Content-Type
headers.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");
Map<String, String> querys = new HashMap<>();
Map<String, String> bodys = new HashMap<>();

String appId = "50001";
String method = "cloud.address.cleanse";
// 当前时间戳
String ts = new Date().getTime() + "";
String appKey = "bdf3b5f50865ac813cbdfd6c9b572b79";

// 计算签名
String signStr = appId + method + ts + appKey;
String sign = Request.getMD5(signStr, 32);

bodys.put("app_id", appId);
bodys.put("method", method);
bodys.put("ts", ts);
bodys.put("sign", sign);
// data参数是个json格式的字符串  建议使用函数或方法去生成
bodys.put("data", "{"
    "multimode:true,"
    "address": 广东省梅州市五华县安流镇青江村琴江御城201商场\r深圳市龙华新区观澜街道库坑新围村皇帝印工业区D栋\r杭州市中河中路258号瑞丰国际商务大厦5F,"
    "cleanTown":true
}");

try {
    /**
    * 重要提示如下:
    * HttpUtils请从
    * https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java
    * 下载
    *
    * 相应的依赖请参照
    * https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml
    */
    HttpResponse response = HttpUtils.doPost(host, path, requestMethod, headers, querys, bodys);
    System.out.println(response.toString());
    
        //获取response的body
        System.out.println(EntityUtils.toString(response.getEntity()));
    } catch (Exception e) {
        e.printStackTrace();
    }
}

    // 计算md5
    public static String getMD5(String plainText, int length) {
        try {
            MessageDigest md = MessageDigest.getInstance("MD5"); //获取MD5实例
            md.update(plainText.getBytes()); //此处传入要加密的byte类型值
            byte[] digest = md.digest(); //此处得到的是md5加密后的byte类型值

            /*
               下边的运算就是自己添加的一些二次小加密，记住这个千万不能弄错乱，
                   否则在解密的时候，你会发现值不对的（举例：在注册的时候加密方式是一种，
                在我们登录的时候是不是还需要加密它的密码然后和数据库的进行比对，但是
            最后我们发现，明明密码对啊，就是打不到预期效果，这时候你就要想一下，你是否
             有改动前后的加密方式）   
            */
            int i;
            StringBuilder sb = new StringBuilder();
            for (int offset = 0; offset < digest.length; offset++) {
                i = digest[offset];
                if (i < 0)
                    i += 256;
                if (i < 16)
                    sb.append(0);
                sb.append(Integer.toHexString(i)); //通过Integer.toHexString方法把值变为16进制
            }
            return sb.toString().substring(0, length); //从下标0开始，length目的是截取多少长度的值
        } catch (NoSuchAlgorithmException e) {
            e.printStackTrace();
            return null;
        }
    }
}

响应示例

成功响应示例

{
    "code": 0,
    "msg": "成功",
    "data": [
        {
            "original": "广东省梅州市五华县安流镇青江村琴江御城201商场",
            "province": "广东省",
            "province_id": "5876",
            "province_code": "440000",
            "province_shortname": "广东",
            "city": "梅州市",
            "city_id": "6068",
            "city_code": "441400",
            "city_shortname": "梅州",
            "county": "五华县",
            "county_id": "6077",
            "county_code": "441424",
            "county_shortname": "五华",
            "town": "安流镇",
            "town_id": "906952",
            "town_code": "",
            "address": "青江村琴江御城201商场"
        },
        {
            "original": "深圳市龙华新区观澜街道库坑新围村皇帝印工业区D栋",
            "province": "广东省",
            "province_id": "5876",
            "province_code": "440000",
            "province_shortname": "广东",
            "city": "深圳市",
            "city_id": "5947",
            "city_code": "440300",
            "city_shortname": "深圳",
            "county": "龙华区",
            "county_id": "882409",
            "county_code": "460106",
            "county_shortname": "龙华",
            "town": "观澜街道",
            "town_id": "906263",
            "town_code": "",
            "address": "库坑新围村皇帝印工业区D栋"
        },
        {
            "original": "杭州市中河中路258号瑞丰国际商务大厦5F ",
            "province": "浙江省",
            "province_id": "334",
            "province_code": "330000",
            "province_shortname": "浙江",
            "city": "杭州市",
            "city_id": "336",
            "city_code": "330100",
            "city_shortname": "杭州",
            "county": "上城区",
            "county_id": "339",
            "county_code": "",
            "county_shortname": "上城",
            "town": "小营街道",
            "town_id": "882646",
            "town_code": "",
            "address": "中河中路258号瑞丰国际商务大厦5F"
        }
    ]
}

异常响应示例

{
    "code": 400001,
    "msg": "业务参数有误，请检查",
    "uid": "a6934adee62d8ba3430d4ac678dd5f46c7a79d6e",
    "data": {}
}

错误代码