Geolocator Classe

Définition

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

public ref class Geolocator sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class Geolocator final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class Geolocator
[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

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, 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.

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.

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.

S’applique à

Voir aussi