HTML5 Geolocation clearWatch() API

说明

clearWatch() 方法可以取消正在执行的 watchPosition() 方法，当被取消时，watchPosition() 方法将停止从设备获取有关当前地理位置的更新。

语法

方法的语法如下所示 −

clearWatch(watchId);

参数

下面是参数的详细信息 −

watchId − 指定要取消的 watchPosition() 方法的唯一 ID，该 ID 是由 watchPosition() 方法返回的。

返回值

clearWatch() 方法不返回任何值。

示例

<!DOCTYPE HTML>

<html>
   <head>

      <script type = "text/javascript">
         var watchID;
         var geoLoc;

         function showLocation(position) {
            var latitude = position.coords.latitude;
            var longitude = position.coords.longitude;
            alert("Latitude : " + latitude + " Longitude: " + longitude);
         }

         function errorHandler(err) {
            if(err.code == 1) {
               alert("Error: Access is denied!");
            } else if( err.code == 2) {
               alert("Error: Position is unavailable!");
            }
         }

         function getLocationUpdate(){

            if(navigator.geolocation){

               // timeout at 60000 milliseconds (60 seconds)
               var options = {timeout:60000};
               geoLoc = navigator.geolocation;
               watchID = geoLoc.watchPosition(showLocation, errorHandler, options);
            } else {
               alert("Sorry, browser does not support geolocation!");
            }
         }

         function stopWatch() {
            geoLoc.clearWatch(watchID);
         }
      </script>
   </head>

   <body>

      <form>
         <input type = "button" onclick = "getLocationUpdate();" value = "Watch Update"/>
         <input type = "button" onclick = "stopWatch();" value = "Stop Watch"/>
      </form>

   </body>
</html>