Html5定位終極解決方案

2024-09-05 07:23:15

字體：大中小

供稿：網(wǎng)友

背景

到新公司的第二個(gè)項(xiàng)目，就是和小伙伴們一起做一個(gè)H5的商城，主要在微信內(nèi)，但也要考慮到其他瀏覽器。其中，首頁需要根據(jù)當(dāng)前用戶的經(jīng)緯度找到距離最近的門店并展示。前端需要做的工作就是獲取用戶的經(jīng)緯度然后查詢后臺接口并渲染頁面。

目標(biāo)與分析

我們的目標(biāo)是經(jīng)過封裝之后，只需要調(diào)用一個(gè)方法就可以拿到返回的位置信息。

我們需要做的事情是，針對不同的端（微信H5和其他瀏覽器環(huán)境）封裝不同的類，再通過一個(gè)方法通過 UA 區(qū)分，調(diào)用不同環(huán)境對應(yīng)的類獲取位置。

在微信內(nèi)部，經(jīng)過反復(fù)的實(shí)踐之后，不論是通過原生的 HTML5 定位，還是通過第三方(如百度或騰訊地圖) jsapi 獲取位置，不僅定位時(shí)間長，甚至經(jīng)常出現(xiàn)定位失敗的情況，嚴(yán)重影響用戶體驗(yàn)，尤其對于大部分信息流都依賴于用于位置的商城首頁來說，是完全無法接受的。所以在微信內(nèi)我們只有微信 sdk 這一種選擇；

而對于瀏覽器端，通過第三方的地圖 jsapi 或定位組件，可以穩(wěn)定且較快速地獲取位置信息，為了與微信內(nèi)盡量保持一致，我們選擇的是騰訊地圖 jsapi。

解決方案

Talk is cheap, show me the code. 廢話不多說，直接上代碼：

1. 在瀏覽器中，通過騰訊地圖jsapi獲取位置

1.1 在項(xiàng)目的 html 模版文件中引入騰訊地圖 jsapi

<!-- index.html --><script charset="utf-8" src="https://map.qq.com/api/js?v=2.exp&key=騰訊地圖key&referer=應(yīng)用名稱"></script>

說明：

使用騰訊地圖 jsapi, 需要先去騰訊地圖開放平臺申請自己的賬號，然后創(chuàng)建自己的應(yīng)用，將騰訊地圖key 和創(chuàng)建的應(yīng)用名稱替換上面的值。

1.2 調(diào)用獲取位置接口，獲取位置信息

為了方便復(fù)用，我們單獨(dú)封裝一個(gè)騰訊地圖 jsapi 的類，命名為 tMap.js

// tMap.jsconst qq = window.qqvar geolocation = nullif (qq && qq.maps) {  // 初始化定位組件  geolocation = new qq.maps.Geolocation(    'QVLBZ-YUULR-OUMW7-WKXFD-4SUWS-UDBIA',    'mymap'  )}class TMap {  // 獲取定位計(jì)數(shù)器 用于定位失敗時(shí)累計(jì)次數(shù) 超過3次后不再繼續(xù)，拋出定位失敗錯(cuò)誤  getPositionCount = 0  // 對外暴露的獲取位置接口  getLocation () {    return new Promise((resolve, reject) => {      // 定位成功回調(diào)      this.getTMapLocation(resolve, reject)    })  }  // 調(diào)用騰訊地圖獲取位置  getTMapLocation (success, fail) {    const _self = this    // 定位成功回調(diào)    const showPosition = position => {      uni.setStorage({        key: 'positionData',        data: position      })      success(position)    }    // 定位失敗回調(diào)    const showErr = (err) =>       // 如果獲取定位失敗超過3次 拋出錯(cuò)誤 否則繼續(xù)獲取定位信息      if (this.getPositionCount > 3) {        fail('超過3次 獲取定位失敗')      } else {        // 定位失敗遞歸        _self.getPositionCount = _self.getPositionCount + 1        _self.getTMapLocation(success, fail)      }    }    // 調(diào)用騰訊web定位組件獲取位置信息    if (geolocation) {      geolocation.getIpLocation(showPosition, showErr, {        timeout: 6000,  // 定位超時(shí)時(shí)長 單位ms        failTipFlag: true      })    }  }}export default new TMap()

