Zum Inhalt springen

@capgo/background-geolocation

Präzises Background-Location-Tracking, native Geofence-Enter/Exit-Events und Transition-Webhooks für Capacitor Apps.

Nutzt @capgo/background-geolocation Wenn deine Capacitor App präzise Standort-Updates im Vorder- oder Hintergrund benötigt, bietet dieser Plugin native kreisförmige Geofences für iOS und Android sowie Backend-Benachrichtigungen für Geofence-Übergänge, wenn die WebView pausiert ist.

  • start - Präzise Standort-Updates im Vorder- oder Hintergrund streamen.
  • stop - Aktives Location-Tracking sauber beenden.
  • openSettings - Nutzer zu den nativen Standorteinstellungen leiten, wenn Berechtigungen angepasst werden müssen.
  • setPlannedRoute - Einen nativen Sound abspielen, wenn der Nutzer von einer geplanten Route abweicht.
  • setupGeofencing - Native Geofence-Defaults und optionale Webhook-Zustellung für Übergänge konfigurieren.
  • addGeofence - Eine kreisförmige iOS- oder Android-Geofence-Region anhand einer ID überwachen.
  • removeGeofence / removeAllGeofences - Überwachung einer oder aller registrierten Geofences stoppen.
  • getMonitoredGeofences - Liste der Region-IDs, die aktuell vom Native Layer überwacht werden.
  • geofenceTransition listener - Empfängt Enter- und Exit-Events, während die App aktiv ist.
  • geofenceError listener - Behandelt native Monitoring-Fehler, ohne das Format der Transition-Events zu ändern.
MethodeBeschreibung
startLiefert präzise Standort-Updates im Foreground oder Background.
stopStoppt die Standort-Updates.
openSettingsÖffnet die Standorteinstellungen des Geräts. Hilfreich, um Nutzer zum Aktivieren von Standortdiensten oder zum Anpassen von Berechtigungen zu leiten.
setPlannedRouteSpielt einen nativen Sound ab, wenn der Nutzer von einer geplanten Route abweicht.
setupGeofencingKonfiguriert Geofence-Defaults und optionale native POST-Zustellung bei Transitionen.
addGeofenceStartet das Monitoring eines kreisförmigen Geofences auf iOS und Android.
removeGeofenceStoppt das Monitoring eines Geofences anhand seiner ID.
removeAllGeofencesStoppt das Monitoring aller von diesem Plugin registrierten Geofences.
getMonitoredGeofencesGibt die IDs zurück, die aktuell von der nativen Ebene überwacht werden.
addListener('geofenceTransition', ...)Empfängt Geofence-Enter- und Exit-Events, während die App läuft.
addListener('geofenceError', ...)Empfängt native Fehler beim Geofence-Monitoring, während die App läuft.
getPluginVersionDie native Capacitor Plugin-Version abrufen.

Diese Referenz wird synchronisiert von src/definitions.ts in capacitor-background-geolocation.

Wenn du es nutzt @capgo/background-geolocation Um die Arbeit an nativen Plugins zu planen, verbinde sie mit Verwendung von @capgo/background-geolocation für die native Funktion bei der Nutzung von @capgo/background-geolocation, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für das Implementierungsdetail beim Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow bei den Ionic Enterprise Plugin-Alternativen.