Geolocation.clearWatch()

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.  The Geolocation.clearWatch() method is used to unregister location/error monitoring handlers previously installed using Geolocation.watchPosition(). 

Syntax
clearWatch(id)

Parameters
 id   The ID number returned by the Geolocation.watchPosition() method when installing the handler you wish to remove.   
Examples
var id, target, option;

function success(pos) {
  var crd = pos.coords;

  if (target.latitude === crd.latitude && target.longitude === crd.longitude) {
    console.log('Congratulations, you\'ve reached the target!');
    navigator.geolocation.clearWatch(id);
  }
};

function error(err) {
  console.warn('ERROR(' + err.code + '): ' + err.message);
};

target = {
  latitude : 0,
  longitude: 0,
}

options = {
  enableHighAccuracy: false,
  timeout: 5000,
  maximumAge: 0
};

id = navigator.geolocation.watchPosition(success, error, options);

Specifications

Specification
Geolocation API # clearwatch-method

Browser compatibility




Desktop
Mobile



Chrome
Edge
Firefox
Internet Explorer
Opera
Safari
WebView Android
Chrome Android
Firefox for Android
Opera Android
Safari on IOS
Samsung Internet



clearWatch
5
12
3.5
9
10.6
5
≤37
18
4
11
≤3
1.0


See also
 Using geolocation Geolocation Geolocation.watchPosition() Geolocation.getCurrentPosition() 


Found a problem with this page?

Edit on GitHub
Source on GitHub
Report a problem with this content on GitHub
Want to fix the problem yourself? See our Contribution guide.


Last modified: Apr 18, 2022, by MDN contributors


    
{'path': 'public/docs/dom/geolocation/clearwatch.html', 'source': 'DevDocs.IO'}