Saltare al contenuto

@capgo/background-geolocation

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

Usa @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.

  • start - Fornisci aggiornamenti di posizione precisi in primo piano o in background.
  • stop - Fermare il tracciamento di posizione attivo 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 valori predefiniti di geofence nativi e la consegna facoltativa di webhook per transizioni.
  • addGeofence - Monitora una regione di geofence circolare di iOS o Android tramite identificatore.
  • removeGeofence / removeAllGeofences - Fermare il monitoraggio di uno o tutti i geofence registrati.
  • getMonitoredGeofences - Elenco degli identificatori di regione attualmente monitorati dal layer nativo.
  • geofenceTransition listener - Ricevi eventi di ingresso e uscita mentre l'app è attiva.
  • geofenceError listener - Gestisci gli errori di monitoraggio nativo senza modificare la forma degli eventi di transizione.
MetodoDescrizione
startFlussi di aggiornamento della posizione in primo piano o in background con alta accuratezza.
stopSospende gli aggiornamenti della posizione.
openSettingsApre 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 facoltativo di POST di transizione nativa.
addGeofenceInizia a monitorare un cerchio di geofencing su iOS e Android.
removeGeofenceSmette di monitorare un geofence con l'identificatore.
removeAllGeofencesSmette di monitorare tutti i geofence registrati da questo plugin.
getMonitoredGeofencesRestituisce gli identificatori attualmente monitorati dal layer nativo.
addListener('geofenceTransition', ...)Riceve eventi di ingresso e uscita dal geofence mentre l'app è in esecuzione.
addListener('geofenceError', ...)Riceve errori di monitoraggio del geofence nativo mentre l'app è in esecuzione.
getPluginVersionOttieni la versione nativa del plugin Capacitor.

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

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