Windows.Devices.Geolocation.Geofencing 네임스페이스

지오펜스는 지리적 지점 주변의 가상 영역입니다. 지오펜싱 API를 사용하면 애플리케이션이 디바이스 리소스를 지속적으로 실행하고 사용할 필요 없이 지리적으로 상황에 맞는 환경을 적시에 제공할 수 있습니다. 지오펜싱을 사용하면 사용자가 직장이나 집을 떠날 때 미리 알림을 표시하거나 사용자가 매장 범위 내에 있을 때 쿠폰을 표시하는 등의 시나리오를 사용할 수 있습니다.

앱은 사용자가 지오펜스에 들어오거나 나갈 때 트리거하는 것과 같이 관심 영역(지오펜스) 및 해당 트리거 조건을 정의합니다. 마지막으로, 트리거 조건이 충족될 때 알림을 받도록 앱이 등록됩니다. Windows 및 Windows Phone 앱당 수백 개의 지오펜스를 지원합니다. 운영 체제는 모든 앱에 대한 지오펜스 추적을 효율적으로 관리합니다. 하나 이상의 지오펜스에 대한 트리거 조건이 충족되면 연결된 앱이 적극적으로 실행되지 않는 경우에도 경고가 표시됩니다. 이 대용량, 전원 인식, 적응형 지오펜스 추적 시스템을 사용하면 위치 트리거 기능을 앱에 쉽고 빠르게 추가할 수 있습니다.

지오펜싱 사용에 대한 전체 가이드는 지오펜싱, 완료 시작을 참조하세요.

지오펜싱 API를 사용하면 앱에서 다음을 수행할 수 있습니다.

• 하나 이상의 지오펜스 또는 관심 영역을 만듭니다.
• 디바이스가 지오펜스에 들어갈 때 알림을 요청합니다.
• 디바이스가 지오펜스를 떠날 때 알림을 요청합니다.
• 지오펜스가 활성 상태인 기간을 지정합니다.
• 각 지오펜스에 대한 체류 시간을 지정합니다. 알림이 트리거되기 전에 디바이스가 지오펜스에 있거나 지오펜스 외부에 있어야 하는 시간입니다.
• 앱의 모니터링되는 지오펜스 컬렉션에서 지오펜스를 동적으로 추가하고 제거합니다.
• 앱이 활성화된 동안 지오펜스 이벤트를 받습니다.
• 앱의 지오펜스 중 하나의 상태가 변경되면 백그라운드 작업을 시작하도록 시스템에 등록합니다. 백그라운드 작업이 실행되기 전에 앱에서 RequestAccessAsync 를 호출해야 합니다.
• 시뮬레이터를 사용하여 디바이스 이동을 시뮬레이션하고 앱의 지오펜싱 기능을 테스트합니다.

지오펜스 중 하나에 대한 트리거 조건이 충족될 때 백그라운드에서 앱을 시작하려면 백그라운드 작업을 사용하고 LocationTrigger 를 설정하여 실행해야 합니다.

중요

Windows 10 사용자 위치에 액세스하기 전에 Geolocator 개체의 RequestAccessAsync 메서드를 호출합니다. 이때 앱이 포그라운드에 있어야 하고 RequestAccessAsync가 UI 스레드에서 호출되어야 합니다. 사용자가 자신의 위치에 액세스할 수 있는 권한을 앱에 부여할 때까지 앱은 위치 데이터에 액세스할 수 없습니다.

클래스

Geofence	모니터링할 지오펜스(지리적 관심 영역)를 정의하는 기능이 포함되어 있습니다.
GeofenceMonitor	모니터링되는 지오펜스 개체에 대한 정보를 포함합니다.
GeofenceStateChangeReport	지오펜스의 상태 변경에 대한 정보를 포함합니다.

열거형

GeofenceMonitorStatus	GeofenceMonitor의 현재 상태를 나타냅니다.
GeofenceRemovalReason	지오펜스가 제거된 이유를 나타냅니다.
GeofenceState	지오펜스의 현재 상태를 나타냅니다.
MonitoredGeofenceStates	시스템에서 현재 모니터링 중인 지오펜스의 상태 또는 상태를 나타냅니다.

설명

지오펜싱이 작동하려면 위치 서비스를 실행해야 합니다. 이 서비스를 사용하지 않도록 설정하면 지오펜싱 호출이 실패하고 예외가 throw됩니다.

앱은 지오펜싱을 사용하려면 앱 매니페스트에서 위치 기능을 선언해야 합니다.