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

指定した期間に収集された位置 ( Geoposition 型)。

属性: OverloadAttribute RemoteAsyncAttribute

Windows の要件

アプリの機能

locationHistory location

注釈

GetGeopositionHistoryAsync メソッドを使用すると、アプリは、位置情報サービスによって収集された位置のリストを非同期的にフェッチできます。指定した startTime 以降に収集された位置のみが返されます。その期間から使用可能な位置がない場合は、空のリストが返されます。

このメソッドは、過去 24 時間以内に位置情報サービスによって既に収集された位置のみを返します。新しいポジションは解決されません。この 24 時間の期間を超える期間を指定しても、追加の位置は生成されません。

位置情報サービスは、アプリまたはサービスがユーザーの場所を照会する場合にのみ位置を収集しますが、1 秒に 1 回しか収集しません。ロケーション履歴は3600ポジションに制限されています。場所履歴がユーザーによってクリアされない場合、各位置は 1 から 24 時間の間に場所履歴に格納されます。

注意

バックグラウンドタスクを使用してこのメソッドを頻繁に呼び出す場合は、バッテリーに与える影響を考慮することが重要です。この方法では GPS レシーバーはトリガーされませんが、バックグラウンドタスクを実行するにはプロセッサリソースが必要です。

こちらもご覧ください

適用対象

GetGeopositionHistoryAsync(DateTime, TimeSpan)

編集

デバイスの場所履歴を取得する非同期操作を開始します。

注意

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