# api产品原型
**Repository Path**: l_j_p/api_product_prototype
## Basic Information
- **Project Name**: api产品原型
- **Description**: 记录我的api产品原型——我好菜。让每一个热爱种植的小园丁，甚至是植物园的小白，都可以在这里找到最佳的种植方法、方式。在得到成果后可分享至社交圈，像亲朋好远展示自己的才华（兴趣）
- **Primary Language**: 其他
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 2
- **Created**: 2022-02-10
- **Last Updated**: 2022-02-10
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
|文档名称|我好菜—产品需求文档|
|--|--|
|产品名称|我好菜|
|产品描述|一款利用植物识别、定位、天气查询推荐，来帮助热爱种植或者想种植的小白轻松容易获得最简单、最有效的种植方式，并且分享到交友圈中。|
|产品版本|2.0|
|文件现状|进行中|
|文件作者|黄韵如|
#### 迭代增量：添加日期管理，提醒用户行为；添加用户选择项，解决用户不知道种植什么的困难。
#### [我的diff](https://gitee.com/SOMNUSLOCK/api_product_prototype/compare/924d2296622bfb8c46e74e3597f0e1f2e1142405...4cb1c31a92f6e58f873234dc33d6ee18e8b349be)
## 加值宣言
目前中国市场上对于种植某类植物的高效方式推荐管理的产品并没有得到完善，“我好菜”app正是对应当下的漏洞，结合目前技术比较完善的植物识别app与各类分享推荐平台进行整合价值和优化。该app将会使用植物识别api、天气查询api、城市定位api，这些技术的运用会更好地解决人们想要种植时遇到的困难。
## 一、需求概述
### 1. 产品背景
在中国，无论农村还是城市，勤劳的中国人都在努力种菜。有条件，自然要种；没条件，创造条件也要种。院子里当然不用说。没有院子的，阳台上也可以，院子和阳台都没有的，就充分利用身边的简易材料，分分钟就能种上菜。中国人的种植情结，对土地和自然热爱的突出意象，便是这样一种深烙在骨子里的集体无意识，甚至影响着中国人的处世哲学。**但是由于地理环境的不同，导致同一种植物在不同的地区的生长方式不一样，而大多数人没有相关的专业知识，最终种植的结果不如人意。**
### 2. 产品市场
经过对市场上植物识别APP技术是什么完善的，但对于在不同地区种植的植物的最优方式推荐以及监管类app却未形成.
### 3. 市场概述
##### 3.1中国植物识别类应用市场
早在2016年，由中国科学院植物研究所与百度等单位合作开发的"智能花卉识别系统"，让"拍花识植物"成为现实。2018年9月，在全国科普日活动期间，百度与多家国内知名植物园达成合作，共同推出"AI植物园计划"。作为"AI植物园计划"中面向用户的产品，"百度探花郎"将接入百度搜索的全平台入口。"百度探花郎"主要包含拍照识花、全景科普以及智能导览三大功能。借助百度识图提供的领先AI图像识别能力，"拍照识花"功能对于常见植物的识别率可以达到92%。
从目前来看，中国的智能识别植物的服务已经能满足人们的日常需求，甚至在识别农作物害虫上也逐渐完善。但是植物识别服务的平台/软件忽略了大众另一个更深层次的追求。
##### 3.2 市场特征
- 植物识别市场广阔，增长迅速,目前正在处于迅速发展的时期。
- 植物识别市场处于发展初期，目前直接针对植物种植最优方式的工具甚少，发展空间广阔。还未出现行业龙头。
- 对产品技术要求较高，需要契合场景要求，如同样是蔷薇在北纬22.3°与北纬45°种植方式的区别。
##### 3.3. 发展优势
- 目前植物种植智能推荐市场广阔，竞争对手很少，竞争力小；
- 对植物种植智能推荐有需求的市场广阔，痛点明显，具有一定的开发价值；
- 可以真正为各种植爱好者、种植小白解决困难，将会受到欢迎。
## 二、核心价值（最小可行性产品）
着眼于解决种植小白在遇到喜欢的植物/菜的时候欲要尝试种植时遇到各种困难和问题，以及提高种植爱好者种植效益。
##### 用户痛点
1. 在看到挺喜欢的植物时不知道该植物是什么；
2. 参考网络参差不齐的方法种植后，没有理想的成果；
3. 在植物不同阶段，不懂得该如何照料植物；
4.不知道种植什么
5.种植出美妙的结果想要宣告天下（炫耀）
## 三、用户分析
1. 目标用户群：
- 核心用户：18~30岁的具备生活小乐趣、热爱自然的种植小白
- 主要用户：24~60岁之间的热爱田园生活的种植园丁（经验丰富）
2. 用户画像及使用场景
[图片来源](https://ss0.bdstatic.com/70cFuHSh_Q1YnxGkpoWK1HF6hhy/it/u=1040069910,3336872438&fm=26&gp=0.jpg)|
姓名：熊小七
年龄：18岁职业：学生
---|---
人物简介| 刚刚高考结束，准备进入丰富多彩的大学生涯。生活富有情趣，喜欢在家养小动物，家里有一只布偶，一只巴西龟，八只水母，喜欢在自家的阳台上种花。
用户行为 | 最近看到邻居家的花圃种满了好看的花，于是在网上购买了多彩（很多种颜色）的玫瑰种子种在了阳台的花围上，根据卖家说的种植方法精心照料。
痛点| 可惜苦苦等待18天后，玫瑰种子还没发芽。并且后来与买家沟通才知道邻居家的花是蔷薇而非玫瑰；熊小七根本不知道该如何进行下去。
[图片来源](https://ss3.bdstatic.com/70cFv8Sh_Q1YnxGkpoWK1HF6hhy/it/u=2083549581,2519042962&fm=26&gp=0.jpg) |
姓名：达二爬
年龄：40岁职业：某生活杂志周刊主编
---|---
人物简介| 与妻子和小孩居住在城郊，空气清新，环境优美。平时喜欢到户外寻找灵感，在自家的阳台培育了不少的植物。最近喜欢和孩子一起种菜，培养孩子的动手能力以及培养与孩子的关系。
用户行为 | 在楼下菜市场买了一包胡萝卜种子，按照说明书种下，放于阳台阴暗处。
痛点| 种植蔬果不在自己的经验范畴内，种子虽然发芽了，可是种子一直保持在发芽的状态，没有肉眼可见的生长。
## 四、核心价值与用户痛点
|核心价值|用户痛点|API价值|
|:--:|:--:|:--:|
|随时随地精确的植物识别|不认识看到的植物|百度开放平台中的植物识别api|
|提供高效的种植方式|种植的结果不如人意|高德开放平台定位以及天气查询API|
|提供日期管理，提醒用户行为|不清楚植物不同阶段的种植方式|高德开放平台天气查询API|
|提供平台供用户分享、互相学习|种植出美妙的结果想要宣告天下（炫耀）|/|
## 五、人工智能概率性与用户痛点
> 随着人工智能的不断发展，麦肯锡全球研究所在2018年发布的一份报告中，估计人工智能可以在全球经济中创造3.5万亿至5.8万亿美元的年价值，约占所有分析技术总影响力的40％ 。另外，人工智能在与内容相关的领域（例如翻译服务和转录服务）也取得了长足进步。
——哈佛商业评论
百度植物识别支持识别超过2万种通用植物和近8千种花卉，接口返回植物的名称，并获取百科信息，适用于拍照识图类APP中。实践可得出百度植物识别API的识别精准度达到80%，但是其对图片有一定的要求。图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式。另外如果用户上传的图片中包含多种植物，则会识别失败。
百度植物识别API识别精确度再提高：需要具备更为庞大的植物库，不断强化机器学习，提高精确度。另外，可开启一个反馈栏，使得用户可对其进行建议性输入，从而强化其数据库。
用户上传图片格式问题：可进行后台自动优化处理图片进行分析，倘若用户上传过于复杂/过于模糊的图片则再返回给用户，提醒用户重新上传。
## 六、需求列表（对应人工智能加值）
|序号|api技术|用户场景|优先级|
|--|--|--|--|
|1|百度开放平台中的植物识别api|快速知道植物的信息|A（重要）|
|2|高德地图开放平台的定位|想要知道高效种植的方法|A（重要）|
|3|高德地图开放平台中的天气查询|对植物更好的管理|B（次重要）|
## 六、产品结构图
1. 产品功能结构图
2. 用户流程图
3. 产品结构图
4.数据流程图
## 七、数据推理
||页面|
|--|--|
|问题1|我们在页面上呈现什么内容|
|回答1|植物识别结果；种植最优方式结果；天气日期管理|
|问题2|向用户输出的结果内容从哪里来|
|回答2|去开放平台调用api，获得结果内容|
|问题3|请求从哪里来|
|回答3|用户对照片的上传，以及用户搜索或选择|
|问题4|如果页面出现识别错误，应该如何获取并处理数据，正确数据的信息从哪里来|
|回答4|通过用户的反馈进行信息获取，通过用户的自愿反馈扩大数据库，强化机器学习|
## 八、产品原型及交互设计
[产品原型URL](https://modao.cc/app/5da660b2bf0a6085f095c8259432c5a78fccdc43?simulator_type=device&sticky)
1. 启动及登录界面
2. 核心页面——植物识别/搜索页面
用户通过植物扫描界面，可利用相机或相册对植物进行扫描，从而该App将会对用户的植物图片进行扫描，并返回其相应的植物百科信息给用户，另外还将给用户提供进入百度进行进一步把了解的链接。（利用百度开放平台的植物识别API，解决用户“不清楚看到的植物是什么”的痛点）
3. 主要页面——种植方式推荐及管理
当用户选择种植时，跳转至选择城市/定位功能，智能推荐种植方式（后台自动天气查询），还会规划日期管理。（利用有高德地图开放平台的定位API，与天气查询api解决“不知道该如何有效种植”的痛点）
4.次要页面——分享交流
解决用户种植出美妙的结果想要宣告天下（炫耀）、相互学习的痛点。
5.次要页面——我的设置
解决个人基础设置问题，包括个人信息的更改、收藏夹内收藏的植物、设置相关信息。
### 九、API的运用
###### （一）图像识别
1. 百度AI开放平台——植物识别（本产品使用的api平台）
- 接口描述：该请求用于植物识别。即对于输入的一张图片（可正常解码，且长宽比适宜），输出图片的植物名称、置信度。
- 接口地址 ：https://aip.baidubce.com/rest/2.0/image-classify/v2/dish
- 请求方法：POST
**（1）首先需要通过API Key和Secret Key获取access_token**
**[输入与输出的源代码链接](https://gitee.com/SOMNUSLOCK/api_product_prototype/blob/master/%E4%BB%A3%E7%A0%81/api%E6%8E%A5%E5%8F%A3%E4%BB%A3%E7%A0%81.ipynb)**
**（2 ）接着对菜品进行识别**
**[输入与输出的源代码链接](https://gitee.com/SOMNUSLOCK/api_product_prototype/blob/master/%E4%BB%A3%E7%A0%81/api%E6%8E%A5%E5%8F%A3%E4%BB%A3%E7%A0%81.ipynb)**
- 案例1：
- 输入：单一植物，将返回三个置信度最高的结果
- 案例2：
- 输入：多种植物，将返回三个置信度最高的结果。
- 案例3：
- 输入：非植物，将返回“非植物”结果。
2. 阿里云API开放平台——植物识别
- 案例1：
- 输入：输入多种植物，虽输出三种置信度，但不准确
###### **百度与腾讯API的对比**
1. **[百度植物识别API](https://ai.baidu.com/tech/imagerecognition/plant)**：对单一植物的图片识别精准度达80，支持一图多种植物识别，能正确返回非植物图片为“非植物”
2. **[阿里云植物识别API](https://market.aliyun.com/products/57124001/cmapi031359.html?spm=5176.10695662.1996646101.searchclickresult.4e9543d5x2krOS#sku=yuncode2535900001)**：不能进行多种植物的图进行识别，能正确返回非植物图片为“非植物”
- **总结分析**：通过对百度与阿里云API的调用，对其提供的功能有了大致的了解。我个人认为虽然阿里云的单一植物识别高达88%，但相较于百度植物识别的可以一图多植物识别相对较弱。用户在选择图片或者拍照的时候，并不能保证没有其它植物的参入。而“非植物”功能，对本产品可有可无。因此我会选择百度植物识别API。
**（二）高德地图定位**
高德地图开放平台
- 接口描述：IP定位是一个简单的HTTP接口，根据用户输入的IP地址，能够快速的帮用户定位IP的所在位置。
- 接口地址：https://restapi.amap.com/v3/ip?parameters
- 请求方法：POST
**[输入与输出的源代码链接](https://gitee.com/SOMNUSLOCK/api_product_prototype/blob/master/%E4%BB%A3%E7%A0%81/%E9%AB%98%E5%BE%B7api.ipynb)**
**（三）天气查询**
1. 高德地图开放平台
- 接口描述：天气查询是一个简单的HTTP接口，根据用户输入的adcode，查询目标区域当前/未来的天气情况。
- 接口地址:https://restapi.amap.com/v3/weather/weatherInfo?parameters
- 请求方法：POST
**[输入与输出源代码链接](https://gitee.com/SOMNUSLOCK/api_product_prototype/blob/master/%E4%BB%A3%E7%A0%81/%E9%AB%98%E5%BE%B7api.ipynb)**
### 十、API的使用价格
- [百度的植物识别价格](https://ai.baidu.com/ai-doc/IMAGERECOGNITION/rk3bcxa9e)：
每日500次免费调用额度，免费额度用尽后开始计费，价格如下：
- 高德地图开放平台API调用为免费
### 十一、API使用风险评估（厉害相关者分析）
> AI随着计算机的计算能力的增强，已经有了重大进展（Buchanan，AI Magazine，2005）。AI和神经网络可以在更短的时间内完成比人类更多的工作。他们也不需要休假，也不会生病。一旦编程，它们的错误率就很小，并且如果有错误，通常是在编程中，这是人为错误。
——[Excelsior College](https://www.excelsior.edu/article/rogue-robots-human-flaws-ai-cybersecurity/)
- 错误现象及处理办法：
百度植物识别支持识别超过2万种通用植物和近8千种花卉，接口返回植物的名称，并获取百科信息，适用于拍照识图类APP中。实践可得出百度植物识别API的识别精准度达到80%，但是其对图片有一定的要求。图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式。另外如果用户上传的图片中包含多种植物，则会识别失败。
1. 百度植物识别API识别精确度再提高：需要具备更为庞大的植物库，不断强化机器学习，提高精确度。另外，可开启一个反馈栏，使得用户可对其进行建议性输入，从而强化其数据库。
2. 用户上传图片格式问题：可进行后台自动优化处理图片进行分析，倘若用户上传过于复杂/过于模糊的图片则再返回给用户，提醒用户重新上传。
- ESG考量
选择api公司时，不仅仅需要考量其技术含量，还有一个很重要的指标————ESG评分。ESG投资可帮助一个企业、一个产品走向更长远的目标。因此本产品设计时：**（1）及时关闭不需要的服务器，软件设计足够轻便，合适清理后台缓存，减少碳排放（E）；（2）保护用户隐私与数据问题（S）;(3)与ESG评级较好的公司深度合作，公司内部职权公开（G）**
[ESG评级网站](https://www.msci.com/)
百度ESG评分：
阿里巴巴集团ESG评分（高德地图属阿里巴巴旗下）：
---
### 十三、该产品未来的发展路线构想
发展理念：由基础功能延伸到附属功能，首先满足基本的植物识别的功能，紧紧抓住用户种植场景，提供最优种植方案，提供种植管理服务，最终实现完整的种植体验类产品。
##### (一）产品的更新迭代过程
- **V1.0**
1. 实现植物识别功能，满足基本的识别需求；
2. 实现定位于天气查询功能，满足用户的种植方式需要；
3. 实现分享功能，满足用户分享快乐的需求。
- **V2.0**
1. 提供可选择植物类别，解决用户不知道种植什么的需求；
2. 完善基础的菜单补充反馈、收藏、等功能。
##### (二）产品的盈利模式
智能识别功能收费；会员制度收费；后期通过与商家合作以及用户可在平台出售成果，收取提成
##### (三）产品的业务模式
前期需要录入一些植物的信息，在获得一定用户数量之后，可以利用用户分享和评论生产更多内容；与电商平台合作共同完成种植的小目标。
### 所使用的AI功能链接
- [百度AI-图像识别-植物识别](https://ai.baidu.com/tech/imagerecognition/plant)
- [高德地图AI-IP定位](https://lbs.amap.com/api/webservice/guide/api/ipconfig)
- [高德地图AI-天气查询](https://lbs.amap.com/api/webservice/guide/api/weatherinfo)
---
##### 一句话版本
一款利用植物识别、定位、天气查询推荐，来帮助热爱种植或者想种植的小白轻松容易获得最简单、最有效的种植方式，并且分享到交友圈中。
##### 1分钟版本
目前中国市场上对于种植某类植物的高效方式推荐管理的产品并没有得到完善，“我好菜”app正是对应当下的漏洞，结合目前技术比较完善的植物识别app与各类分享推荐平台进行整合价值和优化。该app将会使用植物识别api、天气查询api、城市定位api，这些技术的运用会更好地解决人们想要种植时遇到的困难。
## 学习/实践心得总结及感谢
**心得提炼**： 经过该项目的实践锻炼中，我深刻的认识到当今API人工智能和机器学习已经完全融入到我们的现实生活中。许多平台也公开分享他们的API成果，因此同行们应该学会利用这些免费的资源去研发更多具有实用价值和创新性的产品。同时API的运用也催生了API 经济，利用互联网的Web API技术，将企业能力或竞争力作为API服务而进行商业交换的经济模式。因此，除了现在火热的共享经济外，API经济也是发展的一个重大势头。互联网技术与经济模式结合产生了“API经济”，这可以成为传统制造业走向互联网+的“连接器”。
**尊重引用**： 我主要采用了高德开放平台和百度AI平台的API技术文档，并通过他们提供的代码成功运行出来结果，非常感谢这两个平台在为我的项目后台数据和技术支持提供的帮助。同时也非常感谢前期小组成员共同协作锻炼出了撰写API产品PRD文档的能力。