Geolocator.GetGeopositionAsync Méthode

Définition

Surcharges

GetGeopositionAsync()

Démarre une opération asynchrone pour récupérer l’emplacement actuel de l’appareil.

GetGeopositionAsync(TimeSpan, TimeSpan)

Démarre une opération asynchrone pour récupérer l’emplacement actuel de l’appareil.

GetGeopositionAsync()

Démarre une opération asynchrone pour récupérer l’emplacement actuel de l’appareil.

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)

Retours

Opération asynchrone qui, une fois terminée, retourne une géoposition marquant l’emplacement trouvé.

Attributs

Configuration requise pour Windows

Fonctionnalités de l’application
location ID_CAP_LOCATION [Windows Phone]

Remarques

Cette méthode lève une exception si l’application n’a pas d’autorisations d’emplacement ou si elle expire sans données d’emplacement récupérées. Par conséquent, la méthode doit être appelée dans une instruction try/catch afin que ces cas d’exception courants puissent être gérés.

Cette méthode expire après 60 secondes, sauf en cas de veille connectée. Pendant la veille connectée, les objets Geolocator peuvent être instanciés, mais l’objet Geolocator ne trouve aucun capteur à agréger et les appels à GetGeopositionAsync expirent après 7 secondes. À l’expiration du délai, les écouteurs d’événements StatusChanged seront appelés une seule fois avec le status NoData, et les écouteurs d’événements PositionChanged ne seront jamais appelés.

L’utilisateur définit la confidentialité de ses données d’emplacement avec les paramètres de confidentialité d’emplacement de l’application Paramètres. Votre application peut accéder à l’emplacement de l’utilisateur dans les cas suivants uniquement :

  • Emplacement de cet appareil... est activé (non applicable à Windows 10 Mobile)
  • Le paramètre des services de localisation Emplacement est activé.
  • Sous Choisir les applications qui peuvent utiliser votre emplacement, votre application est activée.

Important

À partir de Windows 10, appelez la méthode RequestAccessAsync avant d’accéder à l’emplacement de l’utilisateur. À ce stade, votre application doit être au premier plan et l’élément RequestAccessAsync doit être appelé à partir du thread d’interface utilisateur. Votre application peut ensuite gérer le cas de non-autorisations sans lever d’exception.

Voir aussi

S’applique à

GetGeopositionAsync(TimeSpan, TimeSpan)

Démarre une opération asynchrone pour récupérer l’emplacement actuel de l’appareil.

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)

Paramètres

maximumAge
TimeSpan TimeSpan

Âge maximal acceptable des données d’emplacement mises en cache. Un TimeSpan est une période de temps exprimée en unités de 100 nanosecondes.

timeout
TimeSpan TimeSpan

Le délai d'attente. Un TimeSpan est une période de temps exprimée en unités de 100 nanosecondes.

Retours

Opération asynchrone qui, une fois terminée, retourne une géoposition marquant l’emplacement trouvé.

Attributs

Configuration requise pour Windows

Fonctionnalités de l’application
location ID_CAP_LOCATION [Windows Phone]

Remarques

Un emplacement est retourné immédiatement si le dernier emplacement se trouve dans un âge acceptable. Dans le cas contraire, un emplacement n’est retourné qu’après la modification suivante. Dans certains cas, votre application peut recevoir des données d’emplacement antérieures à la valeur maximumAge spécifiée. Cela est dû au fait qu’une valeur d’âge supplémentaire sera calculée en fonction du paramètre de précision souhaité, et que votre application utilisera le plus grand des deux âges. Par exemple, supposons qu’une précision par défaut de 500 mètres correspond à un âge maximal de 30 secondes. Dans ce cas, votre application peut recevoir 20 secondes d’anciennes données, même si vous définissez maximumAge sur 10 secondes.

Voir aussi

S’applique à