【使用攻略】【图像技术】红酒识别
一、需求描述
“来一瓶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)
JsonConvert.DeserializeObject(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、此外，红酒数据库内容还不够丰富，有些红酒不能识别，或不能提供更加详细的内容。
