@capgo/background-geolocation

Resumen

Use @capgo/background-geolocation cuando su aplicación Capacitor necesita actualizaciones de ubicación precisas en el primer plano o en segundo plano, geofences circulares nativos en iOS y Android, y entrega de backend para transiciones de geofence cuando el WebView está suspendido.

Capacidades básicas de Capgo

• start - Transmite actualizaciones de ubicación de frente o de fondo con precisión.
• stop - Detiene la seguimiento de ubicación activo de manera limpia.
• openSettings - Envía a los usuarios a la configuración de ubicación nativa cuando necesitan atención a los permisos.
• setPlannedRoute - Reproduce un sonido nativo cuando el usuario se desvía de una ruta planificada.
• setupGeofencing - Configura los valores predeterminados de la geolocalización nativa y la entrega opcional de webhooks de transición.
• addGeofence - Monitorea una región circular de geolocalización iOS o Android por identificador.
• removeGeofence / removeAllGeofences - Detiene la monitoreo de una o todas las geolocalizaciones registradas.
• getMonitoredGeofences - Lista los identificadores de región actualmente monitoreados por la capa nativa.
• geofenceTransition - listener - Recibe eventos de entrada y salida mientras la aplicación está activa.
• geofenceError - listener - Maneja errores de monitoreo nativo sin cambiar la forma del evento de transición.

Público API

Método	Descripción
start	Proporciona actualizaciones de ubicación en primer o segundo plano.
stop	Detiene las actualizaciones de ubicación.
openSettings	Abre la página de ajustes de ubicación del dispositivo. Útil para dirigir a los usuarios a habilitar los servicios de ubicación o ajustar permisos.
setPlannedRoute	Reproduce un sonido nativo cuando el usuario se desvía de un recorrido planificado.
setupGeofencing	Configura los valores por defecto de la geofencificación y la entrega de transiciones POST nativas (opcional).
addGeofence	Inicia la monitorización de una geofencificación circular en iOS y Android.
removeGeofence	Detiene la monitorización de una geofencificación por su identificador.
removeAllGeofences	Detiene la monitorización de todas las geofencificaciones registradas por este plugin.
getMonitoredGeofences	Devuelve los identificadores actualmente monitorizados por la capa nativa.
addListener('geofenceTransition', ...)	Recibe eventos de entrada y salida de geofence mientras la aplicación está activa.
addListener('geofenceError', ...)	Recibe errores de monitoreo de geofence nativa mientras la aplicación está activa.
getPluginVersion	Obtén la versión del plugin nativo Capacitor.

Fuente de Verdad

Esta referencia está sincronizada desde src/definitions.ts en capacitor-geolocalización de fondo.