HTML5 地理定位

HTML5 Geolocation(地理定位)用于定位用户的位置。

在谷歌地图上显示您的位置


定位用户的位置

HTML5 Geolocation API 用于获得用户的地理位置。

鉴于该特性可能侵犯用户的隐私,除非用户同意,否则用户位置信息是不可用的。


浏览器支持

Yes9.0YesYesYes

注释:对于拥有 GPS 的设备,比如 iPhone,地理定位更加精确。


HTML5 - 使用地理定位

请使用 getCurrentPosition() 方法来获得用户的位置。

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

  1. <!DOCTYPE html>
  2. <html>
  3. <body>
  4. <p id="demo">点击这个按钮,获得您的坐标:</p>
  5. <button onclick="getLocation()">试一下</button>
  6. <script>
  7. var x=document.getElementById("demo");
  8. function getLocation()
  9. {
  10. if (navigator.geolocation)
  11. {
  12. navigator.geolocation.getCurrentPosition(showPosition);
  13. }
  14. else{x.innerHTML="Geolocation is not supported by this browser.";}
  15. }
  16. function showPosition(position)
  17. {
  18. x.innerHTML="Latitude: " + position.coords.latitude + "<br />Longitude: " +position.coords.longitude;
  19. }
  20. </script>
  21. </body>
  22. </html>

解释:

  • 检测是否支持地理定位
  • 如果支持,则运行 getCurrentPosition() 方法。如果不支持,则向用户显示一段消息。
  • 如果 getCurrentPosition() 运行成功,则向参数 showPosition 中规定的函数返回一个 coordinates 对象
  • showPosition() 函数获得并显示经度和纬度
  • 上面的例子是一个非常基础的地理定位脚本,不含错误处理。
注意:如果你运行上述代码无法定位,那是因为部分浏览器使用的谷歌的定位服务,而谷歌服务在中国被墙了,所以要么定位非常慢,也不准,要么直接无法定位。

处理错误和拒绝

getCurrentPosition() 方法的第二个参数用于处理错误。它规定当获取用户位置失败时运行的函数:

  1. <!DOCTYPE html>
  2. <html>
  3. <body>
  4. <p id="demo">点击这个按钮,获得您的坐标:</p>
  5. <button onclick="getLocation()">试一下</button>
  6. <script>
  7. var x = document.getElementById("demo");
  8. function getLocation() {
  9. if (navigator.geolocation) {
  10. navigator.geolocation.getCurrentPosition(showPosition, showError);
  11. }
  12. else { x.innerHTML = "该浏览器不支持 Geolocation"; }
  13. }
  14. function showPosition(position) {
  15. x.innerHTML = "Latitude: " + position.coords.latitude + "<br />Longitude: " + position.coords.longitude;
  16. }
  17. function showError(error) {
  18. switch (error.code) {
  19. case error.PERMISSION_DENIED:
  20. x.innerHTML = "用户拒绝 Geolocation 的请求。"
  21. break;
  22. case error.POSITION_UNAVAILABLE:
  23. x.innerHTML = "位置信息不可用。"
  24. break;
  25. case error.TIMEOUT:
  26. x.innerHTML = "获取用户位置的请求超时。"
  27. break;
  28. case error.UNKNOWN_ERROR:
  29. x.innerHTML = "发生勒未知的错误"
  30. break;
  31. }
  32. }
  33. </script>
  34. </body>
  35. </html>

错误代码:

  • Permission denied - 用户不允许地理定位
  • Position unavailable - 无法获取当前位置
  • Timeout - 操作超时

在地图中显示结果

如需在地图中显示结果,您需要访问可使用经纬度的地图服务,比如谷歌地图或百度地图:

  1. <!DOCTYPE html>
  2. <html>
  3. <body>
  4. <p id="demo">点击这个按钮,获得您的位置:</p>
  5. <button onclick="getLocation()">试一下</button>
  6. <div id="mapholder"></div>
  7. <script>
  8. var x = document.getElementById("demo");
  9. function getLocation() {
  10. if (navigator.geolocation) {
  11. navigator.geolocation.getCurrentPosition(showPosition, showError);
  12. }
  13. else { x.innerHTML = "此浏览器不支持 Geolocation 。"; }
  14. }
  15. function showPosition(position) {
  16. var latlon = position.coords.latitude + "," + position.coords.longitude;
  17. var img_url = "http://maps.googleapis.com/maps/api/staticmap?center="
  18. + latlon + "&zoom=14&size=400x300&sensor=false";
  19. document.getElementById("mapholder").innerHTML = "<img src='" + img_url + "' />";
  20. }
  21. function showError(error) {
  22. switch (error.code) {
  23. case error.PERMISSION_DENIED:
  24. x.innerHTML = "用户拒绝 Geolocation 的请求。"
  25. break;
  26. case error.POSITION_UNAVAILABLE:
  27. x.innerHTML = "位置信息不可用。"
  28. break;
  29. case error.TIMEOUT:
  30. x.innerHTML = "获取用户位置的请求超时。"
  31. break;
  32. case error.UNKNOWN_ERROR:
  33. x.innerHTML = "发生勒未知的错误"
  34. break;
  35. }
  36. }
  37. </script>
  38. </body>
  39. </html>

在上例中,我们使用返回的经纬度数据在谷歌地图中显示位置(使用静态图像)。

注意:因为调用的谷歌地图api,所以在国内以上代码运行可能会有问题。

给定位置的信息

本章节演示的是如何在地图上显示用户的位置。不过,地理定位对于给定位置的信息同样很有用处。

比如:

  • 更新本地信息
  • 显示用户周围的兴趣点
  • 交互式车载导航系统 (GPS)

getCurrentPosition() 方法 - 返回数据

若成功,则 getCurrentPosition() 方法返回对象。始终会返回 latitude、longitude 以及 accuracy 属性。如果可用,则会返回其他下面的属性。

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

Geolocation 对象 - 其他有趣的方法

watchPosition() - 返回用户的当前位置,并继续返回用户移动时的更新位置(就像汽车上的 GPS)。

clearWatch() - 停止 watchPosition() 方法

下面的例子展示 watchPosition() 方法。您需要一台精确的 GPS 设备来测试该例(比如 iPhone):

  1. <!DOCTYPE html>
  2. <html>
  3. <body>
  4. <p id="demo">点击这个按钮,获得您的坐标:</p>
  5. <button onclick="getLocation()">试一下</button>
  6. <script>
  7. var x = document.getElementById("demo");
  8. function getLocation() {
  9. if (navigator.geolocation) {
  10. navigator.geolocation.watchPosition(showPosition);
  11. }
  12. else { x.innerHTML = "此浏览器不支持 Geolocation 。"; }
  13. }
  14. function showPosition(position) {
  15. x.innerHTML = "Latitude: " + position.coords.latitude + "<br />Longitude: " + position.coords.longitude;
  16. }
  17. </script>
  18. </body>
  19. </html>