Geolocator Classe

Définition

Espace de noms:

Windows.Devices.Geolocation

Fournit l’accès à l’emplacement géographique actuel.

public ref class Geolocator sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Geolocator final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Geolocator

function Geolocator()

Public NotInheritable Class Geolocator

Héritage

Object Platform::Object IInspectable Geolocator

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application	location ID_CAP_LOCATION [Windows Phone]

Exemples

Cet exemple montre comment utiliser la classe Geolocator pour récupérer l’emplacement de l’appareil. Pour plus d’informations, voir Obtenir l’emplacement actuel.

using Windows.Devices.Geolocation;
...
var accessStatus = await Geolocator.RequestAccessAsync();
switch (accessStatus)
{
    case GeolocationAccessStatus.Allowed:
        // notify user: Waiting for update

        // If DesiredAccuracy or DesiredAccuracyInMeters are not set (or value is 0), DesiredAccuracy.Default is used.
        Geolocator geolocator = new Geolocator { DesiredAccuracyInMeters = _desireAccuracyInMetersValue };

        // Subscribe to StatusChanged event to get updates of location status changes
        _geolocator.StatusChanged += OnStatusChanged;

        // Carry out the operation
        Geoposition pos = await geolocator.GetGeopositionAsync();

        UpdateLocationData(pos);
        // notify user: Location updated
        break;

    case GeolocationAccessStatus.Denied:
        // notify user: Access to location is denied

        break;

    case GeolocationAccessStatus.Unspecified:
        // notify user: Unspecified error
        break;
}

Remarques

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1607	14393	AllowFallbackToConsentlessPositions
1607	14393	DefaultGeoposition
1607	14393	IsDefaultGeopositionRecommended

Constructeurs

Geolocator()

Initialise un nouvel objet Geolocator .

Propriétés

DefaultGeoposition	Obtient l’emplacement entré manuellement dans le système par l’utilisateur, à utiliser si aucune meilleure option n’existe.
DesiredAccuracy	Niveau de précision auquel le géolocalisateur fournit des mises à jour d’emplacement.
DesiredAccuracyInMeters	Obtient ou définit la précision souhaitée en compteurs pour les données retournées par le service d’emplacement.
IsDefaultGeopositionRecommended	Indique si l’utilisateur doit être invité à définir manuellement un emplacement par défaut.
LocationStatus	Le status qui indique la capacité du Géolocator à fournir des mises à jour d’emplacement.
MovementThreshold	Distance de mouvement, en mètres, par rapport à la coordonnée du dernier événement PositionChanged , qui est nécessaire pour que geolocator déclenche un événement PositionChanged .
ReportInterval	Intervalle de temps minimal demandé entre les mises à jour d’emplacement, en millisecondes. Si votre application nécessite rarement des mises à jour, définissez cette valeur afin que les services de localisation puissent économiser l’énergie en calculant l’emplacement uniquement lorsque cela est nécessaire.

Méthodes

AllowFallbackToConsentlessPositions()	Définit le Géolocator pour qu’il utilise l’emplacement grossaire comme option de secours (voir Remarques).
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.
GetGeopositionHistoryAsync(DateTime)	Démarre une opération asynchrone pour récupérer l’historique des emplacements de l’appareil. Notes Cette API n’est pas disponible pour toutes les applications Windows. À moins que votre compte de développeur ne soit 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 des emplacements de l’appareil. Notes Cette API n’est pas disponible pour toutes les applications Windows. À moins que votre compte de développeur ne soit spécialement approvisionné par Microsoft, les appels à ces API échouent au moment de l’exécution.
RequestAccessAsync()	Notes Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici. Important Cette API sera affectée par les modifications à venir du comportement du système d’exploitation, prévues pour l’automne 2024. Pour plus d’informations, consultez Modifications du comportement de l’API pour l’accès Wi-Fi et l’emplacement. Demande l’autorisation d’accéder aux données d’emplacement.

Événements

PositionChanged	Déclenché lorsque l’emplacement est mis à jour.
StatusChanged	Déclenché lorsque la capacité du géolocalisateur à fournir des modifications d’emplacement mises à jour.

Voir aussi

• Obtenir l’emplacement actuel
• exemple de géolocalisation
• Exemple de balise géographique (Windows 10)