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.
Contexto seguro: Esta función está disponible solo en contextos seguros (HTTPS), en algunos o todos los navegadores que lo soportan.
El método watchPosition()
de Geolocation
se usa para registrar una función que será llamada automáticamente cada vez que el dispositivo cambie de ubicación. También puede, opcionalmente, especificar una función que maneje los errores.
Sintaxis
watchPosition(success)
watchPosition(success, error)
watchPosition(success, error, options)
Parámetros
success
-
La función devuelta tiene como parámetro de entrada un objeto de tipo
GeolocationPosition
. error
Opcional-
La función opcional devuelta tiene como parámetro de entrada un objeto de tipo
GeolocationPositionError
. options
Opcional-
Un objeto opcional que provee de configuraciones a la monitorización de la ubicación. Consulte
Geolocation.getCurrentPosition()
para obtener más detalles acerca de las posibles opciones.
Valor devuelto
Un valor numérico ID que identifica a la función que se encuentra monitoreando la ubicación.
Este ID puede ser pasado al método Geolocation.clearWatch()
para detener el monitoreo de la ubicación.
Ejemplos
let id;
let target;
let options;
function success(pos) {
const crd = pos.coords;
if (target.latitude === crd.latitude && target.longitude === crd.longitude) {
console.log("Felicidades, has llegado a tu destino.");
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);
Especificaciones
Specification |
---|
Geolocation # watchposition-method |
Compatibilidad con navegadores
BCD tables only load in the browser
Véase también
- Usando la API de Geolocalización
- La interfaz pertenece a
Geolocation
, y puede ser accedida medianteNavigator.geolocation
. - La operación contraria:
Geolocation.clearWatch()
- Un método similar:
Geolocation.getCurrentPosition()