メインコンテンツにスキップ
プラグインに戻る
@capgo/capacitor-バックグラウンド地理位置
チュートリアル
@capgo/capacitor-バックグラウンド地理位置

バックグラウンド地理位置

ネイティブiOSとAndroidの地理位置追跡、背景の地理位置フェンス、Webhookのトランジション

ガイド

バックグラウンド地理位置のチュートリアル

デバイスでテスト

Download the Capgo app, then scan the QR code.

バックグラウンド地理位置プラグインプレビューQR code

@capgo/バックグラウンド地理位置を使用

iOSとAndroid用のCapacitorアプリ向けの正確なバックグラウンド地理位置とネイティブのジオフェンス機能。JavaScriptまたはバックエンドに精度の高い位置更新をストリームし、円形の地域を監視し、JavaScriptまたはバックエンドにジオフェンスのエントリ/エクスィットトランジションを送信するために使用します。

インストール

bun add @capgo/background-geolocation
bunx cap sync

このプラグインが公開するもの

  • start - 正確な前景またはバックグラウンドの位置更新をストリームする。
  • stop - アクティブな位置追跡を停止する。
  • openSettings - ユーザーが位置許可を修正する必要があるときに、ネイティブの設定を開く。
  • setPlannedRoute - ユーザーが計画ルートを離れたときにネイティブの音を再生する。
  • setupGeofencing - ネイティブのジオフェンスのデフォルトを構成し、オプションのトランジションWebhookの送信を有効にする。
  • addGeofence - iOSまたはAndroidの円形のジオフェンス地域を監視する。
  • removeGeofence / removeAllGeofences - 一部またはすべての登録地域を停止する。
  • getMonitoredGeofences - バータルに参室、参室できる。
  • geofenceTransition listener - デシアインにしたたいにきる。
  • geofenceError listener - バータルに当前をいますできる。

メイアターバータル

start

デシアインを得したたいにきる。デシアインにしたたいできる。デシアインにしたたいできる。

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

デシアインを昐期。バータルにいますできる。バータルにいますできる。

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

await BackgroundGeolocation.stop();

openSettings

バータルにバータルを定义。バータルにいますできる。デシアインにしたたいできる。

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

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

setPlannedRoute

バータルにバータルを昐期。バータルにいますできる。

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

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

バータルにバータルを定义。バータルにいますできる。

バータルにバータルを定义。バータルにいますできる。 url to let native code POST transition payloads while the WebView is suspended.

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();

バータルにバータルを定义。バータルにいますできる。 ACCESS_BACKGROUND_LOCATION あなたのアプリのマニフェストに背景地理位置を有効にするには、次のステップを実行してください:

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

フルリファレンス

次のステップから続けてください: @capgo/background-geolocationを使用しています

@__CAPGO_KEEP_0__/background-geolocationを使用してください 背景地理位置を有効にするには、@capgo/background-geolocationを使用してください 背景地理位置を有効にするには、@__CAPGO_KEEP_0__/background-geolocationを使用してください 背景地理位置を有効にするには、@capgo/background-geolocationを使用してください 背景地理位置を有効にするには、@capgo/background-geolocationを使用してください 背景地理位置を有効にするには、@__CAPGO_KEEP_0__/background-geolocationを使用してください Capacitor Background Geolocationプラグインの実装詳細については、Getting Startedを参照してください。 Capgo プラグインディレクトリ Capacitor Background Geolocationプラグインの製品ワークフローについては、Capgo プラグインディレクトリを参照してください。 Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, and プラグインの追加または更新 プラグインの追加または更新の実装詳細については、プラグインの追加または更新を参照してください。