2. 在微信 webview 中, 通過微信sdk獲取位置信息

2.1 微信 js-sdk 相關(guān)的準(zhǔn)備工作
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 注入權(quán)限驗(yàn)證配置
所有需要使用JS-SDK的頁面必須先注入配置信息，否則將無法調(diào)用。通常是通過后臺接口獲取配置信息。

/** * 注入權(quán)限驗(yàn)證配置 * @param {object} 微信 js-sdk 權(quán)限驗(yàn)證配置 */export const wxconfigInfo = config => {  wx.config({    debug: false, // 開啟調(diào)試模式,調(diào)用的所有api的返回值會在客戶端alert出來，若要查看傳入的參數(shù)，可以在pc端打開，參數(shù)信息會通過log打出，僅在pc端時(shí)才會打印。    appId: config.appId,    timestamp: parseInt(config.timestamp),    nonceStr: config.nonceStr,    signature: config.signature,    jsApiList: [   // 需要使用的 jsapi 列表      ...,      'getLocation'  // 獲取地理位置    ]  })}

2.2 調(diào)用 api 獲取位置信息

 /** * 微信獲取位置 */export const handleGetLocation = (config) => {  return new Promise((resolve, reject)=>{    wxconfigInfo(config)    wx.ready(function () {      wx.getLocation({        type: 'wgs84', // 默認(rèn)為wgs84的gps坐標(biāo)，如果要返回直接給openLocation用的火星坐標(biāo)，可傳入'gcj02'        success: function (res) {          console.warn('微信sdk定位成功', res)          resolve({            lat: res.latitude, // 緯度            lng: res.longitude, // 經(jīng)度            speed: res.speed, // 速度，以米/每秒計(jì)            accuracy: res.accuracy // 位置精度          })        },        fail: function (err) {          console.error('微信sdk定位失敗', err)          reject(err)        }      })    })    wx.error(function(err) {      // config信息驗(yàn)證失敗會執(zhí)行error函數(shù)，如簽名過期導(dǎo)致驗(yàn)證失敗，具體錯(cuò)誤信息可以打開config的debug模式查看，也可以在返回的res參數(shù)中查看，對于SPA可以在這里更新簽名。      console.log('wxjsapi-error=', err)      reject(`wxjsapi-error: ${err}`)    })  })

2.3 根據(jù)不同運(yùn)行環(huán)境調(diào)用不同的定位方法

// public.js/** * UA枚舉 */const UA = {  /**   * 微信h5   */  WECHAT: 'WECHAT',  /**   * 支付寶h5   */  ALIPAY: 'ALIPAY',  /**   * 其他   */  OTHERS: 'OTHERS'}/** * 判斷客戶端運(yùn)行環(huán)境 這里只判斷微信和瀏覽器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 當(dāng)前頁面url * @param {*} options 分享信息 * @param {*} apiType 調(diào)用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.jsimport { 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一個(gè) positionData 對象 lat-緯度 lng-經(jīng)度 */const getLocation = () => {  return new Promise((resolve, reject) => {    console.log('進(jìn)入全局獲取用戶位置方法')    const storageData = uni.getStorageSync('positionData')    const userAgent = getUserAgent()    if (storageData) {      resolve(storageData)    } else {      // 根據(jù)環(huán)境判斷 如果在微信內(nèi)使用微信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. 頁面調(diào)用

3.1 綁定方法到 Vue 原型上

import getLocation from '@/module/utils/getLocation'Vue.prototype.$getLocation = getLocation

3.2 在頁面組件中調(diào)用

onShow() {  // 獲取位置信息后請求后臺接口  this.$getLocation()    .then(res => {      console.warn('首頁獲取位置成功', res)      this.latitude = res.lat      this.longitude = res.lng      // 這里根據(jù)獲取到的經(jīng)緯度請求后臺接口...    })    .catch(err => {      console.error('首頁獲取位置失敗', err)      // 錯(cuò)誤處理    })}

總結(jié)

遇到的坑以及需要注意的點(diǎn)：

使用微信sdk獲取位置信息需要按順序完成以下步驟：