html5功能讲解(Html5定位终极解决方案)
html5功能讲解
Html5定位终极解决方案背景
到新公司的第二个项目,就是和小伙伴们一起做一个H5的商城,主要在微信内,但也要考虑到其他浏览器。其中,首页需要根据当前用户的经纬度找到距离最近的门店并展示。前端需要做的工作就是获取用户的经纬度然后查询后台接口并渲染页面。
目标与分析
我们的目标是经过封装之后,只需要调用一个方法就可以拿到返回的位置信息。
我们需要做的事情是,针对不同的端(微信H5和其他浏览器环境)封装不同的类,再通过一个方法通过 UA 区分,调用不同环境对应的类获取位置。
在微信内部,经过反复的实践之后,不论是通过原生的 HTML5 定位,还是通过第三方(如百度或腾讯地图) jsapi 获取位置,不仅定位时间长,甚至经常出现定位失败的情况,严重影响用户体验,尤其对于大部分信息流都依赖于用于位置的商城首页来说,是完全无法接受的。所以在微信内我们只有微信 sdk 这一种选择;
而对于浏览器端,通过第三方的地图 jsapi 或定位组件,可以稳定且较快速地获取位置信息,为了与微信内尽量保持一致,我们选择的是腾讯地图 jsapi。
解决方案
Talk is cheap, show me the code. 废话不多说,直接上代码:
1. 在浏览器中,通过腾讯地图jsapi获取位置
1.1 在项目的 html 模版文件中引入腾讯地图 jsapi
<!-- index.html --> <script charset="utf-8" src="https://map.qq.com/api/js?v=2.exp&key=腾讯地图key&referer=应用名称"></script>
说明:
使用腾讯地图 jsapi, 需要先去腾讯地图开放平台申请自己的账号,然后创建自己的应用,将腾讯地图key 和创建的应用名称替换上面的值。
1.2 调用获取位置接口,获取位置信息
为了方便复用,我们单独封装一个腾讯地图 jsapi 的类,命名为 tMap.js
// tMap.js const qq = window.qq var geolocation = null if (qq && qq.maps) { // 初始化定位组件 geolocation = new qq.maps.Geolocation( 'QVLBZ-YUULR-OUMW7-WKXFD-4SUWS-UDBIA', 'mymap' ) } class TMap { // 获取定位计数器 用于定位失败时累计次数 超过3次后不再继续,抛出定位失败错误 getPositionCount = 0 // 对外暴露的获取位置接口 getLocation () { return new Promise((resolve, reject) => { // 定位成功回调 this.getTMapLocation(resolve, reject) }) } // 调用腾讯地图获取位置 getTMapLocation (success, fail) { const _self = this // 定位成功回调 const showPosition = position => { uni.setStorage({ key: 'positionData', data: position }) success(position) } // 定位失败回调 const showErr = (err) => // 如果获取定位失败超过3次 抛出错误 否则继续获取定位信息 if (this.getPositionCount > 3) { fail('超过3次 获取定位失败') } else { // 定位失败递归 _self.getPositionCount = _self.getPositionCount + 1 _self.getTMapLocation(success, fail) } } // 调用腾讯web定位组件获取位置信息 if (geolocation) { geolocation.getIpLocation(showPosition, showErr, { timeout: 6000, // 定位超时时长 单位ms failTipFlag: true }) } } } export default new TMap()
2. 在微信 webview 中, 通过微信sdk获取位置信息
2.1 微信 js-sdk 相关的准备工作
2.1.1 引入js文件
/** * 微信sdk异步加载 * @param {*} src * @param {*} callback api接口 */ export const handlerLoadScript = callback => { const src = `https://res.wx.qq.com/open/js/jweixin-1.4.0.js` if (!(typeof callback === 'function')) { callback = function() {} } var check = document.querySelectorAll(`script[src="${src}"]`) if (check.length > 0) { check[0].addEventListener('load', function() { callback() }) callback() return } var script = document.createElement('script') var head = document.getElementsByTagName('head')[0] script.type = 'text/javascript' script.charset = 'UTF-8' script.src = src if (script.addEventListener) { script.addEventListener( 'load', function() { callback() }, false ) } else if (script.attachEvent) { script.attachEvent('onreadystatechange', function() { var target = window.event.srcElement if (target.readyState === 'loaded') { callback() } }) } head.appendChild(script) }
2.1.2 注入权限验证配置
所有需要使用JS-SDK的页面必须先注入配置信息,否则将无法调用。通常是通过后台接口获取配置信息。
/** * 注入权限验证配置 * @param {object} 微信 js-sdk 权限验证配置 */ export const wxconfigInfo = config => { wx.config({ debug: false, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。 appId: config.appId, timestamp: parseInt(config.timestamp), nonceStr: config.nonceStr, signature: config.signature, jsApiList: [ // 需要使用的 jsapi 列表 ..., 'getLocation' // 获取地理位置 ] }) }
2.2 调用 api 获取位置信息
/** * 微信获取位置 */ export const handleGetLocation = (config) => { return new Promise((resolve, reject)=>{ wxconfigInfo(config) wx.ready(function () { wx.getLocation({ type: 'wgs84', // 默认为wgs84的gps坐标,如果要返回直接给openLocation用的火星坐标,可传入'gcj02' success: function (res) { console.warn('微信sdk定位成功', res) resolve({ lat: res.latitude, // 纬度 lng: res.longitude, // 经度 speed: res.speed, // 速度,以米/每秒计 accuracy: res.accuracy // 位置精度 }) }, fail: function (err) { console.error('微信sdk定位失败', err) reject(err) } }) }) wx.error(function(err) { // config信息验证失败会执行error函数,如签名过期导致验证失败,具体错误信息可以打开config的debug模式查看,也可以在返回的res参数中查看,对于SPA可以在这里更新签名。 console.log('wxjsapi-error=', err) reject(`wxjsapi-error: ${err}`) }) })
2.3 根据不同运行环境调用不同的定位方法
// public.js /** * UA枚举 */ const UA = { /** * 微信h5 */ WECHAT: 'WECHAT', /** * 支付宝h5 */ ALIPAY: 'ALIPAY', /** * 其他 */ OTHERS: 'OTHERS' } /** * 判断客户端运行环境 这里只判断微信和浏览器h5 */ export const getUserAgent = () => { var userAgent = navigator.userAgent.toLowerCase() if (userAgent.match(/Alipay/i) == 'alipay') { return UA.ALIPAY } else if (userAgent.match(/MicroMessenger/i) == 'micromessenger') { return UA.WECHAT } else { return UA.OTHERS } }
// js-sdk.js /** * 唤起微信api * @param {*} _href 当前页面url * @param {*} options 分享信息 * @param {*} apiType 调用api类型 */ export const handleWXSDKCall = (_href, apiType, options) => { return new Promise((resolve, reject)=>{ // 通过后台接口获取配置信息 WeChatServivce.sign(_href) .then(res => { if (res) { if ( apiType === 'location' ) { handleGetLocation(res).then((res)=>{ resolve(res) }).catch(err=>{ reject(err) }) } } }) .catch(err => { reject(`err-sign: ${err}`) uni.showToast({ title: err.data.code + err.data.msg, mask: true, icon: 'none' }) }) }) }
// getLocation.js import { getUserAgent, handlerLoadScript } from '@/module/utils' import { handleWXSDKCall } from '@/module/utils/wechat/wxJsApiSdk' import UA from '@/module/enums/userAgent' import TMap from '@/module/utils/tMap' /** * 对外暴露的获取位置方法 * @return Promise resolve一个 positionData 对象 lat-纬度 lng-经度 */ const getLocation = () => { return new Promise((resolve, reject) => { console.log('进入全局获取用户位置方法') const storageData = uni.getStorageSync('positionData') const userAgent = getUserAgent() if (storageData) { resolve(storageData) } else { // 根据环境判断 如果在微信内使用微信sdk 其他使用腾讯地图定位组件 if (userAgent === UA.WECHAT) { handlerLoadScript(() => { handleWXSDKCall(window.location.href, 'location').then((res) => { uni.setStorageSync('positionData', res) resolve(res) }).catch(err => { reject(err) }) }) } else { TMap.getLocation().then(res => { uni.setStorageSync('positionData', res) resolve(res) }).catch((err) => { reject(err) }) } } }) } export default getLocation
3. 页面调用
3.1 绑定方法到 Vue 原型上
import getLocation from '@/module/utils/getLocation' Vue.prototype.$getLocation = getLocation
3.2 在页面组件中调用
onShow() { // 获取位置信息后请求后台接口 this.$getLocation() .then(res => { console.warn('首页获取位置成功', res) this.latitude = res.lat this.longitude = res.lng // 这里根据获取到的经纬度请求后台接口... }) .catch(err => { console.error('首页获取位置失败', err) // 错误处理 }) }
总结
遇到的坑以及需要注意的点:
使用微信sdk获取位置信息需要按顺序完成以下步骤:
- 异步加载微信sdk
- 通过接口获取配置信息,配置微信sdk
- 在wx.ready回调中调用方法
必须严格按顺序完成以上的三个步骤,否则是无法调用微信sdk的功能的。
总之,通过这篇文章,可以解决 H5 定位 99% 以上的应用场景。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持开心学习网。
- position零基础入门(position:sticky 粘性定位的几种巧妙应用详解)
- css position详解(深究CSS定位position的常用技法)
- html5定位地理位置(html5 制作地图当前定位箭头的方法示例)
- cssfloat和position功能(理解CSS浮动float、定位position)
- css基线实例详解(移动端使用 rem 单位时 css sprites 定位问题的解决)
- html锚点定位
- html5功能讲解(Html5定位终极解决方案)
- mysql字符串截取字段(MySQL如何从不固定位置提取字符串元素详解)
- pythonselenium查看当前页面元素(python+selenium 定位到元素,无法点击的解决方法)
- css浮动位置讲解(深入理解css布局之定位与浮动)
- 微信小程序实现自动定位(微信小程序实现锚点定位功能的方法实例)
- pythonselenium怎么设置元素(Python2 Selenium元素定位的实现8种)
- sql性能优化案例(SQL性能优化之定位网络性能问题的方法DEMO)
- 如何查看mysql慢查询日志(MySQL慢查询如何定位详解)
- css定位布局讲解(css position定位属性_动力节点Java学院整理)
- css有三种基本的定位机制(10个非常实用的CSS hack技术)
- 经度,世界时间腕表的灵魂(世界时间腕表的灵魂)
- 阿里最新财报公布 三季度营收增长3 ,将增加150亿美元回购额度 在美股价小涨(阿里最新财报公布)
- 赵薇时胖时瘦 最近变美少女 原因在这里 躺着就变瘦(赵薇时胖时瘦最近变美)
- 学会这26种姿势,你就可以和兵哥哥切磋了(你就可以和兵哥哥切磋了)
- 吴彦祖陈冠希 恩怨 ,失去曾让他流泪的女友,终遇走过18年真爱(吴彦祖陈冠希恩怨)
- 痴情男神 吴彦祖 与妻子恋爱8年,结婚10年,家庭幸福美满(痴情男神吴彦祖)
热门推荐
- python socket 库(Pythony运维入门之Socket网络编程详解)
- iisweb服务器的启动与配置(win7 iis配置怎么配置 Win7配置IIS服务器图文教程)
- 优化网站的速度的方法
- 运维堡垒机怎么搭建(堡塔云控平台添加服务器受控端图文教程)
- Sql Server锁的粒度
- docker快速入门和安装(docker安装tomcat8的实现方法)
- mysql出现锁表的原因(导致MySQL做全表扫描的几种情况)
- win7安装安卓模拟器(腾讯云服务器怎么安装安卓模拟器 可以安装安卓模拟器吗)
- docker镜像简介(详解使用阿里云镜像仓库构建国外Docker镜像)
- 网站服务器需要买哪些设备(选择网站服务器需要注意哪些地方?)
排行榜
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9