Saltar al contenido

@capgo/ubicación-de-fondo

Ubicación de fondo precisa, eventos de entrada/salida de geofence nativos y webhooks de transición para aplicaciones Capacitor.

Uso @capgo/background-geolocation Cuando su aplicación Capacitor necesita actualizaciones de ubicación precisas en primer plano o fondo, círculos de geofencado nativos en iOS y Android, y entrega de backend para transiciones de geofencado cuando el WebView está suspendido.

  • start - Transmite actualizaciones de ubicación precisas en primer plano o fondo.
  • stop - Detener el seguimiento de ubicación activo de manera limpia.
  • openSettings - Enviar a los usuarios a la configuración de ubicación nativa cuando los permisos necesitan atención.
  • setPlannedRoute - Reproducir un sonido nativo cuando el usuario se desvía de una ruta planificada.
  • setupGeofencing - Configurar los valores por defecto de geofence nativa y la entrega opcional de webhooks de transición.
  • addGeofence - Monitorear una región circular de geofence iOS o Android por identificador.
  • removeGeofence / removeAllGeofences - Detener el monitoreo de uno o todos los geofences registrados.
  • getMonitoredGeofences - Listar los identificadores de región actualmente monitoreados por la capa nativa.
  • geofenceTransition - listener - Recibir eventos de entrada y salida mientras la aplicación está activa.
  • geofenceError - listener - Manejar errores de monitoreo nativo sin cambiar la forma del evento de transición.
- MétodoDescripción
startProporciona actualizaciones de ubicación en primer o segundo plano.
stopDetiene las actualizaciones de ubicación.
openSettingsAbre la página de ajustes de ubicación del dispositivo. Útil para dirigir a los usuarios a habilitar servicios de ubicación o ajustar permisos.
setPlannedRouteReproduce un sonido nativo cuando el usuario se desvía de un recorrido planificado.
setupGeofencingConfigura los valores por defecto de geofence y entrega de transición POST nativa opcional.
addGeofenceInicia la supervisión de un geofence circular en iOS y Android.
removeGeofenceDetiene la supervisión de un geofence por su identificador.
removeAllGeofencesDetiene la supervisión de todos los geofences registrados por este plugin.
getMonitoredGeofencesDevuelve los identificadores actualmente supervisados por la capa nativa.
addListener('geofenceTransition', ...)Recibe eventos de entrada y salida de geofence mientras la aplicación está en ejecución.
addListener('geofenceError', ...)Recibe errores de supervisión de geofence nativa mientras la aplicación está en ejecución.
getPluginVersionObtenga la versión nativa del plugin Capacitor.

Esta referencia está sincronizada desde src/definitions.ts en capacitor-background-geolocation.

Si está utilizando @capgo/background-geolocation para planificar el trabajo del plugin nativo, conectéelo con Usando @capgo/background-geolocation para la capacidad nativa en Usando @capgo/background-geolocation, Capgo Directorio del plugin para el flujo de trabajo del producto en Capgo Directorio del plugin, Capacitor Plugins por Capgo para el detalle de implementación en Capacitor Plugins por Capgo, Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, y Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise.