Geolocation.watchPosition()
El método Geolocation.watchPosition()
se utiliza para registrar una función de controlador que se llamará automáticamente cada vez que la posición del dispositivo cambia. También puede, opcionalmente, especificar una función de devolución de la gestión de errores.
Este método devuelve un valor de ID de seguimiento que se puede utilizar para anular el registro del controlador pasándolo al método Geolocation.clearWatch().
Sintaxis
id = navigator.geolocation.watchPosition(success, error, options)
Parámetros
- success
- Una función de devolución de llamada que toma un objeto de posición(
Position
) como parámetro de entrada. - error Opcional
- Una función de devolución de llamada opcional que toma un objeto
PositionError
(en-US) como parámetro de entrada. - options Opcional
- Un objeto opcional
PositionOptions
.
Ejemplo
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);
Especificacines
Especificación | Estado | Comentario |
---|---|---|
Geolocation API La definición de 'Geolocation.watchPosition()' en esta especificación. |
Recommendation | Especificación inicial |
Compatibilidad de navegador
BCD tables only load in the browser