Geolocation.watchPosition()

Geolocation.watchPosition() 這個方法是用來註冊一個處理的函式，當使用者的裝置位置更新時，這個函式所傳入的回呼函式(callback function) 就會自動被呼叫。你也可以選擇性的定義錯誤時哪些錯誤回呼函式(error callback function) 需要被呼叫。

這個函式將回傳一組 ID 編號，此編號搭配 Geolocation.clearWatch() 函式，即可停止更新使用者的位置。

語法

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

參數

success: 一個回呼函式(callback function) 會被傳入一個 Position 的物件。
error 選擇性: 一個選擇性的錯誤回呼函式(callback function)，會被傳入一個PositionError 的物件。
options 選擇性: 一個選擇性 PositionOptions 的物件。

範例

var id, target, options;

function success(pos) {
  var crd = pos.coords;

  if (target.latitude === crd.latitude && target.longitude === crd.longitude) {
    console.log('Congratulations, you reached 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);

備註

如果你的應用程式是跑在 firefox OS 上，請參考 geolocation wake lock，此方法可以讓你的程式在背景或螢幕關上時也能持續收到位置更新。

規格

Specification
Geolocation API # watchposition-method

瀏覽器的相容性

BCD tables only load in the browser

請參考

Using geolocation (en-US)
這個介面屬於Geolocation. 並且存取他的方式為NavigatorGeolocation.geolocation (en-US).
相反的操作: Geolocation.clearWatch()
類似的方法: Geolocation.getCurrentPosition()