# api

**Repository Path**: yiudaisin/api

## Basic Information

- **Project Name**: api
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-10-24
- **Last Updated**: 2021-01-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# api

文档名称 | A master of vegetables—— 识菜达人
-|-
产品名称 | A master of vegetables
产品描述 | 一款识别超过9千种菜品，适用于识别只含有单个菜品的图片，接口返回菜品的名称、置信度、卡路里、百科信息等综合信息的APP。
文档作者 | 姚卓凡 1910130043


## 一.价值主张

### （一）价值主张宣言

* 现如今科学技术的发展带动了拍摄、摄影技术硬件的发展，手机、照相机等拍摄工具越来越凸显普遍化、便利化，其中ai识别工具日益显著，ai识别中的菜品识别是基于菜品的表面特征信息进行标名识别的一种物品识别技术。用摄像机或摄像头采集含有菜品的图像或视频流，并自动在图像中检测和跟踪菜品，进而对检测到的菜品进行菜品识别的一系列相关技术，通常也叫做餐品识别、饭菜识别。给更多热爱美食的人士人士更多的美食，其中识别后会出现菜品烹饪流程与方法，个别菜式能显示出菜品热量及营养成分。


### （二）核心价值

* **菜品识别**1、可根据不同个体的身体状况和健身目标（增肌/减脂）设定饮食指标，建立个人身体档案，提供科学的热量摄入建议； 

2、基于百度菜品识别技术，只需一键拍照上传即可轻松识别食物类别、热量及营养成份，通过表格自动记录每日的饮食摄入热量，代替手工查询、记录， 识别准确率达到98%以上； 

3、帮助更多人学习菜式烹饪，成为一名合格的“厨师”。


### （三）人工智能概率性考量

