旅游景点信息查询类APP__轻途: 一款专门为旅游爱好者打造的旅游景点信息查询类APP，利用“全国景点查询”API技术，帮助用户深入了解景点的相关信息，让用户拥有轻松旅途。

>  **写在前面：如果发现有图片看不了的，可以登录一下gitee账号，如果还是加载有问题，请联系我，谢谢！**

### 项目名称：“轻途”APP

| 文档名称：  | “轻途”APP——产品需求文档  |
|---|---|
| 产品名称：  | 轻途  |
| 产品简介：  | 一款专门为旅游爱好者打造的旅游景点信息查询类APP，利用“全国景点查询”和“输入提示”API技术，帮助用户深入了解景点的相关信息，让用户拥有轻松旅途。  |
| 产品版本：  | 1.0  |
| 文件拥有者：  | 黄晓颖 |

# 一、MVP加/价值主张宣言
********************
## 1. 加值宣言

随着经济的不断发展，越来越多人选择旅游作为休闲放松的方式。但许多人对旅游地点并不熟悉，只能通过小红书等网络社交平台了解当地的景点，进行游玩打卡。造成了一些热门景区人看人的现状，用户不能游得尽兴玩得舒心。本产品利用万维易源的 **“全国景点查询”API** 以及高德开放平台的 **“输入提示”API** 进行整合并加值优化，帮助用户更了解各个景点的相关信息，制定好旅游攻略，有序安排旅游日程，让用户拥有轻松旅途。

## 2. 核心价值

#### 任务点/痛点（问题）：
用户不了解旅游地的各个景区，只能通过小红书等网络社交平台的内容分享制定旅行攻略，进行游玩打卡。造成了一些热门景区人看人的现状，用户不能游得尽兴玩得舒心。

#### 最小可行性产品（解决方案）：
利用全国景点查询和输入提示的功能，为用户提供景点相关信息查询平台，在做旅游攻略时通过查询景点的开放时间、门票价格、景区游乐项目等，以此来了解景点，通过查询对比各个景区，从而安排好旅游日程，帮助用户有的放矢地轻松旅游。

## 3.人工智能概率性
> 随着人工智能（Artificial Intelligence, AI）的普及，人机互动方式也发生着改变，人们对产品的期望也越来越高。但是，AI系统具有情境感知能力，可以提供个性化服务，能通过机器学习不断升级，还会有出错的风险。人工智能算法是基于概率的、有缺陷的，所以是会犯错误的。

在API测试中，全国景点查询API在查询景点时会有概率抓取到其他一些带有关键字的结果，为了能让用户更精准地查询到目标景点，本产品同时采用了输入提示API，最大程度的减少人工智能出错的概率。

# 二、问题需求
*********************
## A.使用情境
- 旅游爱好者：珍妮想要国庆带着孩子和老人一起出门旅游，她想找到一个既有儿童游乐项目，也适合老年人安静养生散步的景点。，于是她打开了“轻途”APP，通过查询，得到了景区的相关信息，经过查询对比和借鉴了其他人的评价后，最终找到了一个合适的景区。  
- 小众景区：马克是小众景区的负责人，他想要提高景区的客流量。于是打开了“轻途”APP，通过平台景点热榜，了解了最热门的景区类型，掌握了用户的需求，对比了不同景区的项目和基础设施的评价，为景区完善基础设施提供参考的方向，同时他积极完善平台上关于本景区的信息，从而达到吸引游客的目的。

## B.用户分析
1. 目标用户群：各年龄层的旅游爱好人士，小众景区  
2. 用户画像及使用场景

![用户A](images/画像1.png)

![用户B](images/画像2.png)

## C.需求列表（对应人工智能加值）

| 优先级  | 智能加值  | 用户场景(具体如何加值)  | API类型  |
|---|---|---|---|
| 很重要  | 是  | 查询景区，得出景区的详细信息，了解景区的注意事项。  | 万维易源平台中的“全国景点查询”API  |
| 重要  |  是 | 根据用户输入的关键词，显示出含有关键词的各个景区供用户选择，更加精准地帮助用户查询到目标景点。| 高德开放平台中的“输入提示”API  |
| 重要  | 否  | 景区游玩的交流社区，简单了解景区，评价景区项目及基础设施的质量，分享旅游日记、记录每一次旅行的美好瞬间，结识同样热爱旅游的好友。  | /  |

