次の方法で共有


Geolocator.GetGeopositionHistoryAsync メソッド

定義

オーバーロード

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

位置を返す期間の先頭を表します。

戻り値

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

属性

Windows の要件

アプリの機能
locationHistory location

注釈

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

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

位置情報サービスは、アプリまたはサービスがユーザーの場所を照会する場合にのみ位置を収集しますが、1 秒に 1 回しか収集しません。 ロケーション履歴は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 の 後の時間の長さを表します。

戻り値

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

属性

Windows の要件

アプリの機能
locationHistory location

注釈

startTime の後の指定した期間に収集された位置のみが返されます。

こちらもご覧ください

適用対象