前端获取用户地理定位的几种方式(Geolocation API,微信,腾讯地图)
本文详细解析了前端获取用户地理定位的几种常见方式,包括 Ge
前言
前端获取用户地理定位一般分为两种场景:PC端 与 移动端。这两个场景有一些注意事项。
- 移动端
移动端包括手机,Pad 和其它带有GPS定位芯片的智能设备(如手表、音箱等),移动端的系统包括iOS和Android。成功完成定位需要达成以下前提条件:
- 系统GPS打开
- 所使用的App或浏览器已获取定位权限
- 对打开的页面允许使用定位
- 对于iOS10以上系统和Android的一些版本已禁止在非HTTPS协议的域名下定位,请尽快将站点升级到HTTPS
- PC端
因为PC设备上大多都缺少GPS芯片,所以在PC上的定位主要通过IP精准定位服务。
一、 Geolocation API
这是 HTML5 新推出的地理位置API,但从性能和精确度上来,都不理想。尤其PC端精确地非常低且经常获取失败。用者甚少。
1、简介
Geolocation API(地理定位 API)允许用户在需要时向 Web 应用程序提供用户的地理位置。出于隐私原因,用户需要获得报告位置信息的权限。
实际上 JavaScript 可以捕获你的经度和纬度,并可以发送到后端 Web 服务器,做一些奇特的位置感知的事情,比如
- 在地图上显示你的位置或标注一些信息
- watchPosition 方法可以用于路线导航
注意:地理位置功能涉及用户隐私,出于安全考虑,当一个 Web 页尝试获取地理位置信息时,会请求用户批准地理位置访问权限。用户可能会拒绝,浏览器将不会共享你的定位数据。另外,该 API 只能在 HTTPS 环境使用。
2、API介绍
浏览器通过 navigator.geolocation 属性提供该 API,该属性将返回一个 Geolocation 对象。该对象具有以下三个方法。
Geolocation.getCurrentPosition():返回一个 Position 对象,表示用户的当前位置。Geolocation.watchPosition():指定一个监听函数,每当用户的位置发生变化,就执行该监听函数。Geolocation.clearWatch():取消watchPosition()方法指定的监听函数。
下边介绍下这三个方法。
2.1、getCurrentPosition()
我们可以使用 navigator.geolocation.getCurrentPosition() 方法来获取用户的位置:
js
navigator.geolocation.getCurrentPosition(success, error, options)
该方法接受三个参数:
success—— 用户同意给出位置时的回调函数,它的参数是一个 Position 对象。error—— 用户拒绝给出位置时的回调函数,它的参数是一个 PositionError 对象。该参数可选。options—— 参数对象,该参数可选。
Position 对象有两个属性:
Position.coords—— 返回一个 Coordinates 对象,表示当前位置的坐标。Position.timestamp—— 返回一个对象,代表当前时间戳。
PositionError 对象主要有两个属性:
PositionError.code—— 整数,表示发生错误的原因。1表示无权限,有可能是用户拒绝授权;2表示无法获得位置,可能设备有故障;3表示超时。PositionError.message—— 字符串,表示错误的描述。
参数对象 option 可以指定三个属性:
enableHighAccuracy—— 是否返回高精度结果。如果设为true,可能导致响应时间变慢或(移动设备的)功耗增加;反之,如果设为false,设备可以更快速地响应。默认值为 false。timeout—— 正整数,表示等待查询的最长时间,单位为毫秒。默认值为Infinity。maximumAge—— 正整数,表示可接受的缓存最长时间,单位为毫秒。如果设为0,表示不返回缓存值,必须查询当前的实际位置;如果设为Infinity,必须返回缓存值,不管缓存了多少时间。默认值为0。
js
const options = {
enableHighAccuracy: true,
timeout: 5000,
maximumAge: 0
}
const success = pos => {
const crd = pos.coords
console.log(`经度:${crd.latitude} 度`)
console.log(`纬度:${crd.longitude} 度`)
console.log(`海拔:${crd.altitude} 米`)
console.log(`经度和纬度属性的精度:${crd.accuracy} 米`)
console.log(`海拔的精确度:${crd.altitudeAccuracy} 米`)
console.log(`设备的速度:${crd.speed} 米/秒`)
console.log(`设备运行的方向:${crd.heading} 度`)
}
const error = err => {
console.warn(`ERROR(${err.code}): ${err.message}`)
}
navigator.geolocation.getCurrentPosition(success, error, options)
// 经度: xxx 度
// 纬度: xxx 度
// 海拔:xxx 米
// 经度和纬度属性的精度:xxx 米
// 海拔的精确度:xxx 米
// 设备的速度:xxx 米/秒
// 设备运行的方向:xxx 度
效果如下:

使用上面的代码,浏览器将会询问您是否透露自己的地理位置信息。
注意:只能在 HTTPS 中获取到该值,你可以在有 HTTPS 的网站,打开控制台进行测试,测试完后马上关闭。

以上警告是在不安全的 HTTP 下运行该语句的情况。
如果使用的是谷歌,可以在设置的隐私设置和安全性管理网站授予地理位置的情况。

