共用方式為


Windows.Devices.Geolocation.Geofencing 命名空間

地理柵欄是地理點周圍的虛擬區域。 地理柵欄 API 可讓應用程式及時提供地理內容相關體驗,而不需要應用程式持續執行及取用裝置資源。 地理柵欄可讓使用者在離開工作或住家時,或當使用者在商店範圍內時顯示優待券等案例,

應用程式會定義 (地理柵欄的區域) 和對應的觸發條件,例如當使用者進入或離開地理柵欄時觸發。 最後,應用程式會註冊,以在符合觸發條件時收到通知。 Windows 和Windows Phone每個應用程式支援數百個地理柵欄。 作業系統會有效率地管理所有應用程式的地理柵欄追蹤。 當符合一或多個地理柵欄的觸發條件時,即使未主動執行,相關聯的應用程式也會發出警示。 這個高容量、電源感知、自適性地理柵欄追蹤系統可讓您快速且輕鬆地將位置觸發的功能新增至您的應用程式。

如需使用地理柵欄的完整指南,請參閱 地理柵欄,開始完成

地理柵欄 API 可讓您的應用程式執行下列動作:

  • 建立一或多個地理柵欄,或感興趣的區域。
  • 要求在裝置進入地理柵欄時收到通知。
  • 要求在裝置離開地理柵欄時收到通知。
  • 指定地理柵欄作用中的時間範圍。
  • 指定每個地理柵欄的停留時間 - 觸發通知之前,裝置應該在地理柵欄內或離開地理柵欄的時間量。
  • 從您應用程式的受監視地理柵欄集合中動態新增和移除地理柵欄。
  • 在應用程式作用中時接收地理柵欄事件。
  • 當其中一個應用程式地理柵欄的狀態變更時,向系統註冊以啟動背景工作。 應用程式必須先呼叫 RequestAccessAsync ,才能執行任何背景工作。
  • 使用模擬器來模擬裝置移動,並測試應用程式的地理柵欄功能。

如果您想要在符合其中一個地理柵欄的觸發條件時,在背景啟動您的應用程式,您需要使用背景工作並設定 LocationTrigger 來啟動它。

重要

從 Windows 10 開始,請先呼叫Geolocator物件的RequestAccessAsync方法,再存取使用者的位置。 此時,您的 app 必須在前景,且 RequestAccessAsync 必須是從 UI 執行緒呼叫。 在使用者授與應用程式存取其位置的許可權之前,您的應用程式無法存取位置資料。

類別

Geofence

包含用來定義地理柵欄的功能, (要監視的地理區域) 。

GeofenceMonitor

包含受監視 地理柵 欄物件的相關資訊。

GeofenceStateChangeReport

包含 Geofence狀態變更的相關資訊。

列舉

GeofenceMonitorStatus

指出 GeofenceMonitor的目前狀態。

GeofenceRemovalReason

指出 移除地理柵 欄的原因。

GeofenceState

表示 Geofence的目前狀態。

MonitoredGeofenceStates

指出系統目前正在監視之 Geofences 的狀態。

備註

位置服務必須執行,才能讓地理柵欄運作。 如果停用此服務,地理柵欄呼叫將會失敗並擲回例外狀況。

您的應用程式必須在應用程式資訊清單中宣告位置功能,才能使用地理柵欄。