Skip to content

@capgo/배경 위치 추적

Capacitor 앱을 위한 정확한 배경 위치 추적, 네이티브 지오펜스 진입/이탈 이벤트 및 전환 웹 훅.

사용 @capgo/background-geolocation Capacitor 앱이 전면 또는 후면에서 정확한 위치 업데이트, iOS 및 Android에서 네이티브 circular geofences, WebView가 중단된 경우 geofence 전환에 대한 백엔드 전달이 필요할 때.

핵심 기능

Core Capabilities
  • start 정확한 전면 또는 배경 위치 업데이트 스트리밍
  • stop 활성 위치 추적을 정리합니다.
  • openSettings 권한이 필요한 경우 사용자를 원본 위치 설정으로 안내합니다.
  • setPlannedRoute 사용자가 계획된 경로에서 벗어났을 때 원본 음성 재생
  • setupGeofencing 원본 지오펜스 기본값 구성 및 선택적 전환 웹후크 전달
  • addGeofence iOS 또는 Android 지오펜스 circular 지역을 식별자로 모니터링
  • removeGeofence / removeAllGeofences 등록된 지오펜스 중 하나 또는 모두 중지
  • getMonitoredGeofences 현재 원본层에서 모니터링 중인 지역 식별자 목록
  • geofenceTransition listener - 앱이 활성화된 동안 입장 및 출입 이벤트 수신
  • geofenceError listener - 전환 이벤트 형태를 변경하지 않고 원본 모니터링 오류 처리

Public API

공개 API
메서드설명
start정확한 전면 또는 배경 위치 업데이트 스트림을 제공합니다.
stop위치 업데이트 중단
openSettings장치의 위치 설정 페이지를 엽니다. 사용자에게 위치 서비스를 활성화하거나 권한을 조정하도록 안내하는 데 유용합니다.
setPlannedRoute사용자가 계획된 경로에서 벗어날 때 원생 음성 재생
setupGeofencing지오펜스 기본값을 구성하고 옵션적인 원생 전환 POST 전달
addGeofenceiOS 및 Android에서 원형 지오펜스를 모니터링 시작
removeGeofence지오펜스 하나를 식별자로 중단
removeAllGeofences이 플러그인에 의해 등록된 모든 지오펜스를 중단
getMonitoredGeofences현재 원생层에서 모니터링하는 식별자를 반환
addListener('geofenceTransition', ...)앱이 살아 있는 동안 지오펜스 입장 및 출입 이벤트를 받습니다.
addListener('geofenceError', ...)앱이 살아 있는 동안 네이티브 지오펜스 모니터링 오류를 받습니다.
getPluginVersionCapacitor 네이티브 플러그인 버전을 가져옵니다.

이 참조는 src/definitions.ts in capacitor-background-geolocation.

capgo/background-geolocation에서 계속 진행하세요.

‘capgo/background-geolocation에서 계속 진행하세요.’ 섹션

만약에 @capgo/background-geolocation을 사용하고 있다면 native 플러그인 작업을 계획하기 위해, 그것을 연결하세요. Using @capgo/background-geolocation native 기능을 위한 Using @capgo/background-geolocation Capgo 플러그인 디렉토리 제품 워크플로우를 위한 Capgo 플러그인 디렉토리 Capacitor 플러그인들에 의해 Capgo implementation 세부 정보를 위한 Capacitor 플러그인들에 의해 Capgo 플러그인 추가 또는 업데이트 implementation 세부 정보를 위한 플러그인 추가 또는 업데이트, 그리고 Ionic Enterprise 플러그인 대체 제품 워크플로우를 위한 Ionic Enterprise 플러그인 대체.