Geolocator.GetGeopositionHistoryAsync 方法

  • 参考

定义

命名空间:
Windows.Devices.Geolocation

重载

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))

参数

startTime
DateTime DateTimeOffset

表示要为其返回位置的时间跨度开始。

duration
TimeSpan TimeSpan

表示 startTime 之后要返回位置的时间长度。

返回

IAsyncOperation<IVectorView<Geoposition>>

IAsyncOperation<IReadOnlyList<Geoposition>>

在指定时间跨度内收集的 地理定位) 类型的位置 (。

属性
OverloadAttribute RemoteAsyncAttribute

Windows 要求

应用功能
locationHistory location

注解

仅返回 startTime 后的指定持续时间内收集的位置。

另请参阅

适用于