手把手教你使用百度大脑地址识别API

Posted 2020-12-23 AIBOOM

作者：让天涯

最近笔者在某小程序上购物时发现，不管公司大小、客户多少，凡是涉及到电商基本上都有自己的下单系统，业务十分成熟。想到各家快递公司，都有独立的下单平台，出于好奇笔者在网上搜索了下，发现百度大脑竟然有地址识别接口，赶紧来试一波。测试后发现，这个接口能大幅提升地址文本的处理效率，非常适合物流、快递、电商、贸易行业，有了它就可以自己搭建快递下单平台了。

一、 百度大脑地址识别的功能和亮点

通过百度大脑地址识别产品页面上的介绍，笔者罗列了这个接口的一些功能点和亮点：

1.针对快递、电商行业客户在线提交的大量非结构化地址单据，该接口可以帮助提取单据中的姓名、电话、地址信息；

2. 融合百度地图权威数据，自动补全地址中缺失的信息和错误纠正，地址信息的识别准召率可达到88%；

3. 融合词法分析技术，自动识别文本中的人名和电话信息，识别准确率可达97%以上；

4. 基于语义分析构建的智能算法与场景策略相配合，平均准召率可达95%。

二、百度大脑地址识别的应用场景

从接口名称可以了解到，地址识别可以用于快递下单发货以及电商客户订单处理等场景。

三、百度大脑地址识别的使用攻略

接下来一步步带领大家调用地址识别API接口。需要说明的是，[X1] 本文采用C# 语言，开发环境为.Net Core 3.1，采用在线API接口方式实现。

（1）平台接入
登陆 百度智能云-管理中心 创建 “自然语言处理”应用，获取 “API Key ”和 “Secret Key”：https://console.bce.baidu.com/ai/?_=1578390135051&fromai=1#/ai/nlp/app/list

（2）接口文档

文档地址：https://ai.baidu.com/ai-doc/NLP/vk6z52h5n

请求说明

HTTP方法：POST
请求URL：https://aip.baidubce.com/rpc/2.0/nlp/v1/address
URL参数：

Header如下：

Body中放置请求参数，参数详情如下：

{
    "text": "上海市浦东新区纳贤路701号百度上海研发中心 F4A000 张三"
}

body整体文本内容可以支持GBK和UTF-8两种格式的编码。

1、GBK支持：默认按GBK进行编码，输入内容为GBK编码，输出内容为GBK编码，否则会接口报错编码错误

2、UTF-8支持：若文本需要使用UTF-8编码，请在url参数中添加charset=UTF-8 （大小写敏感） 例如 https://aip.baidubce.com/rpc/2.0/nlp/v1/lexer?charset=UTF-8&access_token=24.f9ba9c5241b67688bb4adbed8bc91dec.2592000.1485570332.282335-8574074

请求参数

返回说明
返回参数

返回格式

JSON格式

默认返回内容为GBK编码

若用户指定输入为UTF-8编码（通过指定charset参数），则返回内容为UTF-8编码

返回示例：

{
    "province": "上海市",
    "city": "上海市",
    "province_code": "310000",
    "log_id": 1420038644986026316,
    "text": "上海市浦东新区纳贤路701号百度上海研发中心 F4A000 张三",
    "town": "张江镇",
    "phonenum": "",
    "detail": "纳贤路701号百度上海研发中心F4A000",
    "county": "浦东新区",
    "person": "张三",
    "town_code": "310115125",
    "county_code": "310115",
    "city_code": "310100"
}

（3）源码共享

（3-1）根据 API Key 和 Secret Key 获取 AccessToken

/// 
/// 获取百度access_token
/// 
/// API Key
/// Secret Key
/// 
public static string GetAccessToken(string clientId, string clientSecret)
{
    string authHost = "https://aip.baidubce.com/oauth/2.0/token";
    HttpClient client = new HttpClient();
    List paraList = new List();
    paraList.Add(new KeyValuePair("grant_type", "client_credentials"));
    paraList.Add(new KeyValuePair("client_id", clientId));
    paraList.Add(new KeyValuePair("client_secret", clientSecret));

    HttpResponseMessage response = client.PostAsync(authHost, new FormUrlEncodedContent(paraList)).Result;
    string result = response.Content.ReadAsStringAsync().Result;
    JObject jo = (JObject)JsonConvert.DeserializeObject(result);

    string token = jo["access_token"].ToString();
    return token;
}

（3-2）调用API接口获取识别结果

（3-2-1） 建立Index.cshtml文件

（3-2-1-1）前台代码：

    由于html代码无法原生显示，只能简单说明一下：

    主要是一个form表单，需要设置属性method="post"；

    form表单里面有几个控件：

一个Input：type="file"，asp-for="Text" ，输入地址信息；

一个Input：type="submit"，asp-page-handler="Address" ，提交请求。

（3-2-1-2） 后台代码： 

