Mit @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 Geofängen 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-Ortungsaktualisierungen.
stop - Aktiven Standort-Tracking stoppen.
openSettings - Öffnen Sie native Einstellungen, wenn Benutzer Standortberechtigungen korrigieren müssen.
setPlannedRoute - Spielen Sie eine native Tondatei, wenn der Benutzer eine geplante Route verlässt.
setupGeofencing - Konfigurieren Sie native Geofence-Standardwerte und optionalen Übergabe-Webhook-Delivery.
addGeofence - Überwachen Sie eine kreisförmige iOS- oder Android-Geofence-Region.
removeGeofence / removeAllGeofences - Überwachen Sie eine oder alle registrierten Regionen.
getMonitoredGeofences - Liste der überwachten Regionen identifizieren.
geofenceTransition - listener - Empfangen von Eingabe- und Ausgabeevents, während die App aktiv ist.
geofenceError - listener - Behandeln Sie native Überwachungsfehler separat von Übergangsevents.

- Beispielverwendung

`start`

- Um die Änderungen in 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 dies.

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 für die Anleitung der Benutzer, die Standortdienste zu aktivieren oder die Berechtigungen anzupassen.

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

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

`setPlannedRoute`

- Spielt ein Tonaufnahmefile ab, wenn der Benutzer sich von der geplanten Route entfernt. Dies sollte verwendet werden, um ein Tonaufnahmefile (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

- Überwachen Sie Geschäftsstellen, Arbeitsplätze, Lieferzonen, Campus oder Check-in-Bereiche mit native iOS- und Android-Geofences. Fügen Sie ein HTTP- oder HTTPS- url - um native code POST-Übergangspakete während der Suspendierung des WebViews 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();

- Fügen Sie auf Android ACCESS_BACKGROUND_LOCATION zur App-Manifest hinzufügen, 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 Verwendung von @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 for the implementation detail in @capgo/background-geolocation, Wenn Sie @__CAPGO_KEEP_0__/hintergrund-geolocation verwenden Für die Implementierungsdetails in Getting Started, Capgo Plugin-Verzeichnis Für die 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

Anleitung zu Hintergrund-Ortung