HTML5 Geolocation（地理定位）用于定位用户的位置。

定位用户的位置

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

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

浏览器支持

Internet Explorer 9、Firefox、Chrome、Safari 以及 Opera 支持地理定位。

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

HTML5 - 使用地理定位

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

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

实例

  1. <script>
  2. var x=document.getElementById("demo");
  3. function getLocation()
  4.   {
  5.   if (navigator.geolocation)
  6.     {
  7.     navigator.geolocation.getCurrentPosition(showPosition);
  8.     }
  9.   else{x.innerHTML="Geolocation is not supported by this browser.";}
  10.   }
  11. function showPosition(position)
  12.   {
  13.   x.innerHTML="Latitude: " + position.coords.latitude +
  14.   "<br />Longitude: " + position.coords.longitude;
  15.   }
  16. </script>

例子解释：

  • 检测是否支持地理定位
  • 如果支持，则运行 getCurrentPosition() 方法。如果不支持，则向用户显示一段消息。
  • 如果getCurrentPosition()运行成功，则向参数showPosition中规定的函数返回一个coordinates对象
  • showPosition() 函数获得并显示经度和纬度

上面的例子是一个非常基础的地理定位脚本，不含错误处理。

处理错误和拒绝

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

实例

  1. function showError(error)
  2.   {
  3.   switch(error.code)
  4.     {
  5.     case error.PERMISSION_DENIED:
  6.       x.innerHTML="User denied the request for Geolocation."
  7.       break;
  8.     case error.POSITION_UNAVAILABLE:
  9.       x.innerHTML="Location information is unavailable."
  10.       break;
  11.     case error.TIMEOUT:
  12.       x.innerHTML="The request to get user location timed out."
  13.       break;
  14.     case error.UNKNOWN_ERROR:
  15.       x.innerHTML="An unknown error occurred."
  16.       break;
  17.     }
  18.   }

错误代码：

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

在地图中显示结果

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

实例

  1. function showPosition(position)
  2. {
  3. var latlon=position.coords.latitude+","+position.coords.longitude;
  5. var img_url="http://maps.googleapis.com/maps/api/staticmap?center="
  6. +latlon+"&zoom=14&size=400x300&sensor=false";
  8. document.getElementById("mapholder").innerHTML="<img src='"+img_url+"' />";
  9. }

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

谷歌地图脚本

  1. <!DOCTYPE html>
  2. <html>
  3. <body>
  4. <p id="demo">点击这个按钮，获得您的位置：</p>
  5. <button onclick="getLocation()">试一下</button>
  6. <div id="mapholder"></div>
  7. <script src="http://maps.google.com/maps/api/js?sensor=false"></script>
  8. <script>
  9. var x=document.getElementById("demo");
  10. function getLocation()
  11.   {
  12.   if (navigator.geolocation)
  13.     {
  14.     navigator.geolocation.getCurrentPosition(showPosition,showError);
  15.     }
  16.   else{x.innerHTML="Geolocation is not supported by this browser.";}
  17.   }
  19. function showPosition(position)
  20.   {
  21.   lat=position.coords.latitude;
  22.   lon=position.coords.longitude;
  23.   latlon=new google.maps.LatLng(lat, lon)
  24.   mapholder=document.getElementById('mapholder')
  25.   mapholder.style.height='250px';
  26.   mapholder.style.width='500px';
  28.   var myOptions={
  29.   center:latlon,zoom:14,
  30.   mapTypeId:google.maps.MapTypeId.ROADMAP,
  31.   mapTypeControl:false,
  32.   navigationControlOptions:{style:google.maps.NavigationControlStyle.SMALL}
  33.   };
  34.   var map=new google.maps.Map(document.getElementById("mapholder"),myOptions);
  35.   var marker=new google.maps.Marker({position:latlon,map:map,title:"You are here!"});
  36.   }
  38. function showError(error)
  39.   {
  40.   switch(error.code) 
  41.     {
  42.     case error.PERMISSION_DENIED:
  43.       x.innerHTML="User denied the request for Geolocation."
  44.       break;
  45.     case error.POSITION_UNAVAILABLE:
  46.       x.innerHTML="Location information is unavailable."
  47.       break;
  48.     case error.TIMEOUT:
  49.       x.innerHTML="The request to get user location timed out."
  50.       break;
  51.     case error.UNKNOWN_ERROR:
  52.       x.innerHTML="An unknown error occurred."
  53.       break;
  54.     }
  55.   }
  56. </script>
  57. </body>
  58. </html>

<!DOCTYPE html>

点击这个按钮，获得您的位置：

上面的链接向您演示如何使用脚本来显示带有标记、缩放和拖曳选项的交互式地图。

给定位置的信息

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

案例：

  • 更新本地信息
  • 显示用户周围的兴趣点
  • 交互式车载导航系统 (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. <script>
  2. var x=document.getElementById("demo");
  3. function getLocation()
  4.   {
  5.   if (navigator.geolocation)
  6.     {
  7.     navigator.geolocation.watchPosition(showPosition);
  8.     }
  9.   else{x.innerHTML="Geolocation is not supported by this browser.";}
  10.   }
  11. function showPosition(position)
  12.   {
  13.   x.innerHTML="Latitude: " + position.coords.latitude +
  14.   "<br />Longitude: " + position.coords.longitude;
  15.   }
  16. </script>