使用HTML5地理位置定位到城市的方法及注意事项

介绍

本文将简述一下如何通过HTML5和百度地图开放平台提供的API来实现对浏览器的定位,同时记录了遇到的问题和解决方案。实现效果为显示出用户所在的省市,即: XXX省 XXX市。

实现思路

利用HTML5 提供的API获取到用户的经纬度信息,再将用户的经纬度信息传到百度地图开放平台,百度地图开放平台根据提供的坐标信息返回当前的省市。

兼容性及依赖

兼容性:Internet Explorer 9+, Firefox, Chrome, Safari 和 Opera 都支持Geolocation(地理定位).

依赖:不依赖于任何库和框架

HTML5 API

使用HTML5 Geolocation API的getCurrentPosition() 方法能够获取用户的经纬度信息。

getCurrentPosition() 常用参数有两个,一个是成功时执行,一个时错误处理。如果getCurrentPosition()运行成功,则向第一个参数中规定的函数返回一个coordinates对象,用于提供位置信息。

coordinates对象属性如下:

属性 描述
coords.latitude 十进制数的纬度
coords.longitude 十进制数的经度
coords.accuracy 位置精度
coords.altitude 海拔,海平面以上以米计
coords.altitudeAccuracy 位置的海拔精度
coords.heading 方向,从正北开始以度计
coords.speed 速度,以米/每秒计
timestamp 响应的日期/时间

其中,latitude、longitude 以及 accuracy 属性 是固定返回的属性,其他属性在可用状态下才会一起返回。

如果getCurrentPosition()运行失败,则向第二个参数中规定的函数返回一个error对象,用于提供错误信息。

属性 描述
code 1: PERMISSION_DENIED,用户不允许地理定位
2: POSITION_UNAVAILABLE,无法获取当前位置
3:TIMEOUT,操作超时
message 返回相应的错误信息

下例是一个简单的地理定位实例,可返回用户位置的经度和纬度:

function getLocation()
{
if (navigator.geolocation)
{
navigator.geolocation.getCurrentPosition(showPosition, showError);
}
else
{
console.log("该浏览器不支持获取地理位置。");
}
} function showPosition(position)
{
console.log("纬度: " + position.coords.latitude +
" 经度: " + position.coords.longitude);
} function showError(error) {
console.log(error);
}

参考资料:

菜鸟教程

百度地图API

命名空间

百度地图API使用BMap作为命名空间,所有类均在该命名空间之下,比如:BMap.Map、BMap.Control、BMap.Overlay。

使用方法

首先,我们需要引入百度地图API文件:

<script src="http://api.map.baidu.com/api?v=1.4"></script> //参数v表示您加载API的版本,使用JavaScript APIv1.4及以前版本可使用此方式引用。

<script src="http://api.map.baidu.com/api?v=2.0&ak=您的密钥"></script> //使用JavaScript APIv2.0请先申请密钥ak,按此方式引用。

然后,我们再创建一个地理点坐标:

var point = new BMap.Point(116.404, 39.915);

构造函数 描述
Point(lng: Number, lat: Number) 以指定的经度和纬度创建一个地理点坐标

最后,我们可以通过创建好的点坐标获取到用户的地址解析:

