【使用攻略】【图像技术】红酒识别

一、需求描述

“来一瓶82年的拉菲”，相信大家一定听过这个梗（对于红酒的认识，我也就只知道这个梗了，惭愧。。。），在红酒消费越来越趋平民化的今天，了解一些红酒知识还是有好处的。但是如果作为一个普通人，想要根据掌握的红酒知识，直接说出眼前的红酒的名称国家、产区、特点等信息，还是具有一定的困难的。

因此，如果能够使用百度AI的“红酒识别”技术，只需要简单拍张照，直接反馈给你眼前的红酒信息，相信还是会受到不少喜欢品酒的人的喜欢的。

二、使用攻略

说明：本文采用C# 语言，开发环境为.Net Core 2.1，采用在线API接口方式实现。
（1）平台接入

登陆 百度智能云-管理中心 创建 “图像识别”应用，获取 “API Key ”和 “Secret Key” ：https://console.bce.baidu.com/ai/?_=1563948654041&fromai=1#/ai/imagerecognition/overview/index
（2）接口文档

文档地址：https://ai.baidu.com/docs#/ImageClassify-API/71e05fb6

接口描述：该服务用于识别红酒标签，即对于输入的一张图片（可正常解码，长宽比适宜，且酒标清晰可见），输出图片中的红酒名称、国家、产区、酒庄、类型、糖分、葡萄品种、酒品描述等信息。可识别数十万中外常见红酒。
请求说明
请求示例

HTTP 方法：POST

请求URL： https://aip.baidubce.com/rest/2.0/image-classify/v1/redwine

URL参数：

参数	        值
access_token	通过API Key和Secret Key获取的access_token,参考“Access Token获取”

Header如下：

参数	        值
Content-Type	application/x-www-form-urlencoded

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

参数	是否必选	  类型	可选值范围	说明
image	是	string	-	Base64编码字符串，以图片文件形式请求时必填。(支持图片格式：jpg，bmp，png)，图片大小不超过4M。最短边至少15px，最长边最大4096px。 注意：图片的base64编码是不包含图片头的，如（data:image/jpg;base64,）

返回说明
返回参数

字段	是否必选	类型	说明
log_id	是	uint64	请求标识码，随机数，唯一
result	是	dict	识别结果
+hasdetail	是	unit	判断是否返回详细信息（除红酒中文名之外的其他字段），含有返回1，不含有返回0
+wineNameCn	是	string	红酒中文名，无法识别返回空，示例：波斯塔瓦经典赤霞珠品丽珠半甜红葡萄酒
+wineNameEn	否	string	红酒英文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：Bostavan Classic Cabernet
+countryCn	否	string	国家中文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：摩尔多瓦
+countryEn	否	string	国家英文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：Moldova
+regionCn	否	string	产区中文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：波尔多
+regionEn	否	string	产区英文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：Bordeaux
+subRegionCn	否	string	子产区中文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：梅多克
+subRegionEn	否	string	子产区英文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：Medoc
+wineryCn	否	string	酒庄中文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：波斯塔瓦酒庄
+wineryEn	否	string	酒庄英文名，hasdetail = 0时，表示无法识别，该字段不返回，示例：Vinaria Bostavan
+classifyByColor	否	string	酒类型，hasdetail = 0时，表示无法识别，该字段不返回，示例：红葡萄酒
+classifyBySugar	否	string	糖分类型，hasdetail = 0时，表示无法识别，该字段不返回，示例：半甜型
+color	否	string	色泽，hasdetail = 0时，表示无法识别，该字段不返回，示例：宝石红色
+grapeCn	否	string	葡萄品种，可能有多种葡萄，hasdetail = 0时，表示无法识别，该字段不返回，示例：品丽珠;赤霞珠
+grapeEn	否	string	葡萄品种英文名，可能有多种葡萄，hasdetail = 0时，表示无法识别，该字段不返回，示例：Cabernet Franc;Cabernet Sauvignon
+tasteTemperature	否	string	品尝温度，hasdetail = 0时，表示无法识别，该字段不返回，示例：6-11℃
+description	否	string	酒品描述，hasdetail = 0时，表示无法识别，该字段不返回，示例：葡萄酒呈深宝石红色，具有香料、香草和新鲜水果的果香，酒体分明，口感畅顺，果香横溢，单宁软化程度高，让你回味无穷

返回示例

仅识别出红酒名称，hasdetail = 0：

{
    "log_id": 3450013152046070669,
    "result":
    {
        "wineNameCn": "银色高地阙歌干红",
        "hasdetail":0
    }
}

识别出详细信息，hasdetail = 1：

{
    "log_id": 2495538539661269738,
    "result": {
        "classifyByColor": "红葡萄酒/Red Wine",
        "subRegionCn": "梅多克",
        "wineNameCn": "拉图嘉利庄园红葡萄酒（正牌）",
        "subRegionEn": "Medoc",
        "regionEn": "Bordeaux",
        "color": "深紫红色/Dark Violet",
        "wineNameEn": "Chateau La Tour Carnet",
        "hasdetail": 1,
        "wineryCn": "拉图嘉利庄园",
        "classifyBySugar": "干型/Dry",
        "tasteTemperature": "16-18℃",
        "regionCn": "波尔多",
        "wineryEn": "Chateau La Tour-Carnet",
        "grapeCn": "",
        "grapeEn": "",
        "countryCn": "法国",
        "countryEn": "France",
        "description": "此酒充满红果和黑果味道，并带有矿物质和花香（紫罗兰，玫瑰），混合些许香草气息，单宁柔软，余香悠长。在口中留下清新的味道，香料和香草味道萦绕口中。"
    }
}

（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接口获取识别结果

