Verwendung von @capgo/background-geolocation

Genauere Hintergrund-Geolokalisierung und native Geofencing für Capacitor-Apps auf iOS und Android. Verwenden Sie es, um präzise Standortaktualisierungen zu streamen, kreisförmige Regionen zu überwachen und Eingabe-/Ausgangsübergänge von Geofences an JavaScript oder Ihren Backend zu liefern.

Installieren

bun add @capgo/background-geolocation
bunx cap sync

Was dieses Plugin enthüllt

start - Streamen Sie genaue Vorder- oder Hintergrund-Standortaktualisierungen.
stop - Aktivieren Sie die Standortverfolgung.
openSettings - Öffnen Sie native Einstellungen, wenn Benutzer Standortberechtigungen korrigieren müssen.
setPlannedRoute - Spielen Sie ein natives Geräusch, wenn der Benutzer eine geplante Route verlässt.
setupGeofencing - Konfigurieren Sie native Geofence-Standardwerte und optionalen Übergabe-Webhooks.
addGeofence - Überwachen Sie eine kreisförmige iOS- oder Android-Geofence-Region.
removeGeofence / removeAllGeofences - Beenden Sie die Überwachung einer oder mehrerer registrierter Regionen.
getMonitoredGeofences - Liste der überwachten Regionen identifizieren.
geofenceTransition - listener - Empfange Eingabe- und Ausgabeevents, während die App aktiv ist.
geofenceError - listener - Behandle native Überwachungsfehler separat von Übergangsereignissen.

Beispiel für die Verwendung

`start`

Um die Änderungen der Geräteposition zu überwachen, rufen Sie diese Methode auf. Ein Promise wird zurückgegeben, um anzugeben, dass die Anfrage abgeschlossen ist. Der Callback wird aufgerufen, sobald eine neue Position verfügbar ist oder wenn bei der Aufrufung dieser Methode ein Fehler aufgetreten ist. Verlassen Sie sich nicht auf die Ablehnung des Versprechens für diese.

import { BackgroundGeolocation } from '@capgo/background-geolocation';

await BackgroundGeolocation.start(
  {
    backgroundMessage: "App is using your location in the background",
    backgroundTitle: "Location Service",
    requestPermissions: true,
    stale: false,
    distanceFilter: 10
  },
  (location, error) => {
    if (error) {
      console.error('Location error:', error);
      return;
    }
    if (location) {
      console.log('New location:', location.latitude, location.longitude);
    }
  }
);

`stop`

Beendet die Standortaktualisierungen.

import { BackgroundGeolocation } from '@capgo/background-geolocation';

await BackgroundGeolocation.stop();

`openSettings`

Öffnet die Einstellungen für die Geräteposition. Nützlich zum Leiten von Benutzern zu den Einstellungen für die Standortdienste oder zur Anpassung der Berechtigungen.

import { BackgroundGeolocation } from '@capgo/background-geolocation';

// Direct user to location settings
await BackgroundGeolocation.openSettings();

`setPlannedRoute`

Spielt ein Tonaufnahme, wenn der Benutzer sich von der geplanten Route entfernt. Dies sollte verwendet werden, um ein Tonaufnahme (auch im Hintergrund, nur für native) abzuspielen.

import { BackgroundGeolocation } from '@capgo/background-geolocation';

await BackgroundGeolocation.setPlannedRoute({
  soundFile: "notification.mp3",
  route: [[-74.0060, 40.7128], [-118.2437, 34.0522]]
});

Native Geofencing

Überwache Geschäftsstellen, Arbeitsplätze, Lieferzonen, Campus oder Check-in-Bereiche mit native iOS- und Android-Geofences. Fügen Sie einen HTTP- oder HTTPS- url um native code POST-Übergangspakete während der Suspendierung des WebView zu ermöglichen.

import { BackgroundGeolocation } from '@capgo/background-geolocation';

await BackgroundGeolocation.setupGeofencing({
  url: 'https://api.example.com/geofences',
  notifyOnEntry: true,
  notifyOnExit: true,
  payload: { userId: '123' },
});

await BackgroundGeolocation.addGeofence({
  identifier: 'warehouse',
  latitude: 40.7128,
  longitude: -74.006,
  radius: 200,
});

const listener = await BackgroundGeolocation.addListener(
  'geofenceTransition',
  (event) => console.log(event.identifier, event.transition),
);

const errorListener = await BackgroundGeolocation.addListener(
  'geofenceError',
  (event) => console.error(event.identifier, event.message),
);

await BackgroundGeolocation.removeGeofence({ identifier: 'warehouse' });
await listener.remove();
await errorListener.remove();

Auf Android fügen Sie ACCESS_BACKGROUND_LOCATION zur App-Manifest hinzufügen, nur wenn Sie Hintergrund-Geofencing benötigen:

<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

Vollständige Referenz

GitHub: https://github.com/Cap-go/capacitor-hintergrund-geolocation/
Dokumentation: /docs/plugins/hintergrund-geolocation/

Weitermachen von Using @capgo/hintergrund-geolocation

Wenn Sie @__CAPGO_KEEP_0__/hintergrund-geolocation verwenden Using @capgo/hintergrund-geolocation Um native Plugin-Arbeit zu planen, verbinden Sie es mit @__CAPGO_KEEP_0__/hintergrund-geolocation @capgo/hintergrund-geolocation für die Implementierungsdetails in @capgo/hintergrund-geolocation Getting Started Für die Implementierungsdetails in Getting Started, Capgo Plugin-Verzeichnis Für den Produktworkflow in Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo Für die Implementierungsdetails in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren Für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.

Hintergrund-Geolokalisierung

Tutorial zur Hintergrund-Ortung