@capgo/background-geolocation

Panoramica

Usa @capgo/background-geolocation quando la tua app Capacitor richiede aggiornamenti della posizione precisi in foreground o background, geofence circolari native su iOS e Android e la gestione lato backend delle transizioni geofence quando la WebView è sospesa.

Funzionalità principali

• start - Stream di aggiornamenti precisi della posizione in foreground o background.
• stop - Stop active location tracking cleanly.
• openSettings - Indirizza gli utenti alle impostazioni di localizzazione native quando è necessario gestire i permessi.
• setPlannedRoute - Riproduzione di un suono nativo quando l'utente devia dal percorso pianificato.
• setupGeofencing - Configura i default delle geofence native e l'invio opzionale di webhook per le transizioni.
• addGeofence - Monitoraggio di una regione geofence circolare iOS o Android tramite identificativo.
• removeGeofence / removeAllGeofences - Interrompe il monitoraggio di una o tutte le geofence registrate.
• getMonitoredGeofences - Elenca gli identificativi delle regioni monitorate dal layer nativo.
• geofenceTransition listener - Riceve gli eventi di enter ed exit quando l'app è attiva.
• geofenceError listener - Gestisce gli errori di monitoraggio nativo senza alterare la struttura dell'evento di transizione.

Pubblico API

Metodo	Descrizione
start	Invia aggiornamenti precisi della posizione in foreground o background.
stop	Interrompe gli aggiornamenti della posizione.
openSettings	Apre la pagina delle impostazioni sulla posizione del dispositivo. Utile per guidare gli utenti ad abilitare i servizi di localizzazione o regolare i permessi.
setPlannedRoute	Riproduce un suono nativo quando l'utente devia dal percorso pianificato.
setupGeofencing	Configura i default delle geofence e la consegna POST opzionale delle transizioni native.
addGeofence	Avvia il monitoraggio di una geofence circolare su iOS e Android.
removeGeofence	Stops monitoring one geofence by identifier.
removeAllGeofences	Interrompe il monitoraggio di tutte le geofence registrate da questo plugin.
getMonitoredGeofences	Restituisce gli identificatori attualmente monitorati dal layer nativo.
addListener('geofenceTransition', ...)	Riceve gli eventi di ingresso e uscita dalle geofence quando l'app è attiva.
addListener('geofenceError', ...)	Riceve gli errori di monitoraggio delle geofence native quando l'app è attiva.
getPluginVersion	Ottieni la versione nativa del plugin Capacitor.

Fonte di verità

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-background-geolocation.

Continua con @capgo/background-geolocation

Se stai usando @capgo/background-geolocation per pianificare il lavoro sui plugin nativi, collegalo a Usare @capgo/background-geolocation per la funzionalità nativa in Usare @capgo/background-geolocation, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli su come aggiungere o aggiornare i plugin, e Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Alternative ai plugin Ionic Enterprise.