Html5定位终极解决方案


Posted in HTML / CSS onFebruary 05, 2020

背景

到新公司的第二个项目,就是和小伙伴们一起做一个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% 以上的应用场景。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

HTML / CSS 相关文章推荐
css3实现小箭头各种图形效果
Jul 08 HTML / CSS
一篇文章带你学习CSS3图片边框
Nov 04 HTML / CSS
html5+css3之制作header实例与更新
Dec 21 HTML / CSS
html5 学习简单的拾色器
Sep 03 HTML / CSS
使用HTML5的表单验证的简单示例
Sep 09 HTML / CSS
深入解析HTML5的IndexedDB索引数据库
Sep 14 HTML / CSS
canvas与html5实现视频截图功能示例
Dec 15 HTML / CSS
使用spring mvc+localResizeIMG实现HTML5端图片压缩上传的功能
Dec 16 HTML / CSS
HTML5新标签兼容——&gt; 的两种方法
Sep 12 HTML / CSS
html5 http的轮询和Websocket原理
Oct 19 HTML / CSS
canvas实现手机的手势解锁的步骤详细
Mar 16 HTML / CSS
CSS实现背景图片全屏铺满自适应的3种方式
Jul 07 HTML / CSS
canvas简单连线动画的实现代码
Feb 04 #HTML / CSS
html5手机键盘弹出收起的处理
Jan 20 #HTML / CSS
canvas实现烟花的示例代码
Jan 16 #HTML / CSS
使用iframe+postMessage实现页面跨域通信的示例代码
Jan 14 #HTML / CSS
Html5跳转到APP指定页面的实现
Jan 14 #HTML / CSS
html5自动播放mov格式视频的实例代码
Jan 14 #HTML / CSS
html5响应式开发自动计算fontSize的方法
Jan 13 #HTML / CSS
You might like
IIS6+PHP5+MySQL5+Zend Optimizer+phpMyAdmin安装配置图文教程 2009年
2009/06/08 PHP
Linux环境下搭建php开发环境的操作步骤
2013/06/17 PHP
php计算整个mysql数据库大小的方法
2015/06/19 PHP
php实现模拟post请求用法实例
2015/07/11 PHP
PHP编程实现脚本异步执行的方法
2017/08/09 PHP
简单介绍JavaScript中字符串创建的基本方法
2015/07/07 Javascript
js获取本机操作系统类型的两种方法
2015/12/19 Javascript
angular2使用简单介绍
2016/03/01 Javascript
【经验总结】编写JavaScript代码时应遵循的14条规律
2016/06/20 Javascript
浅析jQuery Ajax通用js封装
2016/06/22 Javascript
借助node实战JSONP跨域实例
2017/03/30 Javascript
JavaScript生成一个不重复的ID的方法示例
2019/09/16 Javascript
对vuex中store和$store的区别说明
2020/07/24 Javascript
[02:15]2014DOTA2国际邀请赛 赛后退役选手回顾
2014/08/01 DOTA
[08:40]Navi Vs Newbee
2018/06/07 DOTA
将图片文件嵌入到wxpython代码中的实现方法
2014/08/11 Python
Python实现各种排序算法的代码示例总结
2015/12/11 Python
深入理解Python中的内置常量
2017/05/20 Python
Python中函数eval和ast.literal_eval的区别详解
2017/08/10 Python
浅谈Python中的异常和JSON读写数据的实现
2020/02/27 Python
JetBrains PyCharm(Community版本)的下载、安装和初步使用图文教程详解
2020/03/19 Python
Python 添加文件注释和函数注释操作
2020/08/09 Python
Python为何不支持switch语句原理详解
2020/10/21 Python
python os.rename实例用法详解
2020/12/06 Python
css3 按钮 利用css3实现超酷下载按钮
2013/03/18 HTML / CSS
西班牙灯具网上商店:Lampara.es
2018/06/05 全球购物
艺龙旅行网酒店预订:国内、港澳台酒店
2018/06/26 全球购物
致跳高运动员广播稿
2014/01/13 职场文书
党员干部三严三实心得体会
2014/10/13 职场文书
信用卡工资证明范本
2014/10/17 职场文书
企业群众路线教育实践活动心得体会
2014/11/03 职场文书
2015大学生党员自我评价范文
2015/03/03 职场文书
餐厅保洁员岗位职责
2015/04/10 职场文书
Java 垃圾回收超详细讲解记忆集和卡表
2022/04/08 Java/Android
使用CSS实现黑白格背景效果
2022/06/01 HTML / CSS
使用JS前端技术实现静态图片局部流动效果
2022/08/05 Javascript