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

js
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

js
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