Windows.Devices.Geolocation Espace de noms

  • Référence
Modifier

Fournit des API permettant d’obtenir l’emplacement actuel ou de suivre l’emplacement de l’appareil au fil du temps. Les informations d’emplacement peuvent provenir de l’estimation d’une position à partir de balises telles que des points d’accès Wi-Fi et des tours de cellules, de l’adresse IP de l’appareil, ou d’autres sources, telles qu’un appareil SSD ou GPS. L’API Windows.Devices.Geolocation fournit les données de géolocalisation les plus appropriées à partir de toutes les sources disponibles.

La précision des informations d’emplacement dépend de la source. La latitude et la longitude peuvent varier dans les plages suivantes :

  • GPS : dans un rayon d’environ 10 mètres
  • Wi-Fi : entre 30 et 500 mètres environ
  • Tours de cellules : entre environ 300 mètres et 3 000 mètres
  • Adresse IP : entre environ 1 000 mètres et 5 000 mètres

En plus de la latitude et de la longitude, le GPS fournit également des informations sur la direction, la vitesse et l’altitude. Ces informations supplémentaires sont facultatives lorsque les informations d’emplacement proviennent d’autres sources.

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.

Pour plus d’informations sur la confidentialité de l’emplacement, consultez la Déclaration de confidentialité Windows.

Important

À compter de Windows 10, appelez 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. Jusqu’à ce que l’utilisateur l’y autorise, votre application ne peut pas accéder aux données d’emplacement.

Architecture des services de localisation

La première couche de l’architecture des services de localisation se compose du matériel dans l’appareil. Cela inclut le récepteur GPS, le Wi-Fi et la radio cellulaire. Ceux-ci peuvent tous fonctionner comme des fournisseurs de données d’emplacement avec différents niveaux de précision et de consommation d’énergie. Au-dessus du matériel se trouve la couche de code native. Cette couche communique directement avec les sources disponibles de données d’emplacement et détermine les sources à utiliser pour déterminer l’emplacement de l’appareil en fonction de la disponibilité des données et des exigences de performances spécifiées par l’application. La couche de code native communique également sur Internet avec un service web hébergé par Microsoft pour rechercher des informations relatives à l’emplacement à partir d’une base de données. La couche supérieure du service d’emplacement est l’interface managée, exposée par le biais d’une DLL incluse dans le Kit de développement logiciel (SDK) Windows. Une application utilise cette interface pour démarrer et arrêter des demandes de localisation, définir le niveau de précision requis par l’application et recevoir les données d’emplacement de la couche de code native dès qu’elles sont disponibles.

Classes

CivicAddress

API non prise en charge.
GeoboundingBox

Représente un rectangle qui définit une zone géographique.
Geocircle

Décrit un cercle géographique avec un point central et un rayon.
Geocoordinate

Contient les informations permettant d’identifier un emplacement géographique.
GeocoordinateSatelliteData

Fournit des informations supplémentaires sur un géocoordinate. Ces informations s’appliquent uniquement aux estimations de position obtenues à l’aide de signaux satellites.
Geolocator

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

Représente une série ordonnée de points géographiques.
Geopoint

Décrit un point géographique.
Geoposition

Représente un emplacement qui peut contenir des données de latitude et de longitude ou des données de lieu.
Geovisit

Représente un changement d’état lié à la visite. Pour plus d’informations sur l’utilisation de cette fonctionnalité, consultez Recommandations relatives à l’utilisation du suivi des visites .
GeovisitMonitor

Gère la surveillance des visites d’un utilisateur lorsque l’application est en cours d’utilisation (et non en arrière-plan).
GeovisitStateChangedEventArgs

Contient des informations sur un événement VisitStateChanged .
GeovisitTriggerDetails

Gère les détails d’un déclencheur pour une tâche en arrière-plan liée aux visites.
PositionChangedEventArgs

Fournit des données pour l’événement PositionChanged .
StatusChangedEventArgs

Fournit des informations pour l’événement StatusChanged .
VenueData

Représente le lieu associé à un emplacement géographique.

Structures

BasicGeoposition

Informations de base pour décrire une position géographique.

Interfaces

IGeoshape

Interface permettant de définir une forme géographique.

Énumérations

AltitudeReferenceSystem

Indique le système de référence d’altitude à utiliser pour définir une forme géographique.
GeolocationAccessStatus

Indique si votre application est autorisée à accéder aux données d’emplacement.
GeoshapeType

Indique la forme d’une région géographique.
PositionAccuracy

Indique le niveau de précision demandé pour les données d’emplacement que l’application utilise.
PositionSource

Indique la source utilisée pour obtenir un géocoordinate.
PositionStatus

Indique la capacité de l’objet Geolocator à fournir des données d’emplacement.
VisitMonitoringScope

Contient des valeurs qui décrivent l’étendue prévue de la surveillance de l’emplacement à utiliser avec la fonctionnalité Visites.
VisitStateChange

Contient des valeurs qui décrivent un changement d’état lié à Visit.

Exemples

Les exemples d’applications qui utilisent des classes de cet espace de noms incluent l’exemple de géolocalisation et l’exemple geotag.

Voir aussi