Windows.Devices.Geolocation Espace de noms
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.
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.