Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

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 ⁨julho de 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

Veja Também