Saltare al contenuto

@capgo/background-geolocation

Rilevamento di posizione di background preciso, eventi di ingresso/uscita geofence nativi e webhook di transizione per le app Capacitor.

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 le transizioni dei geofence quando il WebView è sospeso.

  • start - Flusso di aggiornamenti di posizione precisi in primo piano o in background.
  • stop - Arresto del tracking di posizione attivo in modo pulito.
  • openSettings - Invio degli utenti alle impostazioni di posizione native quando sono necessarie attenzioni sulle autorizzazioni.
  • setPlannedRoute - Riproduzione di un suono nativo quando l'utente si allontana da una rotta pianificata.
  • setupGeofencing - Configurazione dei default dei geofence nativi e consegna facoltativa di webhook per le transizioni.
  • addGeofence - Monitora una regione circolare iOS o Android per identificatore.
  • removeGeofence / removeAllGeofences - Fermare la registrazione di una o tutte le regioni geografiche registrate.
  • getMonitoredGeofences - Elencare gli identificatori delle regioni attualmente monitorate dal layer nativo.
  • geofenceTransition listener - Ricevi eventi di ingresso e uscita mentre l'app è attiva.
  • geofenceError listener - Gestisci gli errori di monitoraggio nativo senza alterare la forma degli eventi di transizione.
MetodoDescrizione
startFornisce aggiornamenti di posizione precisi in primo piano o in background.
stopFerma gli aggiornamenti di posizione.
openSettingsApri la pagina di impostazioni della posizione del dispositivo. Utile per dirigere gli utenti a abilitare i servizi di posizione o regolare le autorizzazioni.
setPlannedRouteGioca un suono nativo quando l'utente si allontana da una rotta pianificata.
setupGeofencingConfigura i valori di default per la geofence e l'invio di transizioni native facoltativo.
addGeofenceAvvia la monitoraggio di una geofence circolare su iOS e Android.
removeGeofenceSmette di monitorare una geofence identificata da un ID.
removeAllGeofencesSmette di monitorare tutte le geofence registrate da questo plugin.
getMonitoredGeofencesRestituisce 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.
getPluginVersionOttieni la versione nativa del plugin Capacitor.

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

Se stai utilizzando @capgo/background-geolocalizzazione per pianificare il lavoro del plugin nativo, connettilo con Utilizza @capgo/background-geolocalizzazione per la capacità nativa in Utilizza @capgo/background-geolocalizzazione, Directory dei plugin Capgo per il flusso di lavoro del prodotto in Directory dei plugin Capgo Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugin da Capgo, Aggiungere o Aggiornare Plugin per i dettagli di implementazione in Aggiungere o Aggiornare Plugin, e Alternative per Plugin Enterprise Ionic per il workflow del prodotto in Alternative per Plugin Enterprise Ionic.