快宝开放平台地址清洗api文档

[color=rgba(0, 0, 0, 0.45)][color=rgba(0, 0, 0, 0.45)]API文档/地址库服务/地址清洗

应用场景

1. 电商平台、电商ERP、物流应用等需要对客户输入的地址信息进行清洗、识别，转化为包含省、市、区、乡镇街道、详细地址等结构化信息

2. 需要将包含了不规范的行政区域名称、过时的旧称呼、已经撤销或合并的行政区域名称的地址，转化为规范、最新、准确的行政区域名称

3. 给定的地址不完整，需要补全省、市、区县、乡镇等信息

主要功能

1. 将包含地址信息的文本，识别为结构化的地址信息，返回省、市、区、乡镇、详细地址等分段信息，能够智能补全缺失的行政区域，过滤掉重复、冗余信息

2. 对于包含了不规范的行政区域名称、过时的旧称呼、已经撤销或合并的行政区域名称的地址，可以通过该接口解析为规范、最新、准确的行政区域名称

3. 返回行政区域全称、简称、代码等详细信息

额外说明

技术咨询请加微信：kuaibao135

接口名称

cloud.address.cleanse

公共参数
请求地址

环境名称

HTTPS请求地址

正式地址https://kop.kuaidihelp.com/api






公共请求参数

名称

类型

是否必须

描述

methodstring是API接口名称

app_idstring是用户ID（注册开放平台时分配，在控制台中查看）

signstring是按照规则(md5(app_id + method + ts + api_key))生成的合法性验证签名(32位字符串，字母小写)如:10000cloud.print.do1524209949bdf3b5f50865ac813cbdfd6c9b572b79加密后5030cae3388ecdc2e686379753a0564c

tsstring是当前请求的时间戳(10位或13位)

datastring是JSON格式请求参数







公共响应参数

名称

类型

是否必须

描述

codeint是响应状态码。0-成功，非0-失败下载并查看详情

msgstring是返回结果说明

uidstring是本次请求唯一业务流水号

datastring是JSON格式响应数据








请求参数

名称

类型

是否必须

描述

textstring是包含地址信息的文本，批量模式下多条地址用回车或换行符（\r或\n）分隔

multimodebool否是否为批量模式，false为非批量，此时整个text参数认为是一条地址；true为批量，此时根据text参数中的换行符区隔多条地址。默认为true

cleanTownint否是否从地址中清洗乡镇、街道级别行政区域信息。0：不清洗，1：地址中包含有乡镇、街道名称，则清洗，否则不清洗，2：不管地址中是否包含乡镇、街道名称，都尝试清洗乡镇信息。默认值为0。若值为1或2，返回结果中会包含town，town_id， town_code字段，address字段中将不再包含乡镇级别行政区域信息







响应参数

名称

类型

是否必须

描述

provincestring是省级名称。响应体的data字段为一数组，每个数组元素为一条解析结果，本节描述的是每个元素的字段

province_idstring是省级快宝编号

province_codestring是省级行政编码

province_shortnamestring是省级简称

citystring是市级名称

city_idstring是市级快宝编号

city_codestring是市级行政编码

city_shortnamestring是市级简称

countystring是县级名称

county_idstring是县级快宝编号

county_codestring是县级行政编码

county_shortnamestring是县级简称

townstring否乡镇名称(只有cleanTown=True时,才有值返回)

town_idstring否乡镇快宝编号(只有cleanTown=True时,才有值返回)

town_codestring否乡镇行政编码(只有cleanTown=True时,才有值返回)

addressstring是详细地址

originalstring是输入的原始文本

resstring是是否返回完整结果

addressstring是详细地址

originalstring是输入的原始文本

resstring是是否返回完整结果

province_confidenceint是省级信息解析准确度字段，当返回值小于3时认为准确度相对较低有识别错误概率，该字段可用于客户端提示用户检查地址信息时使用；

city_confidenceint是市级信息解析准确度字段，当返回值小于3时认为准确度相对较低有识别错误概率，该字段可用于客户端提示用户检查地址信息时使用；

county_confidenceint是区级信息解析准确度字段，当返回值小于3时认为准确度相对较低有识别错误概率，该字段可用于客户端提示用户检查地址信息时使用；







请求示例
Java

C#

Python

PHP

Node.js

Curl






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<String, String>();//根据API的要求，定义相对应的Content-Typeheaders.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");Map<String, String> querys = new HashMap<String, String>();Map<String, String> bodys = new HashMap<String, String>();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-ga ... util/HttpUtils.java        * 下载        *        * 相应的依赖请参照        * https://github.com/aliyun/api-ga ... 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;        }    }}




响应示例
成功响应示例
JSON示例







{
"code":int0


"msg":string"成功"



"data":[

0:{
"original":string" 广东省梅州市五华县安流镇青江村琴江御城201商场"


"province":string"广东省"


"province_id":string"5876"


"province_code":string"440000"


"province_shortname":string"广东"


"city":string"梅州市"


"city_id":string"6068"


"city_code":string"441400"


"city_shortname":string"梅州"


"county":string"五华县"


"county_id":string"6077"


"county_code":string"441424"


"county_shortname":string"五华"


"town":string"安流镇"


"town_id":string"906952"


"town_code":string""


"address":string"青江村琴江御城201商场"




}

1:{
"original":string"深圳市龙华新区观澜街道库坑新围村皇帝印工业区D栋"


"province":string"广东省"


"province_id":string"5876"


"province_code":string"440000"


"province_shortname":string"广东"


"city":string"深圳市"


"city_id":string"5947"


"city_code":string"440300"


"city_shortname":string"深圳"


"county":string"龙华区"


"county_id":string"882409"


"county_code":string"460106"


"county_shortname":string"龙华"


"town":string"观澜街道"


"town_id":string"906263"


"town_code":string""


"address":string"库坑新围村皇帝印工业区D栋"




}

2:{
"original":string"杭州市中河中路258号瑞丰国际商务大厦5F "


"province":string"浙江省"


"province_id":string"334"


"province_code":string"330000"


"province_shortname":string"浙江"


"city":string"杭州市"


"city_id":string"336"


"city_code":string"330100"


"city_shortname":string"杭州"


"county":string"上城区"


"county_id":string"339"


"county_code":string""


"county_shortname":string"上城"


"town":string"小营街道"


"town_id":string"882646"


"town_code":string""


"address":string"中河中路258号瑞丰国际商务大厦5F"




}


]


}








异常响应示例
JSON示例







{
"code":int400001


"msg":string"业务参数有误，请检查"


"uid":string"a6934adee62d8ba3430d4ac678dd5f46c7a79d6e"



"data":{}



}









备注：微信咨询：13122911354

问卷网址：http://wyyttifyc51khq40.mikecrm.com/yMqSEGU

平台链接：https://open.kuaidihelp.com/api/1019