Geolocation: clearWatch()-Methode

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.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die clearWatch()-Methode der Geolocation-Schnittstelle wird verwendet, um zuvor mit Geolocation.watchPosition() installierte Standort-/Fehlerüberwachungs-Handler abzumelden.

Syntax

js
clearWatch(id)

Parameter

id

Die ID-Nummer, die von der Geolocation.watchPosition()-Methode zurückgegeben wird, wenn Sie den zu entfernenden Handler installieren.

Rückgabewert

Keiner (undefined).

Beispiele

js
let id;
let target;
let options;

function success(pos) {
  const 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.error(`ERROR(${err.code}): ${err.message}`);
}

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

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

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

Spezifikationen

Specification
Geolocation
# clearwatch-method

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch