Llama a GeofenceRelay.shared.start() desde el app delegate de iOS para que una app terminada pueda enviar un POST al cruzar una región cuando iOS la relanza. Se requiere acceso a la ubicación siempre para ese relanzamiento.
Cola en disco y reintentos
En iOS, las transiciones se encolan en disco y se envían en orden. iOS reintenta ante pérdida de red, 5xx, 408, 429 o 401/403. Esa cola de iOS conserva las 100 transiciones más recientes, ninguna con más de siete días. Android reintenta a través de WorkManager y no usa esta cola ordenada ni esos límites.
clearGeofenceQueue()
Descarta los POST nativos no enviados al cerrar sesión o cambiar de cuenta en el mismo url. La cola también se vacía cuando setupGeofencing se le asigna un urldiferente. En web no hay cola y la llamada se resuelve de inmediato.
Hora del evento
Opcional GeofenceTransitionEvent.time es cuando el teléfono detectó el cruce, en milisegundos desde el epoch. Léelo en tu webhook, no en el reloj del servidor, porque un POST en cola puede llegar más tarde.
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.
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.
updateHeaders
Reemplaza las cabeceras HTTP persistidas para la entrega nativa POST. En iOS, esto también vacía la cola de geocercas. En Android, guarda las cabeceras sin iniciar trabajos en cola de WorkManager.
clearGeofenceQueue
Descarta las transiciones de geocerca en cola para un POST nativo que aún no se han enviado. Se resuelve de inmediato en web.
addListener('geofenceTransition', ...)
Recibe eventos de entrada y salida de geocerca mientras la app está activa. Los eventos pueden incluir time.
addListener('geofenceError', ...)
Recibe errores del monitoreo nativo de geofences mientras la app está activa.