var myGeo = new BMap.Geocoder();
myGeo.getLocation(point, function (result) {
console.log(result.addressComponents.province + ' ' + result.addressComponents.city);
}
构造函数 描述
Geocoder() 创建一个地址解析器的实例
方法 返回值 描述
getPoint(address: String, callback: Function, city: String) none 对指定的地址进行解析。如果地址定位成功,则以地址所在的坐标点Point为参数调用回调函数。否则,回调函数的参数为null。city为地址所在的城市名,例如“北京市”
getLocation(point: Point, callback: Function, options: LocationOptions) none 对指定的坐标点进行反地址解析。如果解析成功,则回调函数的参数为GeocoderResult对象,否则回调函数的参数为null

参考资料:

  1. 百度地图 JavaScript API

  2. 百度地图 JavaScript API起步

  3. 百度地图 JavaScript API类参考

完整代码示例

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>Document</title>
</head>
<body>
<p id="test"></p>
</body>
<script src="https://api.map.baidu.com/api?v=2.0&ak=您的密钥" type="text/javascript"></script>
<script>
function getLocation()
{
if (navigator.geolocation)
{
navigator.geolocation.getCurrentPosition(showPosition, showError);
}
else
{
console.log("该浏览器不支持获取地理位置。");
}
} function showPosition(position)
{
var point = new BMap.Point(position.coords.longitude, position.coords.latitude);
var myGeo = new BMap.Geocoder();
myGeo.getLocation(point, function (result) {
alert(result.addressComponents.province + ' ' + result.addressComponents.city);
})
} function showError(error) {
console.log(error);
}
getLocation();
</script>
</html>

浏览器安全机制

按照上面的步骤去做,理论上是可以实现我们的功能。但事实并非如此,不信你可以起个服务验证一下看看。

通过验证,你会发现在Chrome 浏览器中使用http://localhost:8080 或者 http://127.0.0.1:8080 可以正常获取到浏览器的地理位置,但通过IP或者域名的形式,如:http://172.21.3.82:8080http://b.cunzhang.com进行访问时却获取不到。

为什么呢?打开控制台,你会发现有以下错误信息:

Only secure origins are allowed (see: https://goo.gl/Y0ZkNV).

“只有在安全来源的情况才才被允许”。错误信息里还包含了一个提示链接,我们不妨打开这个链接(https://goo.gl/Y0ZkNV)看看。原来,为了保障用户的安全,Chrome浏览器认为只有安全的来源才能开启定位服务。那什么样才算是安全的来源呢?在打开链接的页面上有这么一段话:

“Secure origins” are origins that match at least one of the following (scheme, host, port) patterns:

  • (https, *, *)
  • (wss, *, *)
  • (*, localhost, *)
  • (*, 127/8, *)
  • (*, ::1/128, *)
  • (file, *, —)
  • (chrome-extension, *, —)

This list may be incomplete, and may need to be changed. Please discuss!

大概意思是说只有包含上述列表中的schemehost或者port才会被认为是安全的来源,现在这个列表还不够完整,后续可能还会有变动,有待讨论。

这就可以解释了为什么在http://localhost:8080http://127.0.0.1:8080访问下可以获取到浏览器的地理位置,而在http://172.21.3.82:8080http://b.cunzhang.com 确获取不到了。如果需要在域名访问的基础上实现地位位置的定位,那我们只能把http协议升级为https了。

nginx搭建https服务

http升级为https要先获取一张证书。

证书是一个二进制文件,里面包含经过认证的网站公钥和一些元数据,要从经销商购买。由于我司已经升级到了https,就不需要我瞎折腾了,感兴趣的可以参考阮一峰老师的这篇文章《HTTPS 升级指南》。虽然我司对外开放的网站都已经全面升级为https,但是内网的测试环境还是没有升级到https,下面将简述一下如何通过nginx 来搭建一个https服务。

SSL 证书

要设置安全服务器,使用公共钥创建一对公私钥对。大多数情况下,发送证书请求(包括自己的公钥),你的公司证明材料以及费用到一个证书颁发机构(CA)。CA验证证书请求及您的身份,然后将证书返回给您的安全服务器。

但是内网实现一个服务器端和客户端传输内容的加密,可以自己给自己颁发证书,只需要忽略掉浏览器不信任的警报即可!

制作CA证书

XXXX.key CA私钥:

openssl genrsa -des3 -out XXXX.key 2048

XXXX.crt CA根证书(公钥):

openssl req -new -x509 -days 365 -key XXXX.key -out XXXX.crt

在配置你的公钥过程中会让你填写一些信息,这时候随便填一下就可以了。

虚拟主机配置文件

worker_processes  1;
events {
worker_connections 1024;
}
http {
include mime.types;
default_type application/octet-stream;
sendfile on;
keepalive_timeout 65;
upstream sslfpm {
server 127.0.0.1:9000 weight=10 max_fails=3 fail_timeout=20s;
}
server {
listen 443;
server_name b.cunzhang.com;
#为一个server开启ssl支持
ssl on;
#为虚拟主机指定pem格式的证书文件
ssl_certificate /etc/ssl/cunzhang_test.crt;
#为虚拟主机指定私钥文件
ssl_certificate_key /etc/ssl/cunzhang_test.key;
#客户端能够重复使用存储在缓存中的会话参数时间
ssl_session_timeout 5m;
#指定使用的ssl协议
ssl_protocols SSLv3 TLSv1;
#指定许可的密码描述
ssl_ciphers ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP;
#SSLv3和TLSv1协议的服务器密码需求优先级高于客户端密码
ssl_prefer_server_ciphers on; location / {
root /etc/ssl/;
autoindex on;
autoindex_exact_size off;
autoindex_localtime on;
} # redirect server error pages to the static page /50x.html
#
error_page 500 502 503 504 /50x.html;
error_page 404 /404.html; location = /50x.html {
root /usr/share/nginx/www;
}
location = /404.html {
root /usr/share/nginx/www;
} # proxy the PHP scripts to fpm
location ~ \.php$ {
access_log /etc/ssl/ssl.access.log ;
error_log /etc/ssl/ssl.error.log;
root /etc/ssl/;
fastcgi_param HTTPS on;
include /usr/local/etc/nginx/fastcgi_params;
fastcgi_pass sslfpm;
}
}
}

虚拟主机文件配置之后还有记得在hosts给你的域名配置好ip地址,这样就可以通过https访问到你的网页实现定位功能了。

参考资料:

Nginx搭建https服务器

上一篇:HTML5 地理位置定位API(2)


下一篇:HTML5 地理位置定位API(5)