Freigeben über

Geolocator.GetGeopositionAsync Methode

  • Referenz

Definition

Namespace:
Windows.Devices.Geolocation

Überlädt

GetGeopositionAsync()

Startet einen asynchronen Vorgang, um den aktuellen Standort des Geräts abzurufen.
GetGeopositionAsync(TimeSpan, TimeSpan)

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

GetGeopositionAsync()

Bearbeiten

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

public:
 virtual IAsyncOperation<Geoposition ^> ^ GetGeopositionAsync() = GetGeopositionAsync;
/// [Windows.Foundation.Metadata.Overload("GetGeopositionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<Geoposition> GetGeopositionAsync();
[Windows.Foundation.Metadata.Overload("GetGeopositionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<Geoposition> GetGeopositionAsync();
function getGeopositionAsync()
Public Function GetGeopositionAsync () As IAsyncOperation(Of Geoposition)

Gibt zurück

IAsyncOperation<Geoposition>

Ein asynchroner Vorgang, der nach Abschluss eine Geoposition zurückgibt, die den gefundenen Speicherort markiert.

Attribute
OverloadAttribute RemoteAsyncAttribute

Windows-Anforderungen

App-Funktionen
location ID_CAP_LOCATION [Windows Phone]

Hinweise

Diese Methode löst eine Ausnahme aus, wenn die App nicht über Standortberechtigungen verfügt oder ein Zeitüberschreitung ohne abgerufene Standortdaten auftritt. Daher sollte die -Methode in einer try/catch-Anweisung aufgerufen werden, damit diese häufigen Ausnahmefälle behandelt werden können.

Bei dieser Methode wird nach 60 Sekunden ein Zeitüberschreitungsout ausgeführt, mit Ausnahme von "Verbundener Standbymodus". Während des verbundenen Standbys können Geolocator-Objekte instanziiert werden, aber das Geolocator-Objekt findet keine Sensoren zum Aggregieren, und bei Aufrufen von GetGeopositionAsync wird nach 7 Sekunden ein Timeout ausgeführt. Nach dem Timeout werden die StatusChanged-Ereignislistener einmal mit dem NoData-status aufgerufen, und die PositionChanged-Ereignislistener werden nie aufgerufen.

Der Benutzer legt den Schutz seiner Positionsdaten über Datenschutzeinstellungen für den Standort in der App Einstellungen fest. Die App kann nur unter folgenden Voraussetzungen auf die Position des Benutzers zugreifen:

  • Standort für dieses Gerät...aktiviert ist (gilt nicht für Windows 10 Mobile)
  • Die Einstellung Position der Positionsdienste ist aktiviert.
  • Ihre App hat unter Wählen Sie Apps aus, die Ihre Position verwenden dürfen die Einstellung Ein.

Wichtig

Rufen Sie ab Windows 10 die RequestAccessAsync-Methode auf, bevor Sie auf den Speicherort des Benutzers zugreifen. Zu diesem Zeitpunkt muss sich Ihre App im Vordergrund befinden, und RequestAccessAsync muss vom UI-Thread aufgerufen werden. Ihre App kann dann den Fall ohne Berechtigungen behandeln, ohne eine Ausnahme zu auslösen.

Weitere Informationen

Gilt für:

GetGeopositionAsync(TimeSpan, TimeSpan)

Bearbeiten

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

public:
 virtual IAsyncOperation<Geoposition ^> ^ GetGeopositionAsync(TimeSpan maximumAge, TimeSpan timeout) = GetGeopositionAsync;
/// [Windows.Foundation.Metadata.Overload("GetGeopositionAsyncWithAgeAndTimeout")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<Geoposition> GetGeopositionAsync(TimeSpan const& maximumAge, TimeSpan const& timeout);
[Windows.Foundation.Metadata.Overload("GetGeopositionAsyncWithAgeAndTimeout")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<Geoposition> GetGeopositionAsync(System.TimeSpan maximumAge, System.TimeSpan timeout);
function getGeopositionAsync(maximumAge, timeout)
Public Function GetGeopositionAsync (maximumAge As TimeSpan, timeout As TimeSpan) As IAsyncOperation(Of Geoposition)

Parameter

maximumAge
TimeSpan TimeSpan

Das maximal zulässige Alter von zwischengespeicherten Standortdaten. Ein TimeSpan ist ein Zeitraum, der in Einheiten von 100 Nanosekunden ausgedrückt wird.

timeout
TimeSpan TimeSpan

Timeout. Ein TimeSpan ist ein Zeitraum, der in Einheiten von 100 Nanosekunden ausgedrückt wird.

Gibt zurück

IAsyncOperation<Geoposition>

Ein asynchroner Vorgang, der nach Abschluss eine Geoposition zurückgibt, die den gefundenen Speicherort markiert.

Attribute
OverloadAttribute RemoteAsyncAttribute

Windows-Anforderungen

App-Funktionen
location ID_CAP_LOCATION [Windows Phone]

Hinweise

Ein Standort wird sofort zurückgegeben, wenn sich der neueste Standort innerhalb eines akzeptablen Alters befindet. Andernfalls wird ein Speicherort erst bei der nächsten Änderung zurückgegeben. In einigen Fällen empfängt Ihre App möglicherweise Standortdaten, die älter als der angegebene maximumAge-Wert sind. Dies liegt daran, dass ein zusätzlicher Alterswert basierend auf der gewünschten Genauigkeitseinstellung berechnet wird, und Ihre App verwendet, welches der beiden Altersstufen größer ist. Angenommen, eine Standardgenauigkeit von 500 Metern entspricht einem maximalen Alter von 30 Sekunden. In diesem Fall kann Ihre App 20 Sekunden alte Daten empfangen, auch wenn Sie maximumAge auf 10 Sekunden festlegen.

Weitere Informationen

Gilt für: