Geolocator.GetGeopositionHistoryAsync Methode

Referenz

Definition

Namespace:: Windows.Devices.Geolocation

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

GetGeopositionHistoryAsync(DateTime)	Startet einen asynchronen Vorgang, um den Standortverlauf des Geräts abzurufen. Hinweis Diese API ist nicht für alle Windows-Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.
GetGeopositionHistoryAsync(DateTime, TimeSpan)	Startet einen asynchronen Vorgang, um den Standortverlauf des Geräts abzurufen. Hinweis Diese API ist nicht für alle Windows-Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.

GetGeopositionHistoryAsync(DateTime)

Bearbeiten

Startet einen asynchronen Vorgang, um den Standortverlauf des Geräts abzurufen.

Hinweis

Diese API ist nicht für alle Windows-Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.

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

Parameter

startTime: DateTime DateTimeOffset

Stellt den Anfang der Zeitspanne dar, für die Positionen zurückgegeben werden sollen.

Gibt zurück

IAsyncOperation<IVectorView<Geoposition>>

IAsyncOperation<IReadOnlyList<Geoposition>>

Positionen (vom Typ Geoposition), die während der angegebenen Zeitspanne gesammelt wurden.

Attribute: OverloadAttribute RemoteAsyncAttribute

Windows-Anforderungen

App-Funktionen

locationHistory location

Hinweise

Mit der GetGeopositionHistoryAsync-Methode kann Ihre App asynchron eine Liste von Positionen abrufen, die von Standortdiensten erfasst wurden. Es werden nur Positionen zurückgegeben, die seit der angegebenen startTime erfasst wurden. Wenn ab dieser Zeitspanne keine Positionen verfügbar sind, wird eine leere Liste zurückgegeben.

Diese Methode gibt nur Positionen zurück, die bereits in den letzten 24 Stunden von Standortdiensten erfasst wurden. Neue Positionen werden nicht aufgelöst. Wenn Sie eine Zeitspanne angeben, die dieses 24-Stunden-Fenster überschreitet, ergeben sich keine zusätzlichen Positionen.

Standortdienste erfassen Positionen nur, wenn eine App oder Dienste den Standort des Benutzers abfragen – jedoch nicht mehr als einmal pro Sekunde. Der Standortverlauf ist auf 3600 Positionen beschränkt; wenn der Standortverlauf vom Benutzer nicht gelöscht wird, wird jede Position zwischen 1 und 24 Stunden im Standortverlauf gespeichert.

Hinweis

Wenn Sie eine Hintergrundaufgabe verwenden, um diese Methode häufig aufzurufen, ist es wichtig, die Auswirkungen zu berücksichtigen, die sich auf den Akku auswirken werden. Obwohl diese Methode den GPS-Empfänger nicht auslöst, sind dennoch Prozessorressourcen erforderlich, um die Hintergrundaufgabe auszuführen.

Weitere Informationen

Gilt für:

GetGeopositionHistoryAsync(DateTime, TimeSpan)

Bearbeiten

Startet einen asynchronen Vorgang, um den Standortverlauf des Geräts abzurufen.

Hinweis

Diese API ist nicht für alle Windows-Apps verfügbar. Sofern Ihr Entwicklerkonto nicht speziell von Microsoft bereitgestellt wird, schlagen Aufrufe dieser APIs zur Laufzeit fehl.

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