Geolocation: clearWatch() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

もっと詳しく
完全な互換性情報を見る

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

clearWatch() は Geolocation インターフェイスのメソッドで、以前 Geolocation.watchPosition() によって登録された位置情報/エラーの監視ハンドラーを解除するために使用します。

構文

clearWatch(id)

引数

id: 解除したいハンドラーの登録時に Geolocation.watchPosition() メソッドから返された ID 番号です。

返値

なし (undefined)。

例

let id;
let target;
let options;
function success(pos) {
 const crd = pos.coords;
 if (target.latitude === crd.latitude && target.longitude === crd.longitude) {
 console.log("おめでとうございます。目的地に到着しました。");
 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);