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

navigator.geolocation.clearWatch(id);

Parameters

id
The ID number returned by the Geolocation.watchPosition() method when installing the handler you wish to remove.

Example

var id, target, option;
function success(pos) {
  var crd = pos.coords;
  if (target.latitude === crd.latitude && target.longitude === crd.longitude) {
    console.log('Congratulation, you reach 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 Status Comment
Geolocation API Recommendation Initial specification.

Browser compatibility

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support 5 (Yes) 3.5 (1.9.1) 9 10.60
Removed in 15.0
Reintroduced in 16.0
5
Secure context-only 47 ? 55 (55) No support (Yes) (Yes)
Feature Android Chrome for Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? ? (Yes) 4.0 (4) ? 10.60 ?
Secure context-only No support 47 ? 55 (55) No support (Yes) (Yes)

See also

Document Tags and Contributors

 Contributors to this page: chrisdavidmills, erikadoyle, boutrosa, fscholz, teoli, kscarfone, Sheppy, Jeremie
 Last updated by: chrisdavidmills,