Vai al contenuto

@capgo/background-geolocation

Tracciamento preciso della posizione in background, eventi nativi di geofencing (enter/exit) e webhook di transizione per le app Capacitor.

Usa @capgo/background-geolocation quando la tua app Capacitor ha bisogno di aggiornamenti precisi della posizione in foreground o background, geofence circolari nativi su iOS e Android e consegna lato backend delle transizioni dei geofence quando la WebView è sospesa.

  • start - Trasmetti aggiornamenti della posizione precisi in foreground o background.
  • stop - Stop active location tracking cleanly.
  • openSettings - Inoltra gli utenti alle impostazioni native della posizione quando i permessi richiedono attenzione.
  • setPlannedRoute - Riproduci un suono nativo quando l'utente devia dal percorso pianificato.
  • setupGeofencing - Configura default dei geofence nativi e invio opzionale dei webhook di transizione.
  • addGeofence - Monitora una regione geofence circolare iOS o Android tramite identificativo.
  • removeGeofence / removeAllGeofences - Smetti di monitorare uno o tutti i geofence registrati.
  • getMonitoredGeofences - Elenca gli identificatori delle regioni attualmente monitorati dal layer nativo.
  • geofenceTransition listener - Riceve gli eventi di entrata e uscita mentre l'app è attiva.
  • geofenceError listener - Gestisce gli errori di monitoraggio nativo senza modificare la struttura dell'evento di transizione.
MetodoDescrizione
startTrasmette aggiornamenti accurati della posizione in foreground o background.
stopInterrompe gli aggiornamenti della posizione.
openSettingsApre la pagina delle impostazioni di localizzazione del dispositivo. Utile per guidare gli utenti nell’attivazione dei servizi di localizzazione o nella modifica dei permessi.
setPlannedRouteRiproduce un suono nativo quando l'utente devia da un percorso pianificato.
setupGeofencingConfigura i default delle geofence e la consegna POST opzionale delle transizioni native.
addGeofenceAvvia il monitoraggio di una geofence circolare su iOS e Android.
removeGeofenceInterrompe il monitoraggio di un geofence tramite identificativo.
removeAllGeofencesInterrompe il monitoraggio di tutte le geofence registrate da questo plugin.
getMonitoredGeofencesRestituisce 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.
getPluginVersionOttieni la versione nativa del plugin Capacitor.

Questo riferimento è sincronizzato da src/definitions.ts nella capacitor-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.