## D.核心价值与用户痛点
- 功能优先级说明

| 序号 | 用户痛点 | API加值 |
|---|---|---|
| 1 | 基于用户不了解景区的痛点，用户只需要简单输入查询，直接反馈详细的景点信息，包括景点的开放时间、门票价格、景区游乐项目、景区描述等。可查询全国各个景区。|  万维易源平台中的“全国景点查询”API |
| 2 | 基于用户查询结果不精确的痛点，根据用户输入的关键词，显示出含有关键词的各个景区供用户选择，更加精准地帮助用户查询到目标景点。| 高德开放平台中的“输入提示”API |

## F.利害相关者分析
### 人工智能系统性偏差
- 该APP满足不同需求的用户，让用户得到各自的需求满足。但是依然会存在人工智能的系统性偏差问题。  
- 全国景点查询API在查询景点时会有概率抓取到其他一些带有关键字的结果。为了能让用户更精准地查询到目标景点，本产品同时采用了输入提示API，最大程度的减少人工智能出错的概率。

# 三、界面流程及关键智能交互
***********************************
## A. 用户旅程地图

![用户旅程地图](images/用户旅程.jpg)

## B.产品需求设计

## 1. 产品背景
- 随着经济的发展以及消费的升级，旅游的普及率逐渐提高，我国各个地区拥有丰富的旅游资源。**面对数量众多、路程遥远、不了解的景点，如何在茫茫景点中找出自己想去的那一个，是大众在旅游前面对的大难题。** 
- 游客对景点不熟悉，**导致到达景点，却又难以进门参观游玩，是旅游时的一大遗憾。** 因此，了解各个景点的注意事项和开放时间是游客迫切想要知道的关键点。

## 2. 技术可行性 Feasibility
着眼于用户想要获取景点相关信息的需求，调用全国景点查询和输入提示的API服务，便可以通过API帮助用户筛选自己感兴趣的景点，获得详细的景点信息。上述人工智能API的能力优异，识别准确率均在90%以上，能够很好地服务用户。

