Geolocation.clearWatch()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

O método Geolocation.clearWatch() é usado para cancelar o registro dos manipuladores de monitoramento de localização / erro instalados anteriormente usando Geolocation.watchPosition().

Syntax

navigator.geolocation.clearWatch(id);

Parameters

id

O número do ID retornado pelo método Geolocation.watchPosition() ao instalar o manipulador que você deseja remover.

Exemplo

js
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);

Especificações

Specification
Geolocation
# clearwatch-method

Compatibilidade com navegadores

BCD tables only load in the browser

Veja Também