App下載

對(duì)于Html5中定位問(wèn)題解決方法總結(jié)!!干貨分享!

自我否定先驅(qū)者 2021-08-11 18:28:09 瀏覽數(shù) (2009)
反饋

今天和大家分享有關(guān)于:“對(duì)于Html5中定位問(wèn)題解決方法總結(jié)?。「韶浄窒?!”這個(gè)方面的相關(guān)內(nèi)容,希望對(duì)大家有所幫互助!

目標(biāo)與分析

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

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

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

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

解決方案

Talk is cheap, show me the code. 廢話不多說(shuō),直接上代碼:

1. 在瀏覽器中,通過(guò)騰訊地圖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>

說(shuō)明:

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

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

為了方便復(fù)用,我們單獨(dú)封裝一個(gè)騰訊地圖 jsapi 的類(lèi),命名為 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 {
  // 獲取定位計(jì)數(shù)器 用于定位失敗時(shí)累計(jì)次數(shù) 超過(guò)3次后不再繼續(xù),拋出定位失敗錯(cuò)誤
  getPositionCount = 0

  // 對(duì)外暴露的獲取位置接口
  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) => 
      // 如果獲取定位失敗超過(guò)3次 拋出錯(cuò)誤 否則繼續(xù)獲取定位信息
      if (this.getPositionCount > 3) {
        fail('超過(guò)3次 獲取定位失敗')
      } else {
        // 定位失敗遞歸
        _self.getPositionCount = _self.getPositionCount + 1
        _self.getTMapLocation(success, fail)
      }
    }

    // 調(diào)用騰訊web定位組件獲取位置信息
    if (geolocation) {
      geolocation.getIpLocation(showPosition, showErr, {
        timeout: 6000,  // 定位超時(shí)時(shí)長(zhǎng) 單位ms
        failTipFlag: true
      })
    }
  }
}

export default new TMap()

2. 在微信 webview 中, 通過(guò)微信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的頁(yè)面必須先注入配置信息,否則將無(wú)法調(diào)用。通常是通過(guò)后臺(tái)接口獲取配置信息。

/**
 * 注入權(quán)限驗(yàn)證配置
 * @param {object} 微信 js-sdk 權(quán)限驗(yàn)證配置
 */
export const wxconfigInfo = config => {
  wx.config({
    debug: false, // 開(kāi)啟調(diào)試模式,調(diào)用的所有api的返回值會(huì)在客戶端alert出來(lái),若要查看傳入的參數(shù),可以在pc端打開(kāi),參數(shù)信息會(huì)通過(guò)log打出,僅在pc端時(shí)才會(huì)打印。
    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)證失敗會(huì)執(zhí)行error函數(shù),如簽名過(guò)期導(dǎo)致驗(yàn)證失敗,具體錯(cuò)誤信息可以打開(kāi)config的debug模式查看,也可以在返回的res參數(shù)中查看,對(duì)于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)前頁(yè)面url
 * @param {*} options 分享信息
 * @param {*} apiType 調(diào)用api類(lèi)型
 */
export const handleWXSDKCall = (_href, apiType, options) => {
  return new Promise((resolve, reject)=>{
    // 通過(guò)后臺(tái)接口獲取配置信息
    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'

/**
 * 對(duì)外暴露的獲取位置方法
 * @return Promise resolve一個(gè) positionData 對(duì)象 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. 頁(yè)面調(diào)用

3.1 綁定方法到 Vue 原型上:

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

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

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

總結(jié)

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

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

  • 異步加載微信sdk
  • 通過(guò)接口獲取配置信息,配置微信sdk
  • 在wx.ready回調(diào)中調(diào)用方法

必須嚴(yán)格按順序完成以上的三個(gè)步驟,否則是無(wú)法調(diào)用微信sdk的功能的。

總之,通過(guò)這篇文章,可以解決 H5 定位 99% 以上的應(yīng)用場(chǎng)景。

那么以上小編關(guān)于“對(duì)于Html5中定位問(wèn)題解決方法總結(jié)??!干貨分享!”這個(gè)方面的內(nèi)容分享就到這邊了,更多有關(guān)于html5這方面的相關(guān)內(nèi)容我們都可以在 W3Cschool中進(jìn)行學(xué)習(xí)。


0 人點(diǎn)贊