배경 위치 추적을 사용하는 방법: @capgo/background-geolocation

Capacitor 앱에서 iOS 및 Android에서 정확한 배경 위치 추적 및 네이티브 지오펜싱. 위치 업데이트를 스트리밍하고, 원형 영역을 모니터링하고, JavaScript 또는 백엔드에 지오펜스 입/출입 전환을 전달하세요.

설치

bun add @capgo/background-geolocation
bunx cap sync

이 플러그인에 노출된 항목

start - 정확한 전면 또는 배경 위치 업데이트를 스트리밍합니다.
stop - 활성 위치 추적을 중지합니다.
openSettings - 사용자가 위치 권한을 수정해야 할 때 native 설정을 열어줍니다.
setPlannedRoute - 사용자가 계획된 경로를 떠났을 때 native 사운드 재생합니다.
setupGeofencing - 기본 지오펜스 설정과 옵션 전환 웹 훅 전달을 구성합니다.
addGeofence - iOS 또는 Android 지오펜스圆형 영역을 모니터링합니다.
removeGeofence / removeAllGeofences - 등록된 영역 중 하나 또는 모든 영역을 모니터링 중지합니다.
getMonitoredGeofences - 모니터링 중인 영역 식별자 목록을 표시합니다.
geofenceTransition listener - 앱이 활성화된 동안 입장 및 출입 이벤트를 받습니다.
geofenceError listener - 네이티브 모니터링 오류를 전환 이벤트와 별도로 처리합니다.

예시 사용

`start`

앱이 위치를 변경하는 변경 사항을 듣기 시작하려면 이 메서드를 호출하세요. Promise가 반환되어 호출이 완료되었음을 나타내며 callback은 새로운 위치가 사용 가능한 경우 또는 이 메서드를 호출할 때 오류가 발생한 경우 호출됩니다. 이 메서드의 호출에 대한 약속 거부에 의존하지 마세요.

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]]
});

네이티브 지오펜싱

iOS와 Android 기지국을 사용하여 매장, 일자리, 배송 구역, 캠퍼스, 또는 체크인 지역을 모니터링하세요. 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();

WebView가 중단된 동안 __CAPGO_KEEP_0__의 POST 전환 패킷을 허용하세요. ACCESS_BACKGROUND_LOCATION Android에서만 사용할 때만 앱 매니페스트에

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

배경 기지국 기능을 사용하려면

GitHub: https://github.com/Cap-go/capacitor-background-geolocation/
https://__CAPGO_KEEP_0__.com/Cap-go/__CAPGO_KEEP_1__-배경-기지국-위치/

배경 위치 추적

__CAPGO_KEEP_0__ 배경 위치 추적 튜토리얼