前言:如果想最大化吸取本文经验,须有小程序开发基础,本文细节比较多(多看注释的提醒内容),请耐心理解,多动手尝试,收获会更加丰富
1.定位系统使用场景及概述
如美团外卖小程序
点定位
点搜索
显而易见,随便一个电商小程序都需要用到定位服务,那么今天我们做一个类似的定位模块
定位模块总览
外部页面
内部页面(下文说的内外部页面就是指这两个)
好了接下来我们开始动手
2.定位外部模块样式
效果
代码
//wxml <view bindtap="getLocation" class="location"> <image src="/UploadFiles/2021-04-02/location.png">先不用管上面的{{location}},它是我们之后要从全局变量传过来的位置信息,定位符号是用image图片放进去的,我们用flex布局让图片和文字在同一行居中显示(见注释)
3.定位模块内部样式
效果
代码(分五个小模块,见注释)
//wxml //搜索模块 <view class="header"> <view class="search"> <image src="/UploadFiles/2021-04-02/sousuo.png">由于我的搜索框是用了自定义组件里面的搜索组件,我是在组件的基础上改出来的,原组件是这样的
我们需要把搜索图标隐藏,我们直接设置它的透明度为0,然后把我们的定位文字跟图标通过定位直接定位到搜索框的左边,所以样式的代码如下(代码太多不好找的话可以Ctrl+F直接搜索)
//wxss .dw{ color:rgb(0, 0, 0); position: absolute; top: 14px; left: -2px; } .dw button{ background: white; padding-right: 0; display: flex; align-items: center; font-weight: 600 !important; } .nowcity{ font-weight: normal; } .dw image{ width: 23px; height: 23px; } page{ padding: 10px; } .hotcity1 button{ margin: 10px; margin-bottom: 0; font-weight: 500 !important; border-radius: 10px !important; } .hotcity{ margin-top: 6px; } .map_container{ position: absolute; top: 0; bottom: 0; left: 0; right: 0; } .header{ display: flex; } .search{ flex:1; height: 40px; text-align: center; background: #fff; } .input{ flex:9; height: 40px; background: #fff; } .input input{ background: #f1f1f1; height: 30px; margin-top: 5px; margin-bottom: 5px; margin-right: 8px; border-radius: 10px; } .search image{ width: 70%; height: 25px; padding-top: 9px; padding-left: 5px; } .placeholder{ font-size: 14px; } .search image{ opacity: 0; } .input{ flex:4; } .input input{ position: relative; right: 0px; } .hotcity1{ display: inline; } .map{ position: relative; } map{ border:5px solid green; text-align: center; margin: 10px auto; position: relative; right: 10px; width: 90%; height: 150px; }然后我们的搜索里面点击搜索还会跳转到新的搜索页面,效果如下
这里我们可以直接复用上面的搜索组件,样式代码就不再贴出来了,这个模块要将搜索自动匹配的地点名称用循环的方式显示出来,代码如下
//wxml <import src="/UploadFiles/2021-04-02/search">//wxss @import '../templates/search/search.wxss'; .text_box{ margin: 10px 25px; border-bottom:1px solid #c3c3c3; padding-bottom:10px }4.外部跳转
当我们点击外部的位置信息,就跳转到内部的定位模块,刚刚我们在上面给外部的标签设置了触摸事件getLocation,接下来只要到js里面设置点击跳转(navigateTo)就可以了,但由于我们的位置信息是用全局变量赋值的,所以我们要在app.js设置一个全局变量,代码如下
//app.js App({ globalData: { city:'暂未定位', userInfo:'无' }, )}//外部js // 引入app.js const app=getApp() const appG=app.globalData data: { //这里要初始化location,并将全局变量赋值给它 aboutList:'', location:appG.city }, Page({ //定义触摸事件 getLocation(){ wx.navigateTo({ //跳转到内部定位页面 url: '../location/location', }) }, )}5.点击定位
做这个功能之前我们需要先考虑用什么地图接口,常用的有百度地图,腾讯地图,高德地图,本文选用高德地图接口作为演示,搜索https://lbs.amap.com/,注册,进入控制台,创建新应用,
再添加key
这个key就像我们小程序调用接口时的验证码,有了它我们才能从高德调取位置的数据,然后我们点击key后面的设置,再点击微信小程序SDK
进去之后点这两个,下载amap-wx.js 文件,然后在你的小程序目录里面创建一个libs文件,把这个amap-wx.js扔进去
接下来我们来到内部定位页面的js文件,因为这里要对全局变量进行修改来达到修改页面数据的效果,所以也要引入app.js,并把全局变量初始化到data里面,除此之外我们要引入高德的文件来实现高德接口的调用,在data里面我们这里顺便把等会要用到的热门城市等数据一并初始化了
const app=getApp() const appG=app.globalData //key里面填高德控制台里面给你的key const myAmapFun = new amapFile.AMapWX({key:'xxxxxxxxxx'}); data: { city:appG.city, hotcity:[ {'cityName':'北京市',longitude:'116.395645038',latitude:'39.9299857781'}, {'cityName':'上海市',longitude:'121.487899486',latitude:'31.24916171'}, {'cityName':'广州市',longitude:'113.307649675',latitude:'23.1200491021'}, {'cityName':'深圳市',longitude:'114.025973657',latitude:'22.5460535462'}, {'cityName':'武汉市',longitude:'114.316200103',latitude:'30.5810841269'}, ], tips: {},//搜索自动匹配的内容 longitude:'116.4',//经度(初始值在北京) latitude:'39.9'//纬度(初始值在北京) }然后我们给定位按钮设置点击事件getCity,这里用到高德地图里面的获取地址描述数据方法,教程可以参考刚刚高德控制台微信SDK里面的教程(下面搜索自动匹配提示的教程也一样)
此外我们我们还要在小程序后台给高德的接口添加域名,操作步骤为
登录微信公众平台,“设置“–>"开发设置"设置request合法域名,将https://restapi.amap.com 中添加进去,这样我们才能请求到高德的数据代码
getCity(){ myAmapFun.getRegeo({ success: data=>{ // that.setData({ // city:data[0].desc.slice(0,2) // }) appG.city=data[0].desc wx.getLocation({ success:res=>{ this.setData({ latitude:res.latitude, longitude:res.longitude }) wx.setStorageSync('city', appG.city) wx.setStorageSync('latitude', res.latitude) wx.setStorageSync('longitude', res.longitude) } }) }, fail: function(info){ //失败回调 console.log(info) } }) },getRegeo方法的成功回调函数里的参数包含了定位后的位置信息(可以自己输出一下),我们把它赋值给全局变量,然后再用setData再次把全局变量appG.city赋值给data里面的city(因为appG.city已经改变了,要重新赋值页面才会更新),除此之外我们还要把获取到的位置信息同步缓存起来,下次进入页面的时候在onLoad里面先判断有没有缓存的数据,如果有就直接使用缓存的数据,没有就用默认值,代码如下
onLoad: function (options) { // 进页面先看有无缓存数据,如果没有再读默认值,onLoad里面可以取到this.data const latitude=wx.getStorageSync('latitude') const longitude=wx.getStorageSync('longitude') const city=wx.getStorageSync('city') //用了三目运算符,不习惯也可以使用if latitude&&longitude&&city"text-align: center">
代码
nowCity(){ if(this.data.city!='暂未定位'){ wx.switchTab({ url: '../about/about', }) }else{ wx.showModal({ title: '暂未定位', content: '现在要进行定位吗', success: (res)=>{ if (res.confirm) { this.getCity() } else if (res.cancel) { return false } } }) } },7.热门城市点击跳转,更新数据
当我们点击热门城市里面的按钮时,跳转到外部页面,并且把对应热门城市名称更新到全局的city来传到外部页面显示,同时还要更新全局中的经纬度数据,对于经纬度只要更新缓存即可,下一次进入内部定位页面时再判断缓存中有无定位数据,如果有就直接用,city数据是更新+缓存,代码如下
hotCity(e){ const index=e.currentTarget.dataset.hotcityindex //更新 appG.city=this.data.hotcity[index].cityName //缓存 wx.setStorageSync('city', appG.city) wx.setStorageSync('latitude', this.data.hotcity[index].latitude) wx.setStorageSync('longitude', this.data.hotcity[index].longitude) //跳转 wx.reLaunch({ url: '../about/about', success:()=>{ // 不要把数据的更新写在这里,要在跳转之前就写好,因为这个回调函数是在跳转的页面所有函数 // 执行完之后才执行的,会导致数据两次跳转次才更新 } }) },上述代码中注意要在热门城市的循环标签用data-hotcityindex="{{index}}"把下标传到js中,再在js中用e.currentTarget.dataset.hotcityindex去取出来用,这个下标用来对应热门城市数组的每一个对象,这样我们就可以用this.data.hotcity[index].cityName来获取被点击的城市的名称,再把它更新到appG.city中,注意跳转的时候不能用wx.switchTab,因为从外部页面进来的时候已经打开了外部页面,那么用wx.switchTab的时候只会执行外部页面的onShow函数,而不会执行onLoad,会导致页面数据无法更新
8.搜索跳转和输入自动匹配地名
搜索跳转新页面(给内部定位页面设置聚焦事件)
bindFocus(e){ wx.navigateTo({ url: '../locationSearch/locationSearch', }) },注意内部页面的搜索框不是自动聚焦的,而跳转到新的搜索页面的搜索框是会自动聚焦的,这一点我们可以通过在搜索组件的input标签添加auto-focus="{{autoFocus}}",再控制autoFocus的值来控制是否自动聚焦,代码如下
<template is="search" data="{{autoFocus}}"></template>注意data="{{xxx}}"是自定义组件特有的传参方式,可以把js里面的值传到组件中使用不过我们得先在搜索页面的js的data中给autoFocus赋值,这里顺便把保存自动匹配的地名的值tips也初始化了
data: { autoFocus:true, tips:{} },接下来我们写输入自动匹配地名,同样在搜索页面的js引入全局变量和高德js文件
const amapFile = require('../../libs/amap-wx.js'); const app=getApp() const appG=app.globalData const myAmapFun = new amapFile.AMapWX({key:'0c2c8f2007702caa7e0498d6ad072f83'});然后我们来监听用户的输入行为,设置为bindInput函数
<input type="text" placeholder=" 请输入你想要的内容" placeholder-class="placeholder" bindinput="bindInput" bindfocus="bindFocus" auto-focus="{{autoFocus}}"></input>搜索页面的js中定义bindInput
bindInput(e){ myAmapFun.getInputtips({ // keywords为必填,不然无法获得tips,也就不会进入success函数 keywords:e.detail.value, success:data=>{ this.setData({ tips:data.tips }) } }) },上面的getInputtips就是我们第5点中讲到的微信小程序SDK中的获取提示词里面的方法,可以自己去看高德的教程,此处不再赘述,上面的keywords的值就是用户输入的内容,接口会根据这个去寻找对应匹配的地名并返回在success函数的参数中,我们只需要在成功回调函数中更新tips就可以了,那么此时假如我们输入武汉,效果如下
那么当我们点击自动匹配的地名的时候,需要返回到外部页面,并且更新数据,更新缓存,思路和上面的跳转方法是一样的,代码如下
bindSearch(e){ const location=this.data.tips[e.currentTarget.dataset.searchindex] wx.setStorageSync('city', location.name) if(location.location.length!=0){ const longitude=location.location.split(',')[0] const latitude=location.location.split(',')[1] wx.setStorageSync('latitude', latitude) wx.setStorageSync('longitude', longitude) wx.reLaunch({ url: '../about/about', success:()=>{ appG.city=e.currentTarget.dataset.keywords } }) }else{ wx.reLaunch({ url: '../about/about', success:()=>{ appG.city=e.currentTarget.dataset.keywords setTimeout(()=>{wx.showToast({ title: '暂无经纬度数据', // 提示延迟时间,不能用字符串 duration:2000, icon:'none' }) },500); } }) }由于不是每一个自动匹配的地点都有经纬度,所以我们对没有经纬度的地名做业务退步处理,仅提醒暂无经纬度的数据,(有时候业务退一小步,技术就有一大步的发挥空间–《大型网站技术架构》——李智慧),细心的你们肯定注意到上面用了定时器,因为如果不使用定时器,这个弹框是不会显示出来的,这个函数在页面加载完成之前就已经执行了,所以我们给他来一个定时器作为异步函数延迟执行,才能有弹框
9.对整个模块的优化和思考
对上述代码,笔者开发完之后发现了如下问题:
代码冗余严重,主要表现在多次使用缓存的api,重复量的地方很多
整个模块内部互相调用复杂,高耦合,低拓展
某些地方把简单的逻辑复杂化了,代码不够整洁
对于上述问题,笔者有如下思考:
通过封装缓存api来减少不必要的代码量,提高代码整洁度
对整个模块重新构思,提高可拓展性和可复用性(由于笔者水平有限,暂时搁置)
模块从开发开始到开发完成需要不断的演化和改进,这个过程才是让开发者成长的关键标签:小程序定位地图,小程序定位
更新日志
- 小骆驼-《草原狼2(蓝光CD)》[原抓WAV+CUE]
- 群星《欢迎来到我身边 电影原声专辑》[320K/MP3][105.02MB]
- 群星《欢迎来到我身边 电影原声专辑》[FLAC/分轨][480.9MB]
- 雷婷《梦里蓝天HQⅡ》 2023头版限量编号低速原抓[WAV+CUE][463M]
- 群星《2024好听新歌42》AI调整音效【WAV分轨】
- 王思雨-《思念陪着鸿雁飞》WAV
- 王思雨《喜马拉雅HQ》头版限量编号[WAV+CUE]
- 李健《无时无刻》[WAV+CUE][590M]
- 陈奕迅《酝酿》[WAV分轨][502M]
- 卓依婷《化蝶》2CD[WAV+CUE][1.1G]
- 群星《吉他王(黑胶CD)》[WAV+CUE]
- 齐秦《穿乐(穿越)》[WAV+CUE]
- 发烧珍品《数位CD音响测试-动向效果(九)》【WAV+CUE】
- 邝美云《邝美云精装歌集》[DSF][1.6G]
- 吕方《爱一回伤一回》[WAV+CUE][454M]