主程序代码：

[BindProperty]
public string Text { get; set; }
public List msg = new List();
public string curPath { get; set; }

string NLP_API_KEY="你的API KEY";
string NLP_SECRET_KEY="你的SECRET KEY";

public async Task OnPostAddressAsync()
{
    if (string.IsNullOrEmpty(Text))
    {
        ModelState.AddModelError(string.Empty, "请输入具体内容！");
    }
    if (!ModelState.IsValid)
    {
        return Page();
    }
    msg = new List();

    DateTime startTime = DateTime.Now;

    string result = GetNLPJson(Text, NLP_API_KEY, NLP_SECRET_KEY);

    DateTime endTime = DateTime.Now;
    TimeSpan ts = endTime - startTime;

    JObject jo = (JObject)JsonStringToObj(result);

    try
    {
        msg.Add("地址识别结果（耗时" + ts.TotalSeconds + "秒）：
");
        msg.Add("联系人");
        msg.Add("姓名：" + jo["person"].ToString());
        msg.Add("电话号码：" + jo["phonenum"].ToString());
        msg.Add("地址");
        msg.Add("省：" + jo["province"].ToString());
        msg.Add("市：" + jo["city"].ToString());
        msg.Add("区（县）：" + jo["county"].ToString());
        msg.Add("街道（乡/镇）：" + jo["town"].ToString());
        msg.Add("详细地址：" + jo["detail"].ToString());

        msg.Add(result);
    }
    catch (Exception e)
    {
        msg.Add(result);
    }
    return Page();
}

其他相关函数：

/// 
/// 自然语言处理Json字符串
/// 
/// 内容
/// API Key
/// Secret Key
/// 
public static string GetNLPJson(string text, string clientId, string clientSecret)
{
    string token = GetAccessToken(clientId, clientSecret);
    string host = "https://aip.baidubce.com/rpc/2.0/nlp/v1/address?charset=UTF-8&access_token=" + token;
    Encoding encoding = Encoding.Default;
    HttpWebRequest request = (HttpWebRequest)WebRequest.Create(host);
    request.Method = "post";
    request.ContentType = "application/json";
    request.KeepAlive = true;
    string str = "{"text":"" + text;
    str += ""}";
    byte[] buffer = encoding.GetBytes(str);
    request.ContentLength = buffer.Length;
    request.GetRequestStream().Write(buffer, 0, buffer.Length);
    HttpWebResponse response = (HttpWebResponse)request.GetResponse();
    StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8);
    string result = reader.ReadToEnd();
    return result;
}

/// 
/// 获取百度access_token
/// 
/// API Key
/// Secret Key
/// 
public static string GetAccessToken(string clientId, string clientSecret)
{
    string authHost = "https://aip.baidubce.com/oauth/2.0/token";
    HttpClient client = new HttpClient();
    List paraList = new List();
    paraList.Add(new KeyValuePair("grant_type", "client_credentials"));
    paraList.Add(new KeyValuePair("client_id", clientId));
    paraList.Add(new KeyValuePair("client_secret", clientSecret));

    HttpResponseMessage response = client.PostAsync(authHost, new FormUrlEncodedContent(paraList)).Result;
    string result = response.Content.ReadAsStringAsync().Result;
    JObject jo = (JObject)JsonConvert.DeserializeObject(result);

    string token = jo["access_token"].ToString();
    return token;
}

/// 
/// 生成一个随机唯一文件名（Guid）
/// 
/// 
public static string GetRandomName()
{
    return Guid.NewGuid().ToString("N");
}

/// 
/// json转为对象
/// 
/// Json字符串
/// 
public static Object JsonStringToObj(string jsonString)
{
    Object s = JsonConvert.DeserializeObject(jsonString);
    return s;
}

四、效果测试

1、页面：

2、笔者输入了5个地址，识别结果如下：

2.1

2.2

2.3

2.4

2.5

五、测试结果及建议

从上面的测试结果可以了解到，百度大脑地址识别API接口的识别速度基本上能够在半秒识别出来，并且准确度也不错，还能自动补齐或纠正地址信息，很方便。

考虑到百度大脑还有丰富的OCR技术和语音识别技术，在未来可以将文本输入、语音输入和图片输入考虑在内，做成综合的地址识别解决方案，方便各大快递公司或电商企业使用。

不过，联想到人们对地址、电话信息安全方面越来越重视，一些企业可以在隐私安全保护这方面下功夫。比如联合各大商城、快递公司，搭建统一地址管理平台，生成唯一的识别码/二维码，客户可以在平台填写身份地址信息，进行实名认证，然后使用唯一的识别码/二维码发送快递信息，既方便客户管理个人地址信息（不用再在各个平台去分别更新地址信息、进行实名认证），又加强了隐私安全保护。

一些个人想法，不过百度大脑地址识别是个可直接用于业务生产的接口，还是十分推荐的(*^▽^*)