Geolocator.GetGeopositionHistoryAsync 方法

參考

定義

命名空間:: Windows.Devices.Geolocation

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

GetGeopositionHistoryAsync(DateTime)	啟動非同步作業以擷取裝置的位置歷程記錄。注意此 API 不適用於所有 Windows 應用程式。除非您的開發人員帳戶是由 Microsoft 特別布建，否則呼叫這些 API 會在執行時間失敗。
GetGeopositionHistoryAsync(DateTime, TimeSpan)	啟動非同步作業以擷取裝置的位置歷程記錄。注意此 API 不適用於所有 Windows 應用程式。除非您的開發人員帳戶是由 Microsoft 特別布建，否則呼叫這些 API 會在執行時間失敗。

GetGeopositionHistoryAsync(DateTime)

編輯

啟動非同步作業以擷取裝置的位置歷程記錄。

注意

此 API 不適用於所有 Windows 應用程式。除非您的開發人員帳戶是由 Microsoft 特別布建，否則呼叫這些 API 會在執行時間失敗。

public:
 static IAsyncOperation<IVectorView<Geoposition ^> ^> ^ GetGeopositionHistoryAsync(DateTime startTime);

/// [Windows.Foundation.Metadata.Overload("GetGeopositionHistoryAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<IVectorView<Geoposition>> GetGeopositionHistoryAsync(DateTime const& startTime);

[Windows.Foundation.Metadata.Overload("GetGeopositionHistoryAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<IReadOnlyList<Geoposition>> GetGeopositionHistoryAsync(System.DateTimeOffset startTime);

function getGeopositionHistoryAsync(startTime)

Public Shared Function GetGeopositionHistoryAsync (startTime As DateTimeOffset) As IAsyncOperation(Of IReadOnlyList(Of Geoposition))

參數

startTime: DateTime DateTimeOffset

表示要傳回位置的時間範圍開頭。

傳回

IAsyncOperation<IVectorView<Geoposition>>

IAsyncOperation<IReadOnlyList<Geoposition>>

地理位置類型 () 在指定時間範圍期間收集的位置。

屬性: OverloadAttribute RemoteAsyncAttribute

Windows 需求

應用程式功能

locationHistory location

備註

GetGeopositionHistoryAsync 方法可讓您的應用程式以非同步方式擷取位置服務所收集的位置清單。只會傳回自指定 startTime 之後收集的位置。如果該時間範圍中沒有可用的位置，則會傳回空白清單。

這個方法只會傳回過去 24 小時內由位置服務收集的位置;它不會解析新的位置。指定超過此 24 小時時間範圍的時間範圍將不會產生任何其他位置。

只有在應用程式或服務查詢使用者的位置時，位置服務才會收集位置，但每秒不會超過一次。位置歷程記錄限制為 3600 個位置;如果使用者未清除位置歷程記錄，則每個位置都會儲存在 1 到 24 小時之間的位置歷程記錄中。

注意

如果您使用背景工作經常呼叫此方法，請務必考慮對電池的影響。雖然這個方法不會觸發 GPS 接收器，但仍需要處理器資源才能執行背景工作。

另請參閱

適用於

GetGeopositionHistoryAsync(DateTime, TimeSpan)

編輯

啟動非同步作業以擷取裝置的位置歷程記錄。

注意

此 API 不適用於所有 Windows 應用程式。除非您的開發人員帳戶是由 Microsoft 特別布建，否則呼叫這些 API 會在執行時間失敗。

public:
 static IAsyncOperation<IVectorView<Geoposition ^> ^> ^ GetGeopositionHistoryAsync(DateTime startTime, TimeSpan duration);

/// [Windows.Foundation.Metadata.Overload("GetGeopositionHistoryWithDurationAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<IVectorView<Geoposition>> GetGeopositionHistoryAsync(DateTime const& startTime, TimeSpan const& duration);

[Windows.Foundation.Metadata.Overload("GetGeopositionHistoryWithDurationAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<IReadOnlyList<Geoposition>> GetGeopositionHistoryAsync(System.DateTimeOffset startTime, System.TimeSpan duration);

function getGeopositionHistoryAsync(startTime, duration)

Public Shared Function GetGeopositionHistoryAsync (startTime As DateTimeOffset, duration As TimeSpan) As IAsyncOperation(Of IReadOnlyList(Of Geoposition))