Geolocation.watchPosition()
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.
O método Geolocation.watchPosition()
é usado para registrar uma função manipuladora (handler function) que irá ser chamada automáticamente cada vez que a posição no dispositivo mudar. Você pode, opcionalemnte, especificar uma função de retorno que manipulará qualquer erro.
Este método retorna um valor para o watch ID que pode ser usado para desregistrar o manipulador passando isto para o método Geolocation.clearWatch()
.
Síntaxe
watchPosition(success)
watchPosition(success, error)
watchPosition(success, error, options)
Parâmetros
- success
-
AUma função de retorno (callback) que pega um objeto
Position
como parametro de entrada. - error Optional
-
Uma função de retorno opcional que pega um objeto
PositionError
como parametro de entrada. - options Optional
-
Um objeto opcional
PositionOptions
.
Exemplo
var id, target, options;
function success(pos) {
var crd = pos.coords;
if (target.latitude === crd.latitude && target.longitude === crd.longitude) {
console.log("Parabéns, você alcançou o destino");
navigator.geolocation.clearWatch(id);
}
}
function error(err) {
console.warn("ERRO(" + 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 # watchposition-method |
Compatibilidade com navegadores
BCD tables only load in the browser
Veja também
- Usando geolocalização
- A interface que ele pertence,
Geolocation
, e como acessarNavigatorGeolocation.geolocation
. - A operação oposta:
Geolocation.clearWatch()
- Um método similar:
Geolocation.getCurrentPosition()