Windows.Devices.Geolocation 命名空間

提供 API 來 取得目前位置 ，或追蹤裝置一段時間的位置。 位置資訊可能來自估計來自指標的位置，例如Wi-Fi存取點和資料格塔、來自裝置的 IP 位址，或可能來自其他來源，例如 GNSS 或 GPS 裝置。 Windows.Devices.Geolocation API 提供所有可用來源中最適合的地理位置資料。

位置資訊的正確性取決於來源。 緯度和經度可能會因下列範圍而有所不同：

• GPS： 大約在 10 公尺內
• Wi-Fi： 大約 30 公尺到 500 公尺之間
• 資料格塔： 大約 300 公尺到 3，000 公尺之間
• IP 位址： 大約 1，000 公尺到 5，000 公尺之間

除了緯度和經度之外，GPS 也提供標題、速度和高度的相關資訊。 當位置資訊來自其他來源時，此額外資訊是選擇性的。

使用者可以使用 [設定] 應用程式中的 [位置隱私權設定] 來設定其位置資料的隱私權。 只有在下列情況下，您的應用程式才能存取使用者的位置：

• 此裝置的位置...開啟 (不適用於Windows 10 行動裝置版)
• 已將定位服務設定的 \[位置\] 設為 \[開啟\]
• 在 \[選擇可以使用您的位置的應用程式\] 底下，將您的 app 設為 \[開啟\]

如需位置隱私權的詳細資訊，請參閱 Windows 隱私權聲明。

重要

從 Windows 10 開始，請先呼叫RequestAccessAsync，再存取使用者的位置。 此時，您的 app 必須在前景，且 RequestAccessAsync 必須是從 UI 執行緒呼叫。 在使用者授與您的 app 存取其位置的權限之前，您的 app 將無法存取位置資料。

位置服務架構

位置服務架構的第一層是由裝置中的硬體所組成。 這包括 GPS 接收者、Wi-Fi 和行動資料無線電。 這些都可以作為位置資料的提供者，其精確度和耗電量各有不同層級。 硬體頂端是機器碼層。 此層會直接與位置資料的可用來源通訊，並根據資料的可用性和應用程式指定的效能需求，決定要使用哪些來源來判斷裝置的位置。 原生程式碼層也會透過網際網路與 Microsoft 裝載的 Web 服務通訊，以從資料庫查閱位置相關資訊。 位置服務的最上層是受控介面，會透過 Windows SDK 隨附的 DLL 公開。 應用程式會使用此介面來啟動和停止位置要求、設定應用程式所需的精確度層級，以及從原生程式碼層接收位置資料，因為它可供使用。

類別

CivicAddress	不支援的 API。
GeoboundingBox	表示定義地理區域的矩形。
Geocircle	描述具有中心點和半徑的地理圓形。
Geocoordinate	包含用來識別地理位置的資訊。
GeocoordinateSatelliteData	提供有關 Geocoordinate的其他資訊。 這項資訊僅適用于使用衛星訊號取得的位置估計值。
Geolocator	提供目前地理位置的存取權。
Geopath	表示已排序的地理點數列。
Geopoint	描述地理點。
Geoposition	表示可能包含緯度和經度資料或場地資料的位置。
Geovisit	表示 Visit 相關狀態變更。 如需如何使用此功能的資訊，請參閱 使用造訪追蹤的指導方針 。
GeovisitMonitor	當應用程式正在使用時，處理使用者的 Visits 監視， (不在背景) 。
GeovisitStateChangedEventArgs	包含 VisitStateChanged 事件的相關資訊。
GeovisitTriggerDetails	管理 Visits 相關背景工作的觸發程式詳細資料。
PositionChangedEventArgs	提供 PositionChanged 事件的資料。
StatusChangedEventArgs	提供 StatusChanged 事件的資訊。
VenueData	代表與地理位置相關聯的場地。

結構

BasicGeoposition

描述地理位置的基本資訊。

介面

IGeoshape

用來定義地理圖形的介面。

列舉

AltitudeReferenceSystem	指出定義地理圖形時要使用的高度參考系統。
GeolocationAccessStatus	指出您的應用程式是否有權存取位置資料。
GeoshapeType	表示地理區域的形狀。
PositionAccuracy	指出應用程式使用的位置資料所要求的正確性層級。
PositionSource	指出用來取得 Geocoordinate的來源。
PositionStatus	指出 Geolocator 物件提供位置資料的能力。
VisitMonitoringScope	包含值，描述要與 Visits 功能搭配使用的位置監視預定範圍。
VisitStateChange	包含描述 Visit 相關狀態變更的值。

範例

使用此命名空間類別的範例應用程式包括 地理位置範例 和 Geotag 範例。

另請參閱

• 取得目前的位置
• 設定地理柵欄
• 地理位置範例
• 地理標記範例