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 julio de 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);

Usando la API de Geolocalización
La interfaz pertenece a Geolocation, y puede ser accedida mediante Navigator.geolocation.
La operación contraria: Geolocation.clearWatch()
Un método similar: Geolocation.getCurrentPosition()

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 22 jul 2023 by MDN contributors.

View this page on GitHub • Report a problem with this content

Geolocation.watchPosition()

In this article

Sintaxis

Parámetros

Valor devuelto

Ejemplos

Especificaciones

Compatibilidad con navegadores

Véase también

Help improve MDN