@capgo/background-geolocation

Panoramica

Utilizzo @capgo/background-geolocation Quando il tuo Capacitor app richiede aggiornamenti di posizione precisi in primo piano o in background, geofence circolari nativi su iOS e Android, e consegna backend per transizioni di geofence quando il WebView è sospeso.

Capacità di base

• start - Fornisci aggiornamenti di posizione precisi in primo piano o in background.
• stop - Fermare la tracciatura di posizione attiva in modo pulito.
• openSettings - Invia gli utenti alle impostazioni di posizione native quando le autorizzazioni richiedono attenzione.
• setPlannedRoute - Riproduci un suono nativo quando l'utente si allontana da una rotta pianificata.
• setupGeofencing - Configura i default di geofence nativi e la consegna facoltativa di webhook per transizioni.
• addGeofence - Monitora una regione di geofence circolare di iOS o Android per identificatore.
• removeGeofence / removeAllGeofences - Fermare la monitoraggio di uno o tutti i geofenci registrati.
• getMonitoredGeofences - Elencare gli identificativi di regione attualmente monitorati dal layer nativo.
• geofenceTransition listener - Ricevere eventi di ingresso e uscita mentre l'app è attiva.
• geofenceError listener - Gestire gli errori di monitoraggio nativo senza modificare la forma degli eventi di transizione.

Pubblico API

Metodo	Descrizione
start	Fornisce aggiornamenti di posizione precisi in primo piano o in background.
stop	Ferma gli aggiornamenti di posizione.
openSettings	Apre la pagina di impostazioni della posizione del dispositivo. Utile per dirigere gli utenti a abilitare i servizi di posizione o regolare le autorizzazioni.
setPlannedRoute	Gioca un suono nativo quando l'utente si allontana da un percorso pianificato.
setupGeofencing	Configura i valori di default per la geofence e l'invio di transizioni native facoltativo.
addGeofence	Avvia la monitoraggio di una geofence circolare su iOS e Android.
removeGeofence	Smette di monitorare una geofence identificata dall'ID.
removeAllGeofences	Smette di monitorare tutte le geofence registrate da questo plugin.
getMonitoredGeofences	Restituisce gli identificatori attualmente monitorati dal layer nativo.
addListener('geofenceTransition', ...)	Riceve eventi di ingresso e uscita dalla geofence mentre l'app è in esecuzione.
addListener('geofenceError', ...)	Riceve errori di monitoraggio della geofence nativa mentre l'app è in esecuzione.
getPluginVersion	Ottieni la versione nativa del plugin Capacitor.

Fonte di Verità

Questa documentazione è sincronizzata da src/definitions.ts in capacitor-background-geolocalizzazione.