# API-final-project

**Repository Path**: jokey-li/api-final-project

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-01-24
- **Last Updated**: 2021-01-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# API期末作业

[录屏链接https://www.bilibili.com/video/BV1k54y1s7uK](https://www.bilibili.com/video/BV1k54y1s7uK)

## MVP加/价值主张宣言
文档名称 | 绿意 — 产品需求文档
---|---
产品名称| 绿意
产品描述| 一款能帮助用户快速进行垃圾分类的APP
产品版本| 1.0
文件作者| 李嘉浩
* 加值宣言：在国家愈发重视垃圾分类的今天，很多人却对垃圾的分类界定模糊，这款app可以帮助用户快速识别垃圾类别，并提供相应的投放建议，同时也降低政策实施给用户带来新增成本。

### 项目标题
- 绿意 ：垃圾分类，举手之劳。

### 项目简介
#### 1.问题情境
- 自从上海实施垃圾分类以来，国家也越来越重视垃圾分类，垃圾分类这个话题也引起了大家的广泛关注，垃圾分类也势在必行。因为保护环境要从我做起，所以也有越来越多的人参与到这个活动中，认识到保护环境的意义和垃圾分类的作用。但是，现在很多居民对于垃圾分类的知识并不熟悉，在垃圾的分类上存在“不清楚、不了解”等问题。

#### 2.解决方案
- 使用垃圾分类api，让居民能随时随地查询垃圾所属分类。
- 在app中添加垃圾分类知识，让居民更加了解这方面的知识。

#### 3.产品描述
- 帮助用户快速识别垃圾类别，并提供相应的投放建议。

### 问题需求
###  使用情境与用户画像
![用户画像](img/yhhx.png)
### 需求列表与利害相关者分析

#### 需求列表
| 优先级 | 需求 | 智能加值 | API类型 |  级别 | 
|  ----  | ----  |  ----  | ----  |  ----  | 
|  1  | 用户对各种垃圾进行分类投放  | 是 | 聚合数据垃圾分类API  |重要|
|  2  | 向用户传输垃圾分类知识  | 是 | 聚合数据垃圾分类API  |重要|

#### 利害相关者分析
#### 利害相关者分析表
| 利益相关者 | 行为 |  关注点 |  获得利益 | 
|  ----  | ----  |  ----  | ----  | 
|产品经理| 进行用户调研，收集用户需求，分析用户痛点，选择API平台，撰写PRD文档  | 用户反馈，产品后期优化，API平台技术的更新及费用|高|
|  api提供商 | 提供api技术支持、提供数据、获取数据  |  能否获取更有价值的数据 |高|
|  用户 | 对垃圾的分类更加准确  |  是否能有效解决当前垃圾分类问题 |高|
|  政府 | 颁布垃圾分类法令  |  人民对于垃圾分类的积极性以及环境的改善 |高|

- [项目利益相关者分析及冲突管理——以城市生活垃圾治理项目为例](https://wenku.baidu.com/view/315bb91b227916888486d780.html)

### 解决方案原型表述
#### 界面流程及关键智能交互
* 界面原型--[绿意](https://modao.cc/app/c27f2782f59adbe11fdcffdeed164b855ff99932#screen=skk9cpzhm5ce44b)
* 界面流程图、智能交互及加值
![界面流程图](img/用户使用界面.png)   
![界面使用流程图](img/界面浏览流程图.png)
* 界面设计的三个可行性
  * 商业可行性
    * 随着国家越来越重视垃圾分类，此类app也会有很好的商业前景
  * 技术可行性
    * 基于图像识别、文字识别技术、自然文字识别技术，为了解决用户对垃圾分类的基本需求，通过获取用户输入图片和用户输入的信息基于图像识别API、文字识别API及垃圾分类查找等，让用户了解清楚垃圾的种类及处理方法，保障垃圾分类政策的顺利进行。
  * 用户可欲性
    * 节约了用户大量垃圾分类时间，用户能更好地执行垃圾分类义务，也降低了政策实施给用户带来新增成本。

#### 数据流程及智能API使用
* 数据流程图
![数据流程图](img/数据流程图.png)
* 智能API使用流程图
![智能API使用流程图](img/智能API使用流程.png)
* 数据流程的三个可行性
  * 商业可行性
    * 通过收集用户搜索过的垃圾的信息，改善app和及时更新app内容，以吸引更多用户，确保app的长期运营。
  * 技术可行性
    * 在用户利用该平台进行垃圾分类时，用到的智能API是聚合数据平台的人脸试妆API和聚合数据平台的垃圾分类内容API。   
    * 自身的Python代码基础进行API调用
  * 用户可欲性
    * 在垃圾分类的使用中不断掌握更多新的垃圾分类知识。
* 代码成果展示--代码链接：[绿意](http://localhost:8888/notebooks/%E7%BB%BF%E6%84%8F_api%E6%9C%9F%E6%9C%AB%E9%A1%B9%E7%9B%AE.ipynb)
  
![成果1](img/成果1.png)
    * 返回结果--
    * ![结果1](img/结果1.png)
![成果2](img/成果2.png)
    * 返回结果--
    * ![结果2](img/结果2.png)
![成果3](img/成果3.png)
    * 返回结果--
    * ![结果3](img/结果3.png)
![成果4](img/成果4.png)
    * 返回结果--
    * ![结果4](img/结果4.png)


* 人工智能概率性考量
  * 平台的对比分析
    * 针对垃圾分类功能，我找到三个平台，分别是京东、阿里云、天行数据。

| 平台 | 功能 | 分析 |
|  ----  | ----  | ----  |
|  京东  | [基本垃圾分类](https://aidoc.jd.com/image/garbageClassification.html)  |该API功能里，提供通过文本或图片或语音进行垃圾分类查询的能力。用户可选择通过传入单个垃圾名称进行文本形式的查询，也可通过传入图片进行图片形式的查询，也可以传入语音进行语音形式的查询。 |
|  阿里云  | [关键字/图像垃圾分类](https://market.aliyun.com/products/57126001/cmapi00035673.html?spm=5176.2020520132.101.8.478b7218v952PF#sku=yuncode2967300001)  |该API功能，可进行（垃圾分类/可回收垃圾分类识别/垃圾分类回收/智能垃圾分类回收识别 【按关键字识别】）而且享有5000次的免费调用额度。|
|  天行数据  | [热搜垃圾分类](https://www.tianapi.com/apiview/107#apiprice)  | 该接口返回垃圾分类接口每天的前100个热门搜索词，该数据实时更新。其中type表示垃圾分类类型，0为可回收、1为有害、2为厨余(湿)、3为其他(干)。index为搜索指数，数字越大表示热度越高，排序也越靠前。该搜索热度数据来自天行数据文字版垃圾分类接口。测试资源和示例项目代码垃圾分类多功能演示代码和素材包 |


- **比较分析结果：**
根据使用感、文档完整度、调用价格这几方面来看，“垃圾分类”这一个APP暂时会使用聚合数据垃圾分类识别api作为APP内垃圾分类识别功能的接口，原因如下：
  - 由于聚合平台整合了其它平台的交易数据，所以它的交易深度更强，相对于别的数据接口来说，其后台所拥有的数据更丰富、更全面；
  - 支持多模态搜索，使用时有更多选择；
  - 给出的产品文档基本完整，上手速度较快。
 
### 心得总结及感谢
- 从我本次的项目，我觉得设计一项产品是需要从全方位的考虑的，从背景到竞品、从价值主张到原型，每一个环节都对最终产出具有很大的作用。  
  此外我学到了如何去撰写一份PRD，虽然可能并不专业。学到了如何使用xaure去制作一个交互的原型，学到了从多角度去看待一个产品。  
- 感谢感谢[聚合数据平台](https://www.juhe.cn/)、是他们的支持让我对API有了更深刻的理解，并将其API（我用到的API有：图像垃圾分类识别api、根据垃圾名称检索分类信息api、语音识别api）运用到我的产品中，更加完整了我的产品，为其提供了技术帮助。感谢[processon网站](https://www.processon.com/)，使我完成了流程图的制作。也感谢[阿里云API](https://market.aliyun.com/products/57126001/cmapi00035673.html?spm=5176.2020520132.101.8.478b7218v952PF#sku=yuncode2967300001)、[京东api](https://aidoc.jd.com/image/garbageClassification.html)、[人人都是产品经理](http://www.woshipm.com/rp/2461242.html)。给我提供了很多的经验和知识，非常感谢！！