1、在Startup.cs 文件 的 Configure(IApplicationBuilder app, IHostingEnvironment env) 方法中开启虚拟目录映射功能：

string webRootPath = HostingEnvironment.WebRootPath;//wwwroot目录

            app.UseStaticFiles(new StaticFileOptions
            {
                FileProvider = new PhysicalFileProvider(
                    Path.Combine(webRootPath, "Uploads", "BaiduAIs")),
                RequestPath = "/BaiduAIs"
            });

2、 建立Index.cshtml文件

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

    主要是一个form表单，需要设置属性enctype="multipart/form-data"，否则无法上传图片；

    form表单里面有两个控件：

    一个Input：type="file"，asp-for="FileUpload" ，上传图片用；

    一个Input：type="submit"，asp-page-handler="Redwine" ，提交并返回识别结果。

    一个img：src="@Model.curPath"，显示需要识别的图片。

    最后显示后台 msg 字符串列表信息，如果需要输出原始Html代码，则需要使用@Html.Raw()函数。

2.2 后台代码：

 [BindProperty]
        public IFormFile FileUpload { get; set; }
        private readonly IHostingEnvironment HostingEnvironment;
        public List msg = new List();
        public string curPath { get; set; }

        public BodySearchModel(IHostingEnvironment hostingEnvironment)
        {
            HostingEnvironment = hostingEnvironment;
        }
 

        public async Task OnPostRedwineAsync()
        {
           
            if (FileUpload is null)
            {
                ModelState.AddModelError(string.Empty, "本地图片！");
            }           
            if (!ModelState.IsValid)
            {
                return Page();
            }
            msg = new List();

            string webRootPath = HostingEnvironment.WebRootPath;//wwwroot目录
            string fileDir = Path.Combine(webRootPath, "Uploads//BaiduAIs//");
            string imgName = await UploadFile(FileUpload, fileDir);

            string fileName = Path.Combine(fileDir, imgName);
            string imgBase64 = GetFileBase64(fileName);
            curPath = Path.Combine("/BaiduAIs/", imgName);//需在Startup.cs 文件 的 Configure(IApplicationBuilder app, IHostingEnvironment env)方法中开启虚拟目录映射功能
 
            string result = GetImageJson( imgBase64, “你的API KEY”, “你的SECRET KEY”);
            JObject jo = (JObject)JsonStringToObj(result);

            try
            {
                msg.Add("红酒中文名：" + jo["result"]["wineNameCn"].ToString());
                if (jo["result"]["hasdetail"].ToString().Equals("1"))
                {
                    msg.Add("红酒英文名：" + jo["result"]["wineNameEn"].ToString());
                    msg.Add("国家：" + jo["result"]["countryCn"].ToString());
                    msg.Add("产区：" + jo["result"]["regionCn"].ToString());
                    msg.Add("子产区：" + jo["result"]["subRegionCn"].ToString());
                    msg.Add("酒庄：" + jo["result"]["wineryCn"].ToString());
                    msg.Add("酒类型：" + jo["result"]["classifyByColor"].ToString());
                    msg.Add("糖分类型：" + jo["result"]["classifyBySugar"].ToString());
                    msg.Add("色泽：" + jo["result"]["color"].ToString());
                    msg.Add("葡萄品种：" + jo["result"]["grapeCn"].ToString());
                    msg.Add("品尝温度：" + jo["result"]["tasteTemperature"].ToString());
                    msg.Add("酒品描述：" + jo["result"]["description"].ToString());
                }
            }
            catch (Exception e)
            {
                msg.Add(result);
            }
            return Page();
        }
        /// 
        /// 上传文件,返回文件名
        /// 
        /// 文件上传控件
        /// 文件绝对路径
        /// 
        public static async Task UploadFile(IFormFile formFile, string fileDir)
        {
            if (!Directory.Exists(fileDir))
            {
                Directory.CreateDirectory(fileDir);
            }
            string extension = Path.GetExtension(formFile.FileName);
            string imgName = Guid.NewGuid().ToString("N") + extension;
            var filePath = Path.Combine(fileDir, imgName);

            using (var fileStream = new FileStream(filePath, FileMode.Create, FileAccess.Write))
            {
                await formFile.CopyToAsync(fileStream);
            }

            return imgName;
        }
        /// 
        /// 返回图片的base64编码
        /// 
        /// 文件绝对路径名称
        /// 
        public static String GetFileBase64(string fileName)
        {
            FileStream filestream = new FileStream(fileName, FileMode.Open);
            byte[] arr = new byte[filestream.Length];
            filestream.Read(arr, 0, (int)filestream.Length);
            string baser64 =  Convert.ToBase64String(arr);
            filestream.Close();
            return baser64;
        }

        /// 
        /// 图像识别Json字符串
        /// 
        /// 图片base64编码
        /// API Key
        /// Secret Key
        /// 
        public static string GetImageJson(string strbaser64, string clientId, string clientSecret)
        {
            string token = GetAccessToken(clientId, clientSecret);
            string host = "https://aip.baidubce.com/rest/2.0/image-classify/v1/redwine?access_token=" + token;
            Encoding encoding = Encoding.Default;
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create(host);
            request.Method = "post";
            request.KeepAlive = true;
            string str = "image=" + HttpUtility.UrlEncode(strbaser64);
            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.Default);
            string result = reader.ReadToEnd();
            return result;
        }

三、效果测试
1、页面：

2、识别结果：

2.1

2.2

2.3

四、产品建议

1、希望能结合百度百科信息，提供更多的识别的红酒知识。

2、如果能提供如何辨别当前红酒真假的技巧信息就更好了。

3、此外，红酒数据库内容还不够丰富，有些红酒不能识别，或不能提供更加详细的内容。