@capgo/background-geolocation

Resumen

Usa @capgo/background-geolocation cuando tu app Capacitor necesita actualizaciones de ubicación precisas en primer plano o en segundo plano, geofences circulares nativos en iOS y Android, y entrega al backend de las transiciones de geofence cuando la WebView está suspendida.

Funcionalidades principales

• start - Recibe actualizaciones de ubicación precisas en primer o segundo plano.
• stop - Detén limpiamente el seguimiento de ubicación activo.
• openSettings - Envía a los usuarios a los ajustes de ubicación nativos si faltan permisos.
• setPlannedRoute - Reproduce un sonido nativo cuando el usuario se desvía de una ruta planificada.
• setupGeofencing - Configura valores por defecto de geofence nativo y webhooks de transición opcionales.
• addGeofence - Monitorea una región de geofence circular en iOS o Android por identificador.
• removeGeofence / removeAllGeofences - Detén el monitoreo de una o todas las geofences registradas.
• getMonitoredGeofences - Lista los identificadores de región que la capa nativa monitorea actualmente.
• geofenceTransition listener - Recibe eventos de entrada y salida mientras la app está activa.
• geofenceError listener - Gestiona errores de monitoreo nativo sin cambiar la estructura del evento de transición.

Público API

Método	Descripción
start	Emite actualizaciones precisas de ubicación en foreground o background.
stop	Detiene las actualizaciones de ubicación.
openSettings	Abre la configuración de ubicación del dispositivo. Útil para guiar al usuario a activar los servicios de ubicación o ajustar permisos.
setPlannedRoute	Reproduce un sonido nativo cuando el usuario se desvía de la ruta planificada.
setupGeofencing	Configura los valores predeterminados de geofence y la entrega POST opcional de transiciones nativas.
addGeofence	Inicia el monitoreo de un geofence circular en iOS y Android.
removeGeofence	Detiene el monitoreo de un geofence por identificador.
removeAllGeofences	Detiene el monitoreo de todos los geofences registrados por este plugin.
getMonitoredGeofences	Devuelve los identificadores monitoreados actualmente por la capa nativa.
addListener('geofenceTransition', ...)	Recibe eventos de entrada y salida de geofences mientras la app está activa.
addListener('geofenceError', ...)	Recibe errores del monitoreo nativo de geofences mientras la app está activa.
getPluginVersion	Obtén la versión del plugin nativo Capacitor.

Fuente de verdad

Esta referencia se sincroniza desde src/definitions.ts en capacitor-background-geolocation.

Continúa con @capgo/background-geolocation

Si estás usando @capgo/background-geolocation para planificar el trabajo con plugins nativos, conéctalo con Usando @capgo/background-geolocation para la capacidad nativa en «Usando @capgo/background-geolocation», Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.