Geolocator.GetGeopositionHistoryAsync Méthode

Référence

Définition

Espace de noms:: Windows.Devices.Geolocation

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

GetGeopositionHistoryAsync(DateTime)	Démarre une opération asynchrone pour récupérer l’historique d’emplacement de l’appareil. Notes Cette API n’est pas disponible pour toutes les applications Windows. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
GetGeopositionHistoryAsync(DateTime, TimeSpan)	Démarre une opération asynchrone pour récupérer l’historique d’emplacement de l’appareil. Notes Cette API n’est pas disponible pour toutes les applications Windows. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.

GetGeopositionHistoryAsync(DateTime)

Modifier

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

Notes

Cette API n’est pas disponible pour toutes les applications Windows. Sauf si votre compte de développeur est spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.

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

Paramètres

startTime: DateTime DateTimeOffset

Représente le début de l’intervalle de temps pour lequel les positions doivent être retournées.

Retours

IAsyncOperation<IVectorView<Geoposition>>

IAsyncOperation<IReadOnlyList<Geoposition>>

Positions (de type Géoposition) qui ont été collectées pendant l’intervalle de temps spécifié.

Attributs: OverloadAttribute RemoteAsyncAttribute

Configuration requise pour Windows

Fonctionnalités de l’application

locationHistory location

Remarques

La méthode GetGeopositionHistoryAsync permet à votre application d’extraire de manière asynchrone une liste de positions qui ont été collectées par les services de localisation. Seules les positions qui ont été collectées depuis le startTime spécifié seront retournées. Si aucune position n’est disponible à partir de cet intervalle de temps, une liste vide est retournée.

Cette méthode retourne uniquement les positions qui ont déjà été collectées par les services de localisation au cours des dernières 24 heures ; il ne résout pas de nouvelles positions. La spécification d’un intervalle de temps qui dépasse cette fenêtre de 24 heures ne génère pas de positions supplémentaires.

Les services de localisation collectent les positions uniquement lorsqu’une application ou des services interrogent l’emplacement de l’utilisateur, mais pas plus d’une fois par seconde. L’historique des emplacements est limité à 3600 postes; si l’historique des emplacements n’est pas effacé par l’utilisateur, chaque position sera stockée dans l’historique des emplacements entre 1 et 24 heures.

Notes

Si vous utilisez une tâche en arrière-plan pour appeler cette méthode fréquemment, il est important de tenir compte de l’impact qui aura sur la batterie. Bien que cette méthode ne déclenche pas le récepteur GPS, les ressources du processeur sont toujours nécessaires pour exécuter la tâche en arrière-plan.

Voir aussi

S’applique à

GetGeopositionHistoryAsync(DateTime, TimeSpan)

Modifier

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

Notes

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