* 采用的是物理的RFID芯片，原理是在餐具中植入芯片，通过射频信号写入设备，可以把一个物理编码，写入芯片。在菜品自主结算环节，射频读取器会发射一串信号，该芯片接收后会返回一串唯一的信号，被接收器接收，以此来辨别芯片的编码，通过芯片的编码从而在后台建立对应关系[文段出处](https://www.zhihu.com/question/50161059/answer/1400402641)

* 用的是计算机视觉技术，与无人驾驶与车牌识别等技术类似，是通过摄像头获取目标物体信息，通过RGB图像进行目标对比，基本的流程是：图像获取，目标定位，图像分割，图像识别。当前主流的识别技术根据细分技术原理的不同，可以分为静态单体图片的识别与动态视频流识别，该技术门槛较高，菜品数据集缺失，国内当前只有少数几家公司有相关产品。
[文段出处](https://www.zhihu.com/question/50161059/answer/1400402641)

![问题及解决方案说明](https://gitee.com/yiudaisin/api/raw/master/images/%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20210121111623.png)

***

## 二、问题描述与需求列表

### （一）用户洞察——用户痛点

* 爱吃人士在网上看到心仪菜式但是博主没有说明菜式，用户希望能用APP识别出菜式
* 个别健身人士对陌生菜式的热量不熟悉，菜品识别帮助健身人士了解菜式热量营养，均衡调整饮食
* 入门学习烹饪的人不懂菜式做法，给需要学习烹饪的技术人员了解更多菜式，学习菜式做饭。

### （二）用户问题表述

* 随着科学技术的发展，AI识别技术越来越完善，其中出现菜品识别，让“识别菜品”、“做菜教程”逐渐变得普遍，在通过使用百度菜品识别、京东菜品识别等的AI技术后，“识菜达人”App轻松地解决了以上诉求。

* 在市场上还没有相似的专门做食物搜索的软件，用户需要这样一款软件，想了解美食信息的时候，因为交流障碍的问题，而无法获知美食的名称，用户在了解到菜品信息后，想要知道如何制作但要打开其他app或是网页去查找，步骤


### (三) 需求列表
| 标题     | 用户使用场景                 | 重要程度 |
|--------|------------------------|------|
| 美食图片识别 | 用户想要知道自己拍的照片是否为一种食物    | 重要   |
| 菜品识别   | 拿出手机上传照片，希望返回想要知道的菜品信息 | 重要   |

## 解决方案原型表述
用户第一次打开识菜达人app，首先看到的是欢迎页，当点击即刻开启后，用户映入眼帘的拍照和相册两个按钮及一个搜索框，这意味着用户可以选择立刻拍照及从相册中选择照片到app中进行美食图片api识别。如此设计是为了解决用户在饭店识别菜品的即时性、用户手机内部有拍摄下来但想进行菜品识别的照片，可以选择页面中的相册进行菜品识别api比对并得到菜品信息。在拍照与相册的下方还设置了搜索历史的按钮，此举是为了用户过往使用搜搜进行美食搜索的记录。而页面最下方设置了用户的个人信息界面。简单便捷的操作帮助用户不再需要记住繁琐的流程去操作自己想得到的界面与信息。

## 用户对象 目标用户群：25岁-50岁的喜爱了解美食信息及喜爱钻研、开发菜品或热衷健身的人士

## 用户画像

![输入图片说明](https://gitee.com/yiudaisin/api/raw/master/images/%E7%B1%B3%E8%80%81%E6%9D%BF%E8%AF%86%E8%8F%9C.png)

## 三、解决方案：界面流程与关键智能交互
（一） 启动页介绍（交互页面设计）：

* 使用说明

![输入图片说明](https://gitee.com/yiudaisin/api/raw/master/images/%E5%A2%A8%E5%88%80/%E4%B8%BB%E9%A1%B5.png)

启动页介绍：此页为打开识菜达人APP时的启动页，页面内有“启动”的按钮，即进入首页

* 启动页跳转说明
![输入图片说明](https://gitee.com/yiudaisin/api/raw/master/images/%E5%A2%A8%E5%88%80/%E6%B3%A8%E5%86%8C%E9%A1%B5.png)
当用户第一次打开“识菜达人”app点击“注册”或登录，以上为注册页面

![输入图片说明](https://gitee.com/yiudaisin/api/raw/master/images/%E5%A2%A8%E5%88%80/%E6%B3%A8%E5%86%8C%E6%88%90%E5%8A%9F%E9%A1%B5.png)

注册成功

![输入图片说明](https://gitee.com/yiudaisin/api/raw/master/images/%E5%A2%A8%E5%88%80/%E8%BF%9B%E5%85%A5app.png)

登录成功后进入APP页面

![输入图片说明](https://gitee.com/yiudaisin/api/raw/master/images/%E5%A2%A8%E5%88%80/%E8%BF%9B%E5%85%A5app.png)

可选择扫描菜品或者分析菜品。

![输入图片说明](https://gitee.com/yiudaisin/api/raw/master/images/%E5%A2%A8%E5%88%80/QQ%E6%88%AA%E5%9B%BE20210121145242.png)
![输入图片说明](https://gitee.com/yiudaisin/api/raw/master/images/%E5%A2%A8%E5%88%80/%E6%89%AB%E6%8F%8F%E7%BB%93%E6%9E%9C.png)

如扫描油条分析油条，得到油条热量等信息

![输入图片说明](https://gitee.com/yiudaisin/api/raw/master/images/%E5%A2%A8%E5%88%80/%E6%89%AB%E6%8F%8F%E7%BB%93%E6%9E%9C.png)

可选择加入计划

![输入图片说明](https://gitee.com/yiudaisin/api/raw/master/images/%E5%A2%A8%E5%88%80/%E5%8A%A0%E5%85%A5%E8%AE%A1%E5%88%92.png)

加入计划页面有三个超链接，饮食分析为刚刚的热量分析，添加摄入重新扫描，我此次只拿油条牛排为对象。

![输入图片说明](https://gitee.com/yiudaisin/api/raw/master/images/%E5%A2%A8%E5%88%80/%E8%BA%AB%E4%BD%93%E6%A1%A3%E6%A1%88.png)

可以点击身体档案查看摄入热量

![输入图片说明](https://gitee.com/yiudaisin/api/raw/master/images/%E5%A2%A8%E5%88%80/%E6%89%AB%E6%8F%8F%E7%83%A4%E7%89%9B%E6%8E%92.png)

点击返回，扫描烤牛排

![输入图片说明](https://gitee.com/yiudaisin/api/raw/master/images/%E5%A2%A8%E5%88%80/%E5%88%86%E6%9E%90%E7%83%A4%E7%89%9B%E6%8E%92.png)

分析烤牛排


### （二） 可行性分析
* 用户可欲性：产品设计符合用户日常饮食需求，解决用户对于菜品信息的模糊认知。而拍照识别食物类型，对于用户来说简单易上手，便于操作，技术要求低。
* 技术可行性：市面上类似产品，同样适用菜品信息识别功能对菜品信息进行分析。有前者经验进行借鉴，减少技术开发上的困难。
* 商业可行性：市场上相似的产品较少，市场需求空缺较大，暂未出现行业领头产品。对手竞品的功能单一，综合性功能较少，本产品有竞争优势。


## （三）[原型产品链接](https://modao.cc/app/design/pbkk513enr41jp)

## 四、解决方案：数据流程及关键智能API使用 

### （一）流程图

#### 1、用户界面流程图
![界面流程图](https://gitee.com/yiudaisin/api/raw/master/images/%E6%B5%81%E7%A8%8B%E5%9B%BE.png)

2、数据流程图
![数据流程图](https://gitee.com/yiudaisin/api/raw/master/images/%E6%95%B0%E6%8D%AE%E6%B5%81%E7%A8%8B%E5%9B%BE.png)

### (二)智能API使用水平


* 1、API代码测试
检测是否为美食
![](https://gitee.com/yiudaisin/api/raw/master/images/%E7%89%9B%E8%82%89%E9%9D%A21.png)
![](https://gitee.com/yiudaisin/api/raw/master/images/%E7%83%A7%E9%B9%85.png)
![](https://gitee.com/yiudaisin/api/raw/master/images/daima.png)

* 2、百度AI菜品识别文档技术要求
**百度菜品识别** 
1. 接口描述：该请求用于菜品识别。即对于输入的一张图片（可正常解码，且长宽比适宜），输出图片的菜品名称、卡路里信息、置信度。
2. 请求说明：
* 请求示例：HTTP 方法：POST
请求URL： https://aip.baidubce.com/rest/2.0/image-classify/v2/dish
URL参数：

| 参数         | 值                                                                         |
|--------------|---------------------------------------------------------------------------|
| access_token | 通过API Key和Secret Key获取的access_token,参考“[Access Token获取](https://ai.baidu.com/ai-doc/REFERENCE/Ck3dwjhhu)” |
* Header如下：

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

3. API使用后风险报告
* 限制：图片大小不超过4M
* 最短边至少15px，最长边最大4096px
* 图片需要base64编码、去掉编码头后再进行urlencode*

 **总结** ：百度的菜品识别API还在不断迭代，目前的识别误差偏大，很难识别出流质的食物，如咖喱，汤等，以及特征较为模糊的食物。并且菜品库中的数据较少，一些比较少见的菜无法进行识别，仍需不断扩充数据库。价格在目前的市场中因为无同类相似竞品，无法进行比较，也一定程度上的垄断了这一美食识别搜索的细分领域。
* 使用价格
每日500次免费调用额度，免费额度用尽后开始计费，价格如下：

| 月调用量（万次）     | 菜品识别（元/千次） |
|--------------|------------|
| 0<月调用量<=5    | 0.70       |
| 5<月调用量<=10   | 0.60       |
| 10<月调用量<=20  | 0.50       |
| 20<月调用量<=50  | 0.40       |
| 50<月调用量<=100 | 0.35       |
| 100<月调用量     | 0.3        |


> 说明： 调用失败不计费




## 3、API平台对比
1.  [**百度开放平台菜品识别**](https://ai.baidu.com/tech/imagerecognition/dish) ：百度开放平台菜品识别API识别超过9千种菜品，适用于识别只含有单个菜品的图片，接口返回菜品的名称、置信度、卡路里、百科信息等综合信息，还支持自建菜品图库，适用于识别含有多个菜品的图片，接口返回菜品的名称、位置、相关性等综合信息。其中有免费版和付费版，可以用于个人开发和企业商用。免费的调用量为500次/天，但是并发数不保证；付费版调用数无限制，并发数为10qps，大约0.3元可以调用一千次，调用量越多，收费越便宜，这对于不同开发者来说可以各取所需，比较方便。
2.  [**阿里云菜品识别**](https://market.aliyun.com/products/57124001/cmapi032952.html?spm=5176.10695662.1996646101.searchclickresult.5e6d7275Su2P78&aly_as=gTQ_BwDw#sku=yuncode2695200002) ：阿里云的菜品识别API使用人工智能算法，自动根据图像识别菜品，可识别数千种菜品。但其返回参数仅有卡路里和名字，返回信息与百度相比较少，以及仅支持50次免费试用，10元可以调用1000次，价格和百度对比相对较贵，所以这对于一些个人/学生开发者来说并不十分友好。
3.  [**京东云菜品识别**](https://www.jdcloud.com/cn/products/food-recognition) ：京东智联云菜品识别API基于京东丰富的海量数据，领先的细粒度分类算法，准确性高有保障且支持的菜品数量大，种类多样。但京东智联云调用量限制为5000/日，对于一些即将进行市场投放的应用来说并不友好，不能满足其用户需求。

##### （1）智能加值

* 百度AI有关图像技术方面的开放api更加丰富，可供选择较多:
 
* [红酒识别](https://ai.baidu.com/tech/imagerecognition/redwine)
* [货币识别](https://ai.baidu.com/tech/imagerecognition/currency)
* [地标识别](https://ai.baidu.com/tech/imagerecognition/landmark)
* [动物识别](https://ai.baidu.com/tech/imagerecognition/animal)

* 京东AI在图像技术方面开放API较少，缺少对图像AI的大类区分，热门、有趣、更具有市场前景的API接口较少：

* [通用图片搜索](http://neuhub.jd.com/ai/api/image/index)
* [车辆识别](http://neuhub.jd.com/ai/api/ocr/ocr-for-vehicle-license-plate)
* [垃圾分类](http://neuhub.jd.com/ai/api/image/garbageClassify)
* [犬类识别](http://neuhub.jd.com/ai/api/image/Dog_Classification)
***
## 学习/实践心得总结及感谢

* 在本次项目实践中，我学习了如何系统性的制作一份架构完善的产品需求文档。文档撰写参考了18级师兄的作品、19级同学的耐心指导，从中学习作品结构以及文档结构，在此表示由衷的感谢。
* 本次项目中实现了百度API、京东AI的调用，同时学习到作为产品经理以顾客为中心的产品开发思路。
* 首先最重要的是寻找不同的api之间的关联，然后通过之间的共通点去找寻自己想要开发产品的特点，根据特点满足用户需求，用户至上始终是产品的第一要点。
* 在项目的设计中，我也学习到一个好的产品不仅仅只是需要完善的功能，以用户为中心的界面设计以及配色风格同样对产品产生很大影响。

#### 感谢：

在此非常感谢提供项目参考的同学，以下为参考的作品url：
* [张渚同学](https://gitee.com/zhang_zhu/api-final-project/tree/master)

同时非常感谢百度ai提供的免费资源调用，以及提供的技术支持与技术文档：
* [Access Token获取](https://ai.baidu.com/ai-doc/REFERENCE/Ck3dwjhhu)
* [菜品识别](https://ai.baidu.com/tech/imagerecognition/dish)
* [ProcessOn](https://www.processon.com/diagrams)

此外，对“墨刀”在线产品原型设计与协作平台表示感谢，为项目产品原型制作提供技术性支持：
* [“墨刀”在线产品原型设计与协作平台](https://modao.cc/)



***