## 3. 用户可欲性Desirability
>根据 **[报告](https://baijiahao.baidu.com/s?id=1662104716015160500&wfr=spider&for=pc)** 显示，随着居民消费水平的不断提高，旅游文化建设进程的不断开展，出游人群规模不断扩张，中国在线旅游市场全年交易规模达到10866.5亿元人民币，线上渗透率预计达到16.7%，成功突破万亿级规模；同比增长11.4%，增幅较去年提升2.1个百分点，重回双位数增长轨道。

显然，随着生活水平的提高，旅游正是作为一种生活品质的符号而受到越来越多人的喜爱。
随着中国旅游市场的发展，关于旅游的手机应用也应运而生，这些旅游APP对于旅游  行业的发展起着至关重要的作用。

## 4. 商业可行性 Viability
万维易源、高德提供了一定数量的免费API调用额度和优惠的额度套餐服务支持我们的产品技术运行。而且成本低廉。同时，本App还可以通过提供付费订阅Pro版功能，让有需求的用户支付相关的API调用成本费用，在为用户提供更多人工智能API功能的同时实现盈利。

## 5. 价值主张画布
![价值主张画布](images/价值主张画布.jpg)
## C.产品结构展示
### 1. APP功能结构图

![APP功能结构图](images/功能结构图.jpg)

### 2. 界面流程图

![界面流程图](images/界面流程图.jpg)

### 3.产品设计原型

#### 交互及界面设计

APP页面展示  
![APP功能展示图](images/APP界面.jpg)

# 四、数据流程及关键智能API使用 
***************************************
- ### 数据流程图
![数据流程图](images/数据流程图.jpg)

### 1、API展示说明及输出
 **（1）全国景点查询接口（万维易源平台）** 
- 接口描述：该服务根据关键字、省市区域的ID，查询景点列表。
- 平台接入网址:[全国景点查询接口](https://www.showapi.com/apiGateway/view/268/1)
- HTTP 方法：支持GET/POST
- 请求URL：https://route.showapi.com/268-1
- 1. 调用前进行登录认证获取密钥：[获取密钥](https://www.showapi.com/console#/myApp)  
- 2. 调用API输入：
```
# 全国景点查询
#运行本代码需要下载SDK包获取ShowapiRequest模块

from ShowapiRequest import ShowapiRequest
import pandas as pd

r = ShowapiRequest("http://route.showapi.com/268-1","521349","3eb3f2d0dec24d30adb03c90905b3410" )
r.addBodyPara("keyword", "北京故宫")
r.addBodyPara("proId", "")
r.addBodyPara("cityId", "")
r.addBodyPara("areaId", "")
r.addBodyPara("page", "")
# r.addFilePara("img", r"C:\Users\showa\Desktop\使用过的\4.png") #文件上传时设置
res = r.post()
# print(res.json) 
res.json()[ 'showapi_res_body'][ 'pagebean']['contentlist'][1]# 返回信息
```

- 3. 输出结果：
```
{'address': '北京市景山前街4号',
 'areaId': '642',
 'areaName': '东城区',
 'attention': 'A：故宫将自2014年1月1日起，除法定节假日和暑期（每年7月1日至8月31日）外，全年实行周一闭馆的措施。B：自2011年7月2日起，故宫博物院实行自南向北单向参观路线：午门（南门）只作为参观入口，观众一律从午门进入故宫；神武门（北门）只作为参观出口，观众参观结束后一律由神武门离开故宫。C：北京故宫只能刷身份证入园，预订日期当天携带好身份证到景区刷身份证入园。（因二代身份证丢失或损坏无法检票的，可凭预售登记的身份证号到指定售票窗口补领纸质门票检票进门）D：如遇景区电子票验证通道检修，需要客人配合到指定窗口换取验票凭证入园，敬请谅解！E：门票当天有效，出园需入园，需再次购票F：身份证实名的产品，请填写真实姓名和身份证号，不然无法顺利入园。预订必读1、北京故宫2015.6.1日开启式施行一个有效证件每个入院日只能订一张票，且一个证件单个入院日所预订的所有订单必须统一验证入院，不得分批次验证入院。超过1人请提供多张有效身份证分批次下单购买！同一有效身份证在同一出游日只能下单一次，请勿多次下单。\r\n2、故宫预售门票一经出售一概不退不换不改期！即您的参观日期确定提交后无法修改。如行程因客观原因不得不变更，需修改或取消订单，需收取订单金额100%的票券损失费。3、必须在出游日前1天的15：00前下单，电子码信息在出游日前两天发送到客户手机上。4.故宫内不得吸烟！5、北京故宫因反法西斯战争胜利70周年，周边管制要求于8.22-9.3日暂时闭馆，请您提前做好行程安排，若给您还来不便请谅解，谢谢。活动提醒1.预订日期当天携带好身份证到景区刷身份证入园①老年人入园需出示身份证和老年证.②学生入园需出示学生证.2.★在线咨询QQ群②：（此QQ群为驴友自发旅游经验分享群，不代表同程网官方）',
 'cityId': '0',
 'content': '故宫有四个门，正门名为午门。午门有五个洞。其平面为凹形，宏伟壮丽。午门后有五座精巧的汉白玉拱桥通往太和门。东门名东华门，西门名西华门，北门名神武门。故宫的四个城角都有精巧玲珑的角楼，角楼高27.5米，十字屋脊，三重檐迭出，四面亮山，多角交错，是结构奇丽的建筑。正门午门，俗称五凤楼。午门是皇帝下诏书、下令出征的地方。每遇宣读皇帝圣旨，颁发年历书，文武百官都要齐集午门前广场听旨。午门当中的正门平时只有皇帝才可以出入，皇帝大婚时皇后进一次，殿试考中状元、榜眼、探花的三人可以从此门走出一次。文武大臣进出东侧门，宗室王公出入西侧门。后门神武门，明朝时为玄武门，清康熙年间因避讳改称神武门。神武门也是一座城门楼形式，用的最高等级的重檐庑殿式屋顶，但它的大殿只有五开间加围廊，没有左右向前伸展的两翼，所以在形制上要比午门低一个等级。神武门是宫内日常出入的门禁。现神武门为故宫博物院正门。 东华门与西华门遥相对应，门外设有下马碑石，门内金水河南北流向，上架石桥1座，桥北为三座门。皇帝死后其灵柩就从东华门运出，故俗称鬼门。太和门，在午门以内，有广阔的大庭院，当中有弧形的内金水河横亘东西，北面就是外朝宫殿大门&mdash;&mdash;太和门，左右各有朝房、廊庑。金水河上有5座桥梁，装有白色汉白玉栏杆，随河宛转，形似玉带。 风景图 风景图故宫建筑的后半部叫内廷，是皇帝及嫔妃生活娱乐的地方。前朝与内廷宫殿的分界线乾清门，乾清门以南为前朝，以北为内廷。乾清门左右有琉璃照壁，是清朝御门听政的所在地。太和门和乾清门都是殿的形式，虽然名字上是门，在明代皇帝上朝处理政事都是在太和门，清代的时候皇帝上朝处理政事才改到乾清门。内廷以乾清宫、交泰殿、坤宁宫为中心，东西两翼有东六宫和西六宫，是皇帝处理日常政务之处也是皇帝与后妃居住生活的地方。后半部在建筑风格上同于前半部。前半部建筑形象是严肃、庄严、壮丽、雄伟，以象征皇帝的至高无上。后半部内廷则富有生活气息，建筑多是自成院落，有花园、书斋、馆榭、山石等。内廷东侧的宁寿宫是当年乾隆皇帝宣布退位后当太上皇养老皇宫，花费一百一十万两银修建。 风景图 风景图故宫这样宏伟的建筑，如此浩大的工程，由谁负责设计？又是谁主持施工的？这的确是个历史谜团，难倒不少老北京人。因为故宫的建筑上没有如现代建筑那样明确地刻上此建筑物建于何年，由何人设计等字样。目前大多数人都认为故宫是明代一位杰出的匠师，姓蒯名祥，人称蒯鲁班的人设计的。故宫博物院古建部高级工程师于倬云先生提出了不同意见：曾经参加建造南京宫殿的蒯祥是故宫的设计者这个说法不确切，其实，蒯祥只是故宫的施工主持人，故宫真正的设计人应该是名不见经传的蔡信。永乐15年紫禁城宫殿开始进入大规模施工高潮时，蒯祥才随朱棣从南京来到北京，开始主持宫殿的施工，而在此之前，蔡信已主持故宫和北京城的规划、设计和建造了。 风景图 风景图',
 'coupon': '学生：大学、高中、初中、小学学生持国外学生证除外（含港、澳、台学生；不含成人教育、研究生），可凭学生证购买学生票。小学学生若没有学生证，可根据预定时填写的身份证兑换纸质票。老人：60岁以上（包括60岁）老年人凭有效证件，门票半价优惠。离休干部：离休干部凭离休证免费参观。残疾人：残疾人凭残疾人证件免费参观。儿童：身高1.2米(含)以下儿童可以随监护人免票参观。',
 'ct': '2020-05-06 22:23:49.079',
 'id': '3007',
 'location': {'lat': '39.92353999', 'lon': '116.40343283'},
 'name': '北京故宫',
 'opentime': '售票时间：08:30--15:30停止入馆时间：15:40清场时间：16:30除法定节假日和暑期（每年7月1日至8月31日）外，全年实行周一全天闭馆的措施。',
 'picList': [{'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RWAIE49AAG4uVc17aM381.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RWAIE49AAG4uVc17aM381_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ReAbWJ4AAO9IG8_Iv4217.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ReAbWJ4AAO9IG8_Iv4217_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RaAMo2lAAIxQCdPeIE381.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RaAMo2lAAIxQCdPeIE381_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ROAfNooAANVcqKJRfQ883.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ROAfNooAANVcqKJRfQ883_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-ReAZM8vAALofFW-Zqk446.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-ReAZM8vAALofFW-Zqk446_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ReAd_ETAAHvZtzLLXk401.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ReAd_ETAAHvZtzLLXk401_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RiAT0UAAAKnB816bkk086.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RiAT0UAAAKnB816bkk086_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ReAWf9SAAKkEsFr2iU141.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ReAWf9SAAKkEsFr2iU141_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RiAZP1SAALTp5-JfoM731.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RiAZP1SAALTp5-JfoM731_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-ReAFwZ9AAJeUMY29vk811.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-ReAFwZ9AAJeUMY29vk811_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ReASJlAAAJwiKc1Ugg187.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ReASJlAAAJwiKc1Ugg187_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RiAGDmsAAIP8dv7icQ314.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RiAGDmsAAIP8dv7icQ314_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RaABIJwAAHfiTXx2w0712.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RaABIJwAAHfiTXx2w0712_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RaASze9AAJGwa_WzL8701.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RaASze9AAJGwa_WzL8701_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RaAc8_zAAE2vbvLpFo594.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RaAc8_zAAE2vbvLpFo594_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RaARNe7AAMAO1N0UMc639.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RaARNe7AAMAO1N0UMc639_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RaAH0A4AAKo88dJ0fU948.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RaAH0A4AAKo88dJ0fU948_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RWASi7HAAL07m9t0MQ039.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RWASi7HAAL07m9t0MQ039_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RWAan-pAAHemHiyBvs657.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RWAan-pAAHemHiyBvs657_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RWAEAPMAAFdKKcx8Zc661.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RWAEAPMAAFdKKcx8Zc661_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RiAKf1YAAO9xrNPtzY297.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RiAKf1YAAO9xrNPtzY297_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RWAY5tUAAGkhbP4I8I982.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RWAY5tUAAGkhbP4I8I982_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RWAf1NiAAFYq1piPWQ035.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RWAf1NiAAFYq1piPWQ035_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RSAKja4AAFIdcP9WwY294.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RSAKja4AAFIdcP9WwY294_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RSARp4GAAMDN1fYbWg418.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RSARp4GAAMDN1fYbWg418_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RSAJeMoAACTVDNwdOo978.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RSAJeMoAACTVDNwdOo978_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RSAbTyaAASa7u5c0r0706.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RSAbTyaAASa7u5c0r0706_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/85/rBANB1x9-iCANmTGAAIjlsCz9UU882.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/85/rBANB1x9-iCANmTGAAIjlsCz9UU882_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RSAZCmYAALUe6sYVbA585.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RSAZCmYAALUe6sYVbA585_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RSAJVuZAAGwJvt37io907.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-RSAJVuZAAGwJvt37io907_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RSAKMb_AAGMMNgS-G4494.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-RSAKMb_AAGMMNgS-G4494_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/85/rBANB1x9-iCAUtWGAAF9GqtAC5M464.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/85/rBANB1x9-iCAUtWGAAF9GqtAC5M464_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ROAeLZdAAMVy4Xm-U8391.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ROAeLZdAAMVy4Xm-U8391_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/85/rBANB1x9-h-AMi6dAAOHjTzee9c053.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/85/rBANB1x9-h-AMi6dAAOHjTzee9c053_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-ROAcsY5AAFEKqovZVM075.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-ROAcsY5AAFEKqovZVM075_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-ROAaigkAALrZ-Z2ZMQ664.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/71/rBANB1x9-ROAaigkAALrZ-Z2ZMQ664_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/65/b2/rBANB1x9_HSAXM-UAANuVlZ8Kd8188.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/65/b2/rBANB1x9_HSAXM-UAANuVlZ8Kd8188_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ROAH_-3AAK1Fwdpvu8494.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ROAH_-3AAK1Fwdpvu8494_130x130_00.jpg'},
  {'picUrl': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ROAen8dAALtVzB4JQQ382.jpg',
   'picUrlSmall': 'http://pic5.40017.cn/03/000/dd/48/rB5oQFx9-ROAen8dAALtVzB4JQQ382_130x130_00.jpg'}],
 'priceList': [],
 'proId': '3',
 'proName': '北京',
 'star': '5A',
 'summary': '世界上现存规模最大、保存最完整的帝王宫殿'}
 ```

**(2)输入提示（高德开放平台）**   
- 参考文档：[输入提示API服务接口](https://lbs.amap.com/api/webservice/guide/api/inputtips)
- 接口描述：输入提示是一类简单的HTTP接口，提供根据用户输入的关键词查询返回建议列表。
- HTTP 方法：支持GET
- 请求URL：https://restapi.amap.com/v3/assistant/inputtips?parameters
- 调用API输入：
```
# 输入提示

import requests
huang_key="f9c67660b4fb5495dbf50ab796f74b1e"
input_tips_url = "https://restapi.amap.com/v3/assistant/inputtips?parameters"
keyword="鸳鸯湖"
city="阳江市"
params = {
        "key": huang_key,
        "keywords": keyword,
        "output": "json",
    }
r = requests.get(input_tips_url, params)
r.json()['tips'][0]
```
- 输出结果：
```
{'id': 'B0FFFPCYKW',
 'name': '鸳鸯湖',
 'district': '广东省阳江市江城区',
 'adcode': '441702',
 'location': '111.992970,21.852860',
 'address': [],
 'typecode': '190204',
 'city': []}
 ```
 
 **(3)源代码展示[（点击此处跳转链接）](期末API代码测试.ipynb)**  
 
### 3、人工智能概率性考量：
全国景点查询API在查询景点时会有概率抓取到其他一些带有关键字的结果。为了能让用户更精准地查询到目标景点，本产品同时采用了输入提示API，最大程度的减少人工智能出错的概率。

### 4、API使用价格
#### 免费额度
> [万维易源产品价格文档](https://www.showapi.com/apiGateway/view/268/1?tab=productPrice)

全国景点查询具有免费调用额度，开通付费后，免费调用额度仍保留。开始产生调用次数时，优先抵扣免费额度，超出免费额度后按次计费。免费额度如下：
![免费额度](images/免费额度.png)

#### 全国景点查询API价目表
> [万维易源价目表](https://www.showapi.com/apiGateway/view/268/1?tab=productPrice)

QPS叠加包 是指已经开通付费（或购买次数包）的情况下，在默认10QPS的基础上继续购买获得更多的QPS并发量。请注意：调用量依然按次计费。（QPS：每秒可发送请求数）

![全国景点查询API价目表](images/价目表.png)

#### 高德
> [高德产品价格文档](https://console.amap.com/dev/flow/manage/f9c67660b4fb5495dbf50ab796f74b1e)

输入提示具有免费调用额度，使用完免费调用额度后，可以选择提升并发量或调用量两种方式提升配额。

![免费额度](images/高德免费额度.png)

# 五、学习/实践心得总结及感谢
********************************
-  **心得总结：** API项目在起步阶段着手是困难的，我在面对众多的API时，不知道选用什么哪个API服务，也很难将众多的API和我们生活中的痛点相连接起来。在构思阶段，我从我们日常生活中所遇到的问题出发，提出解决方案，再寻找合适的API，如此一来着手完成API项目就不再是一件令人头痛的事情了。  
这次项目我利用了**万维易源平台的“全国景点查询API”以及高德开放平台的“输入提示API”** 进行整合并加值和优化。此次项目中有产品原型的制作，产品数据流程的设计等许多部分，通过这次项目，我对于交互流程、用户界面有了清晰的了解。

-  **感谢：** 感谢万维易源以及高德开放平台为本次项目提供了API服务。感谢[墨刀](https://modao.cc/)提供了产品原型的制作工具。感谢[processon](https://www.processon.com/)提供流程图制作工具。也感谢各位老师以及同学对我API课程的帮助与指导。衷心地感谢你们！让我在API课程中收获了关于API调用等相关知识。

********************************
# 附件：
- 20*20秒PPT[（点击此处跳转下载）](https://gitee.com/huangxiaoing/api-final-project/blob/master/%E4%BA%A7%E5%93%81%E9%9C%80%E6%B1%82%E6%96%87%E6%A1%A3PPT.pptx)
- 20*20秒录屏[（点击此处跳转）](https://www.bilibili.com/video/BV1wv4y1f7e1/)
- 旅游信息小程序设计——轻途2.0[（点击此处跳转）](https://gitee.com/huangxiaoing/api-final-project/blob/master/%E6%97%85%E6%B8%B8%E4%BF%A1%E6%81%AF%E5%B0%8F%E7%A8%8B%E5%BA%8F%E8%AE%BE%E8%AE%A1%E2%80%94%E2%80%94%E8%BD%BB%E9%80%942.0.docx)

黄晓颖/旅游景点信息查询类APP__轻途

简介

发行版

贡献者

近期动态

黄晓颖/旅游景点信息查询类APP__轻途 .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

黄晓颖/旅游景点信息查询类APP__轻途