Skip to content

@capgo/배경 위치 추적

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

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

핵심 기능

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 기능을 사용하는 @capgo/background-geolocation Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리에서 제품 워크플로우 Capacitor 플러그인들에 의해 Capgo Capacitor 플러그인들에 의해 Capgo의 implementation detail 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 implementation detail, 그리고 아이오닉 엔터프라이즈 플러그인 대안 아이오닉 엔터프라이즈 플러그인 대안의 제품 워크플로우