背景
到新公司的第二個(gè)項(xiàng)目,就是和小伙伴們一起做一個(gè)H5的商城,主要在微信內(nèi),但也要考慮到其他瀏覽器。其中,首頁需要根據(jù)當(dāng)前用戶的經(jīng)緯度找到距離最近的門店并展示。前端需要做的工作就是獲取用戶的經(jīng)緯度然后查詢后臺(tái)接口并渲染頁面。
目標(biāo)與分析
我們的目標(biāo)是經(jīng)過封裝之后,只需要調(diào)用一個(gè)方法就可以拿到返回的位置信息。
我們需要做的事情是,針對(duì)不同的端(微信H5和其他瀏覽器環(huán)境)封裝不同的類,再通過一個(gè)方法通過 UA 區(qū)分,調(diào)用不同環(huán)境對(duì)應(yīng)的類獲取位置。
在微信內(nèi)部,經(jīng)過反復(fù)的實(shí)踐之后,不論是通過原生的 HTML5 定位,還是通過第三方(如百度或騰訊地圖) jsapi 獲取位置,不僅定位時(shí)間長,甚至經(jīng)常出現(xiàn)定位失敗的情況,嚴(yán)重影響用戶體驗(yàn),尤其對(duì)于大部分信息流都依賴于用于位置的商城首頁來說,是完全無法接受的。所以在微信內(nèi)我們只有微信 sdk 這一種選擇;
而對(duì)于瀏覽器端,通過第三方的地圖 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, 需要先去騰訊地圖開放平臺(tái)申請(qǐng)自己的賬號(hào),然后創(chuàng)建自己的應(yīng)用,將騰訊地圖key 和創(chuàng)建的應(yīng)用名稱替換上面的值。
1.2 調(diào)用獲取位置接口,獲取位置信息
為了方便復(fù)用,我們單獨(dú)封裝一個(gè)騰訊地圖 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 {
// 獲取定位計(jì)數(shù)器 用于定位失敗時(shí)累計(jì)次數(shù) 超過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) =>
// 如果獲取定位失敗超過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)用。通常是通過后臺(tái)接口獲取配置信息。
/**
* 注入權(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的返回值會(huì)在客戶端alert出來,若要查看傳入的參數(shù),可以在pc端打開,參數(shù)信息會(huì)通過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ù),如簽名過期導(dǎo)致驗(yàn)證失敗,具體錯(cuò)誤信息可以打開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)前頁面url
* @param {*} options 分享信息
* @param {*} apiType 調(diào)用api類型
*/
export const handleWXSDKCall = (_href, apiType, options) => {
return new Promise((resolve, reject)=>{
// 通過后臺(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. 頁面調(diào)用
3.1 綁定方法到 Vue 原型上
import getLocation from '@/module/utils/getLocation'
Vue.prototype.$getLocation = getLocation
3.2 在頁面組件中調(diào)用
onShow() {
// 獲取位置信息后請(qǐng)求后臺(tái)接口
this.$getLocation()
.then(res => {
console.warn('首頁獲取位置成功', res)
this.latitude = res.lat
this.longitude = res.lng
// 這里根據(jù)獲取到的經(jīng)緯度請(qǐng)求后臺(tái)接口...
})
.catch(err => {
console.error('首頁獲取位置失敗', err)
// 錯(cuò)誤處理
})
}
總結(jié)
遇到的坑以及需要注意的點(diǎn):
使用微信sdk獲取位置信息需要按順序完成以下步驟:
- 異步加載微信sdk
- 通過接口獲取配置信息,配置微信sdk
- 在wx.ready回調(diào)中調(diào)用方法
必須嚴(yán)格按順序完成以上的三個(gè)步驟,否則是無法調(diào)用微信sdk的功能的。
總之,通過這篇文章,可以解決 H5 定位 99% 以上的應(yīng)用場景。
以上就是本文的全部內(nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。