# API **Repository Path**: zhengqiuzhen/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**: 1 - **Forks**: 0 - **Created**: 2022-03-14 - **Last Updated**: 2025-03-07 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 游西递小程序 ![输入图片说明](images/image.png) [游西递小程序项目仓库链接](https://gitee.com/zhengqiuzhen/xiaochengxu) ## 一、项目介绍 ### 1. 开发背景 西递村作为乡村振兴战略面向对象中的一员凭借自身优势迅速发展，随着知名度的提高，传统的人工引导、接待、服务游客的方式已经不能适应逐年增长的游客量，为此我们利用现代互联网技术为西递旅游业开发一个微信小程序的平台，系统地对西递景区进行信息化的分析整合，并结合大数据精准分析，给用户一个更好的旅游体验的同时让西递文化有更好的发展，为西递振兴提供支持。 ### 2. 需求分析 2019年，中国城乡居民旅游消费持续攀升。城镇居民旅游消费达4.75万亿元，乡村居民旅游消费为0.97万亿元，旅游成为中国人民的必需品。随着居民人均可支配收入的增加和全域旅游意识的提升，未来旅游业的发展前景较广阔。乡村旅游是应对全面小康社会大众旅游规模化需求的新理念、新模式和新战略。 随着乡村振兴国家战略的层层推进，乡村游市场向好发展。2021年1-5月，乡村游客规模累计达到86653.7万人次，较2020年同比增长55.5%。作为积极发展乡村振兴中的一员，西递村在2019年的旅游收入达4691万元。目前村内从事旅游相关的营业户260家，从业者超过1000人。如今，西递村年接待参观者百万人次，年旅游总收入近2亿元，村民人均可支配收入4万余元。 ![输入图片说明](images/image3.png) 如以下数据所示，首先西递相关词汇搜索变化率都呈现着上升趋势，此外，自2011年以来的西递搜索指数呈现出只增不减的发展趋势，可见西递景区的知名度在不断扩大。 ![输入图片说明](images/image4.png) ![输入图片说明](images/image5.png) “游西递”小程序平台是在西递旅游人数日益增多的情况下应运而生，它是在现代人对旅游需求的提高和信息方便快捷、日益加速而提出的应用于西递旅游文化的小程序平台展示。 首先对于游客来说，该小程序平台会提供对西递景区的综合信息（景点文化介绍、景点图片、当地特产、民宿推荐、出行路线、天气预报、美团门票、景区基础设施等）的介绍及相关查询。对于想去西递旅游出行的门户，使用该平台无疑是一个很好的选择；对于西递景区来说，该平台展示了西递文化及风土人情，以线上引导游客代替人工解说，提高服务质量和效率，又能给用户一个更好的游玩体验，更好地促进了西递旅游业的发展。 ### 3.用户画像： ![输入图片说明](images/image6.png) 用户A（游客)： 任务：去西递景区旅游； 痛点：不熟悉景区路线、景点、住宿、基础设施等情况，网上相关攻略信息繁杂多样，参考价值及范围有限。 场景：节假日期间第一次来到西递景区，对景区了解较少，在网络上寻找、收集游玩攻略，很大部分的网络攻略信息比较分散、繁杂多样，很难判断，且平常上班没有很多的时间去做旅游攻略，对景区情况很茫然，刚好“游西递”这个小程序平台，能让用户在有限的时间内对西递景区的文化、主要景点、门票、基础设施位置、路线推荐、民宿酒店还有人气比较高的美食餐馆等信息更加的了解。 ![输入图片说明](images/image7.png) 用户B(西递景区方）： 任务：以线上指导代替人工解说，提高服务质量及效率，给游客更好的旅游体验； 痛点：很少有简单方便的微信小程序平台去展示解说西递文化及游玩攻略，节假日期间，人工的解说、服务已经够应对不了大批的游客量，服务的质量及效率较低； 场景：来西递游玩的游客不了解西递景区、酒店及民宿、美食、基础设施等很是苦恼，需要解说员或者当地人来一一解说指导，但解说人员有限，且游客与当地人语言上有一定的差异会导致沟通有一定的障碍，这时候给游客推荐微信小程序“游西递”便可以让游客自行查看游玩景点路线、酒店民宿、基础设施等情况，既让游客提高了游玩体验感又节省了人工劳动力。 ### 4.痛点与解决实际问题： 游西递小程序平台，主要为“去西递旅游的游客”和“西递景区方”提供便利，我们分别对两方的现实痛点进行分析，经过痛点分析之后利用小程序平台去解决他们实际存在的问题。 #### 4.1提高了游客出行效率及游玩体验感 ![输入图片说明](images/image8.png) （1）首先对于游客而言，很多游客不了解当地文化、不知道景点路线而迷路；对此我们通过腾讯地图Api，根据游客所在位置进行实时定位，同时也详细地展现了各景点位置，减少游客迷路的可能性方便游客参观游玩 ； （2）很多人不会做游玩攻略或者由于工作原因没有时间做游玩攻略，且网络上有关信息分散、繁杂多样、难以整合；就会减少他们想来西递游玩的需求或者来游玩的体验感较差。 对此，我们通过系统地整合各平台上的西递旅游攻略信息，做出详细的西递旅游攻略信息（包括交通地理信息、景点及美食推荐、票价信息、线路信息等），直接打开攻略信息便可以查看，此外我们设置了美团购票，打开即可进行购票，方便快捷； 很多游客不了解当地的酒店民宿和特产美食等，会对游客的衣食住行造成不便，使其游玩体验感较差；对此对西递地方特产、村落特色、民宿酒店等做了相关介绍和推荐，可供游客参考。 #### 4.2提高了西递景区文化知名度,助力了乡村振兴 ![输入图片说明](images/image9.png) 对于景区而言，多一个有关自身的线上网络平台即多一个宣传渠道，也扩大了宣传范围，一定程度上会提高景区知名度；同时我们利用小程序平台对景区进行了系统又全面的指导、介绍，节假日旅游高峰期间游客可以直接使用线上指导代替去找景区工作人员解说，即为景区节省了人工成本，又提高了服务的质量和效率,随着游客数量的增加，也会给当地人民带来经济收入，提高村民生活水平，助力乡村振兴！ ## 产品设计 ### 1.小程序说明 游西递可以使用户能随时随地在线获得旅游新信息。线上购票、地图导览以及天气实时预报等为用户的出行提供了便捷，使用户实现随时下单随时出行。 ### 小程序流程图： ![输入图片说明](images/image10.png) 游西递小程序共分为四个主要版块（置于底部 tabbar 栏），主要功能分布如下： #### (1)首页：页面划分为三大部分，顶部是实时天气和轮播图。实时天气可以获得西递村当地的天气状况以及空气湿度、风级等等。 金刚区分别为民宿推荐，村落特色，地方特产，地图导览。 民宿推荐主要展示民宿的位置、设施、价格以及独有的特色，详情页包括可以民宿下单的二维码。 村落特色主要以推文形式展示村落特色详情内容。 地方特产分为当地美食以及当地特产，当地美食主要由历史由来、材料和制作方法三个部分构成，使用户对当地美食有个更清晰的认识，历史由来增强趣味性，同时传播当地的传统文化。当地特产主要由功效和营养价值，推荐理由三部分构成，意在让用户了解当地特产的同时拉动地方经济增长，提升地方知名度，促进旅游业的发展。 地图导览：为用户提供线上地图，便于用户掌握西递村整个布局。 中间部分为景点特色，主要内容是介绍景点。 #### (2)文化：主要是文化介绍及推广，采用链接公众号推文的方式，使用户获取一个更好的体验感 #### (3)攻略：包括周边旅游信息、游玩攻略和旅游指导。周边旅游信息主要包括旅游信息、交通地理信息、美食贴士和住宿推荐。游玩攻略采用推文形式进行整合，旅游指导主要是线路规划内容。 ### 2.创新点与价值 游西递主要以互联网+旅游业+美丽乡村+文化有机结合，主要以生态保护为基础，文化发展为核心，乡村特色为主题，文旅产品为载体，兼顾我国乡村文化的价值多元化与可延续性，让游西递在我国本土文化和经营中深耕发展，引领乡村旅游发展的风尚。 #### 2.1 智能数字化扶贫 游西递以发展特色产业脱贫为主线，目的是实现乡村旅游大发展，为农民增收、脱贫致富。通过文旅融合赋能乡村振兴，是将文化产业和乡村旅游进行深度融合，实现文化引流与旅游消费的有机结合，培育文旅融合发展乡村旅游的新业态、新模式。同时，把乡村旅游商品市场价值最大化，让乡村的物产资源深加工火起来，让乡村特色旅游商品走出乡村，走向世界。 ## 三、交互与界面设计 ### 1. 产品设计风格与主题 #### 1.1 主题设计 小程序 UI 设计以山水插画为主要的设计风格，使西递村的景物更具中国风，打破用户以往对传统旅游小程序的固有印象。整体的背景颜色和icon图标用清新绿和淡蓝色，目的是给小程序增加跳动性。 #### 1.2 产品设计风格 （1）中国手绘插画风 #### 颜色搭配 轮播图手绘以灰、青、白色的色彩搭配，白色和灰色冲淡颜色，青色作为辅助色，相邻的颜色比较多的浅色调，色彩和谐，会在一种颜色中产生丰富的层次。很少有强烈互补色的对比出现，而主要是用淡彩轻敷的色彩设定为主，给人们清新淡泊的感觉，这种色调可以给人以宁静，清新，从容。符合像西递古村落这种有着深厚文化底蕴的古村。 #### 手绘肌理 运用手绘肌理和图形来传递情感，给用户形象直观、生活感真实和情感的感染力。将西递村特色景点与现代插画结合，中国传统元素、竹叶、仙鹤，大雁等元素运用在插画里，使得插画有着浓郁的中国特色，图片中那句诗也是画龙点睛，突出西递村的景物风貌，彰显出西递村独特文化底蕴的深厚。 #### 字体 采用行楷，行笔轻盈，体现灵动美，辨识度较高，给用户留下深刻印象。笔法比楷书简，体现了实用美。也从侧面彰显出小程序美观实用。 ![输入图片说明](images/image11.png) ## 2.设计原则及呈现 ![输入图片说明](images/image12.png) ![输入图片说明](images/image13.png) ![输入图片说明](images/image14.png) ![输入图片说明](images/image15.png) ![输入图片说明](images/image16.png) ![输入图片说明](images/image17.png) ## 四、技术方案 ### 1.系统总体开发框架设计图 ![输入图片说明](images/image18.png) ### 2.技术选型级开发环境 #### 2.1 第三方资源 > 开放API接口 >> * 高德地图API—地理编码、逆地理编码、天气查询 >> * 百度AI开放平台—图像识别—菜品识别 #### 2.2 API技术加成 为吸引用户，增加用户可玩性，小程序结合百度AI开放平台提供的图像识别API中的菜品识别，小程序通过wx.showActionSheet 方法调用手机相册与摄像头，再使用wx.getFileSystemManager将图片转化Base64编码，具体实现逻辑如下所示: ![输入图片说明](images/image19.png) 用户点击图案后，通过wx.showActionSheet选择相应的功能调用手机摄像头与相册，调用摄像头完成拍照后直接使用wx.getFileSystemManager将图片文件转化为base64编码，再通过百度菜品API接口，进行 API 的调用，最后读取需要的参数。 本小程序的产品设计理念是以人为本，想让用户以最直观的方式获取有效信息。利用高德天气 API 返回景区实时天气，让用户在准备出发时，能够查看此时的天气状况来决定是否出行。 ![输入图片说明](images/image20.png) 显示实时温度、天气状况的文字描述，对 request 请求返回的结果 res.Data 的 res.data.lives[0].temperature res.data.lives[0].weather,res.data.lives[0].winddirection、 res.data.lives[0].windpower进行取值，通过数据绑定渲染到天气页面与首页。 ### 3、重要设计 #### 3.1“游西递”小程序开发主要实现功能与实现方式 1. 智能识图识别，识别出菜谱并有详细说明——百度图像识别 API 1. 实时天气，实现天气预报——高德地图天气查询API 1. 西递村区域定位，了解地理位置——高德地图API 1. 菜谱弹出框介绍——数据调用、if、else语句嵌套 #### 3.2产品功能架构流程图 ##### 3.2.1核心功能“地理位置获取”服务数据流 ![输入图片说明](images/image21.png) 小程序的定位功能，主要的就是获取用户位置的经纬度，然后根据用户的经纬度进行一些判断操作。在小程序提供的API中，获取用户定位信息主要API是wx.getLocation。 但是使用这个API，会先获取用户授权。如果用户取消授权，那么再调这个API，也不会再出现授权页面，也就不能再获取用户位置了，这就需要使用其他的Api辅助打开授权页面了。所以获取用户位置就需要完整的授权、获取位置的流程及异常流处理了。页面加载默认调用 wx.getLocation ,wx.openSetting 打开授权设置界面，如果授权界面设置允许授权，则返回页面再次调用 wx.getLocation。 ### 4.推荐与协同过滤 #### 4.1 基于用户的协同 基于用户的协同过滤的基本原理是，根据所有用户对物品或者信息的记录，发现与当前用 户相似的用户群，然后基于这些用户的历史偏好，为当前用户进行推荐。 用户A、用户B、用户C都是刚高考毕业的女孩子，准备去西递村游玩，用户A比较路痴，想要一个能导航的软件、用户B希望能够找到推荐值比较好的民宿、用户C希望能在出发前看到西递村的实时天气与实时定位导航。用户B在微信搜索关键词西递村时发现本小程序，并且感觉到它也符合用户A、用户C的需求，于是将其推荐给用户A、用户C。 ![输入图片说明](images/image22.png) #### 4.2基于物品的协同 使用所有用户对物品或者信息的偏好，发现物品和物品之间的相似度，物品与物品之间的 相似度不是从内容属性的角度衡量的，而是从用户反馈的角度来衡量的。用户A、B、C都喜欢旅游，喜欢用一些查询旅游信息类的软件，用户A、B都使用过游西递小程序去西递村旅游，觉得西递村很不错，这个小程序也很实用，于是把西递游小程序推给C。 ![输入图片说明](images/image23.png) ## 五、系统测试 ### 1. UI 测试 以产品开发文档和 UI 设计为依据，检查小程序的界面美观度，字体大小，字体格式，按钮布局，色彩搭配等是否完好。 |测试部分|问题与建议|更改方案|版本迭代| |字体 |样式： 突出、生硬|将原纯黑体的色号改为#323333|1.0.0| |按钮 |样式：大小呈长方形 ，按钮偏大|改为圆角形，按钮调小|1.0.2| |色彩搭配|icon颜色过于高亮、地方特产卡片颜色颜色过于暗|icon颜色改为#e0f0ea,卡片颜色改为#fef6e4|1.0.2| ### 2. 功能测试 小程序功能测试主要针对食物识别，地理位置授权以及获取实时天气的测试，通过用展示平台实际的系统性功能测试，测试结果满足预期达到的效果，具体说明如下： ![输入图片说明](images/image24.png) ### 3.性能测试 ![输入图片说明](images/image25.png) #### 首次渲染时 ![输入图片说明](images/image26.png) #### ios启动耗时 ![输入图片说明](images/image27.png) Android启动耗时： ![输入图片说明](images/image28.png) #### 性能综合测试 ![输入图片说明](images/image29.png) 利用微信开发者工具自带的性能测试，小程序在启动性能与运行性能中显示移动端设备初启动耗时约 2s，网络请求平均耗时 4s，从中也可以看出：Android启动耗时比ios启动耗时更高一些，不过基本满足流畅的用户体验需求。 ### 4.4. 兼容性测试方案 (1)在小程序管理后台查看近 30 天内访问当前小程序的用户所使用的基础库版本占比。 (2)Top10 机型和微信客户端组合手动兼容（通过长按删除微信小程序清理缓存方式，进行新安装及覆盖安装的数据兼容性测试）。 (3)使用开发版本通过微信开发者工具提交远程真机随机测试。 ## 六、系统线上推广与运营 ### 1.系统线上推广策略 ### 官方广告位 （1）关键词推广以及搜索广告：微信已上线小程序自定义关键词推广的功能。开发者在微信小程序后台，点击“推广”，再选择“添加关键词”，输入关联的搜索关键词提交审核后， 就能绑定审核通过的关键词。通过关键词搜索推广实现小程序的曝光更为高效。 ![输入图片说明](images/image30.png) （2）附近的小程序广告：附近的小程序新增了广告投放渠道，投放广告之后，该广告会出现在附近小程序，点击即可打开对应的小程序。 ### 第三方推广 （1）小程序商店以及公众号：通过付费或其他方式将小程序投放至第三方小程序商店进行宣传。 （2）新媒体内容合作：找到与小程序的目标用户具有共性的媒体，通过推文将微信及其他平台的流量进行导入。 ### 2.运维 #### 2.1内容与活动运营 选题规划：运营人员会通过游西递小程序上的数据信息，筛选出用户在使用时出现的问题、频繁操作的功能、需要更新的信息等等有特点的数据信息绘制选题表格： ![输入图片说明](images/31.png) （2） 内容策划：有了基本的选题规划表格，负责运营的团队就可以根据这个表格进行内容设计整合。以推广西递文化旅游、推动西递乡村振兴为最终目的，策划更新小程序内容。 （3） 形式创意：运营团队根据确定好的内容策划进行创意讨论，以新颖的内容创意，吸引用户。 （4）内容传播：通过使用游西递的用户转发小程序，从而吸引更多的新用户入驻游西递小程序。 #### 2.2 用户运营 在小程序后端数据中获取有用数据，如： （1）用户规模与转化指标：用户访问量（UV），每日活跃用户数（DAU）、各个环节转化率、留存率、活跃率等等。 （2）转化率（针对用户使用某产品或参与某页面活动进行分析）主要指标：产品/活动页启动次数，活动参与用户数，页面停留时长（TP），A/Btest 各自转化率等。 （3）功能分析（针对用户在小程序使用过程中转化情况）主要指标：各页面按钮点击量（UV）、页面访问量（PV）、页面流失率等 （4）用户画像分析（针对用户行为及其基本属性建立用户画像）主要指标：用户性别、用户 年龄、用户所在地分布等通过数据分析，我们可以更精准的划分用户，不仅仅是用户的年龄、地域分布、活跃度，更深入可以区分用户的渠道场景、行为习惯等等。我们可以通过裂变扩展、对症下药的手段，刺激用户量加大。 #### 2.3了解小程序目标用户，建立用户画像。 (1)本小程序目标用户主要为游客，通过小程序后端获取数据进行数据分析，可以获得用户行为数据（使用频次、访问数据、搜索数据），通过对用户的数据分析，可构建用户画像，做用户分类，进行精准定位。 (2)通过数据分析，更精准地了解用户的偏好、习惯。以小程序用户浏览路径为例，通过用户路径得知用户一般行为，可以分析出用户是否喜欢该小程序，以及在哪部分遇到了阻碍，是否可以改进小程序。 #### 2.4社群运营 通过建立社群，把群体成员联系起来，让喜欢西递的成员之间有共同目标和持续的相互交往。主要是通过给用户创造仪式感、让用户找到组织、能够参与进来，找到归属感。平台通过建立社群，可以让其成员拉入新的成员进来交流并加入游玩西递的队伍。反复利用流量，提高用户的价值。 ## 课程实践心得 API和小程序的学习要日积月累、循环渐进，不能急于求成。刚开始学习API和小程序的时候，还是一个什么都不懂的小白，当然现在还是个小白，不过相比于开始学习的那段时间，还是有所收获的。API和小程序要靠自己去动手实践操作才能有所感悟。在这个学期，我学会了函数的调用、云数据库的使用和调用，还有数据库的增、删、改、查。在许智超老师的引导下，我学会了API的调用，感受到了API的强大魅力，还学会了如何组装一个小程序。当我遇到不懂的问题去问老师的时候，他都会耐心地教导我，非常感谢许老师！同时还要感谢师兄师姐为我们提供帮助，帮助我们解决各种难题。还要感谢我的队友，一起解决各种难题，互帮互助，让我体会到了团队合作的重要性。最后还要感谢网络上提供教程和解决方案的博主！ 希望自己再接再励，接下来还会继续学习，提高自己的编程能力和解决问题的能力。