前端获取用户地理定位的几种方式(Geolocation API,微信,腾讯地图)

2024-03-27前端7 分钟2,250 次阅读
AI 摘要salmon-ai

本文详细解析了前端获取用户地理定位的几种常见方式,包括 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 度

效果如下:
image.png
使用上面的代码,浏览器将会询问您是否透露自己的地理位置信息。

注意:只能在 HTTPS 中获取到该值,你可以在有 HTTPS 的网站,打开控制台进行测试,测试完后马上关闭。

image.png

以上警告是在不安全的 HTTP 下运行该语句的情况。

如果使用的是谷歌,可以在设置的隐私设置和安全性管理网站授予地理位置的情况。
image.png

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('定位失败,请在微信中打开');
            }
        })
    }

三、第三方服务(腾讯地图服务)

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 //误差范围,以米为单位
}
觉得有用就点个赞,不用登录也能读

评论

0 条
登录 之后才能评论
—
还没有评论,来说第一句