2.2、Coordinates 对象
上述获取用户位置的例子中,我们正是通过 Position.coords 属性来使用 Coordinates 对象,该坐标接口用于表示设备在地球上的位置和海拔,以及计算这些属性的精确度。
以下属性都返回浮点数,全部为只读属性:
Coordinates.latitude—— 表示纬度。Coordinates.longitude—— 表示经度。Coordinates.altitude—— 表示相对于海平面的位置海拔(单位:米)。如果实现无法提供数据,则此值可以为null。Coordinates.accuracy—— 表示经度和纬度属性的精度(单位:米)。Coordinates.altitudeAccuracy——表示海拔的精度(单位:米)。此值可以为null。Coordinates.speed—— 表示设备的速度(单位:米/秒)。此值可以为null。Coordinates.heading—— 表示设备运行的方向(单位:度)。表示设备离正北方向有多远。0 度表示正北,方向是顺时针方向确定的(这意味着东是 90 度,西是 270 度)。如果Coordinates.speed为 0,heading属性返回NaN。如果设备无法提供标题信息,则此值为null。
2.3、watchPosition()
Geolocation.watchPosition()对象指定一个监听函数,每当用户的位置发生变化,就是自动执行这个函数。
js
navigator.geolocation.watchPosition(success[, error[, options]])
该方法接受三个参数:
success—— 表示监听成功的回调函数,该函数可以传入一个 Position 对象作为参数。error—— 可选,表示监听失败的回调函数,该函数可以传入一个 PositionError 对象作为参数。options—— 可选,表示监听的参数配置对象。
该方法返回一个整数值,表示监听函数的编号。该整数用来供Geolocation.clearWatch()方法取消监听。
js
let target = {
latitude : 0,
longitude: 0
}
let options = {
enableHighAccuracy: false,
timeout: 5000,
maximumAge: 0
}
const success = pos => {
const crd = pos.coords
if (target.latitude === crd.latitude && target.longitude === crd.longitude) {
console.log('Congratulation, you reach the target')
navigator.geolocation.clearWatch(id)
}
}
const error = err => {
console.warn('ERROR(' + err.code + '): ' + err.message)
}
const id = navigator.geolocation.watchPosition(success, error, options)
2.4、clearWatch()
Geolocation.clearWatch() 方法用来取消 Geolocation.watchPosition() 方法指定的监听函数。
js
navigator.geolocation.clearWatch(id)
该参数由 Geolocation.watchPosition() 返回的监听函数的编号获得。
二、微信 SDK
这种适用于在微信H5场景应用(比如公众号H5),只能在微信浏览器内使用微信的SDK。
1、引入js sdk
js
script src="https://res.wx.qq.com/open/js/jweixin-1.2.0.js"></script>
2、获取签名,注入配置
所有需要使用JS-SDK的页面必须先注入配置信息,否则将无法调用。从后台获取配置信息,拿到appId、timestamp、nonceStr、signature,通过wx.config注入配置信息
js
$http({
method: 'GET',
url: '/wechat/ticket/V3' + '?url=' + encodeURIComponent(location.href),
}).then(
function successCallback (sign) {
wx.config({
debug: false,
appId: sign.appId, // 必填,公众号的唯一标识
timestamp: sign.timestamp, // 必填,生成签名的时间戳
nonceStr: sign.nonceStr, // 必填,生成签名的随机串
signature: sign.signature, // 必填,签名,见附录1
jsApiList: [
...,
'getLocation',
'openLocation',
]
});
},
function errorCallback (response) {
console.info(response)
}
);
3. 调用JS-SDK api 获取位置
js
// 获取用户定位
function getLocation() {
return new Promise(function (resolve,reject) {
if (browser.versions.weixin) {
wx.ready(function () {
wx.getLocation({
type: 'gcj02', // 默认为wgs84的gps坐标,如果要返回直接给openLocation用的火星坐标,可传入'gcj02'
success: function (res) {
resolve({
latitude: res.latitude,
longitude: res.longitude,
speed: res.speed, // 速度,以米/每秒计
accuracy: res.accuracy // 位置精度
});
},
cancel: function () {
reject('定位失败,请重新获取并允许定位');
},
fail: function () {
reject('定位失败,请检查您设备权限后重新尝试');
}
});
});
wx.error(function(err) {
// config信息验证失败会执行error函数,如签名过期导致验证失败,具体错误信息可以打开config的debug模式查看,也可以在返回的res参数中查看,对于SPA可以在这里更新签名。
reject(`wxjsapi-error: ${err}`)
})
} else {
reject('定位失败,请在微信中打开');
}
})
}
三、第三方服务(腾讯地图服务)
- 在使用该服务前需要申请个人开发秘钥:https://lbs.qq.com/dev/console/key/manage
- 前端定位组件:https://lbs.qq.com/webApi/component/componentGuide/componentGeolocation
1、引入 JavaScript 文件
引入封装好的 JavaScript 文件,通过调用JavaScript API的接口获取定位信息
js引入地址:https://apis.map.qq.com/tools/geolocation/min?key=yourkey&referer=myapp
key : 必填,开发密钥(key)
js
function loadMap() {
var url = 'https://apis.map.qq.com/tools/geolocation/min?key=[your key]&referer=location&callback=initMap'; // 成功回调为initMap方法
var jsapi = document.createElement('script');
jsapi.charset = 'utf-8';
jsapi.src = url;
document.head.appendChild(jsapi);
}
2、获取定位
js
window.initMap = function () {
var geolocation = new qq.maps.Geolocation([your key]);
geolocation.getLocation(function success(position) {
$scope.position = position;
}, function error(result) {
console.log('获取定位失败', JSON.stringify(result));
}, {
timeout: 15000, // 默认值为10s;
failTipFlag: true
});
}
定位成功返回结果:
json
{ "module":"geolocation",
"nation": "中国",
"province": "广东省",
"city":"深圳市",
"district":"南山区",
"adcode":"440305", //行政区ID,六位数字, 前两位是省,中间是市,后面两位是区,比如深圳市ID为440300
"addr":"深圳大学杜鹃山(白石路北250米)",
"lat":22.530001, //火星坐标(gcj02),腾讯、Google、高德通用
"lng":113.935364,
"accuracy":13 //误差范围,以米为单位
}