GeoCoordinateWatcher, classe

La classe GeoCoordinateWatcher fournit des données de localisation basées sur des coordonnées à partir du fournisseur de localisation actuel. Le fournisseur de localisation actuel, ayant actuellement la priorité la plus élevée sur l'ordinateur, en fonction de plusieurs facteurs tels que l'ancienneté et l'exactitude des données de tous les fournisseurs, l'exactitude requise par les applications de localisation, ainsi que la consommation d'énergie et l'impact sur les performances associées au fournisseur de localisation. Le fournisseur de localisation actuel peut changer avec le temps, par exemple, lorsqu'un périphérique GPS perd son signal satellite intérieur et qu'un fournisseur de triangulation Wi-Fi devient le fournisseur le plus exact sur l'ordinateur.

Pour commencer à accéder aux données, créez un GeoCoordinateWatcher et appelez Start ou TryStart pour démarrer l'acquisition de données à partir du fournisseur de localisation actuel.

La propriété Status peut être vérifiée pour déterminer si les données sont disponibles. Si des données sont disponibles, vous pouvez obtenir l'emplacement une fois de la propriété Position, ou recevoir des mises à jour continues de l'emplacement en gérant l'événement PositionChanged.

Les propriétés Permission, Status et Position prennent en charge INotifyPropertyChanged, afin qu'une application puisse lier ces propriétés aux données.

Dans Windows 7, toutes les classes System.Device.Location sont complètement fonctionnelles si un fournisseur de localisation est installé et capable de résoudre l'emplacement de l'ordinateur.

Remarque
Dans Windows 7 Édition Starter, le seul fournisseur de localisation pris en charge est le fournisseur de localisation par défaut du Panneau de configuration, et un complément doit être installé pour spécifier la latitude et la longitude.

Remarque   Dans les versions de Windows antérieures à Windows 7, les conditions suivantes s'appliquent :

• Tous les objets System.Device.Location qui ont des constructeurs peuvent être créés, mais la propriété Status a toujours la valeur Disabled.

• L'emplacement indiqué par la propriété Location de Position sera toujours Unknown.

• Aucun événement d'emplacement ne sera déclenché.

Le programme suivant montre comment créer un GeoCoordinateWatcher et commencer à acquérir des données à l'aide d'un délai d'initialisation. Le code imprime ensuite les coordonnées de l'emplacement, si elles sont connues.

using System;
using System.Device.Location;

namespace GetLocationProperty
{
    class Program
    {
        static void Main(string[] args)
        {
            GetLocationProperty();
        }

        static void GetLocationProperty()
        {
            GeoCoordinateWatcher watcher = new GeoCoordinateWatcher();

            // Do not suppress prompt, and wait 1000 milliseconds to start.
            watcher.TryStart(false, TimeSpan.FromMilliseconds(1000));

            GeoCoordinate coord = watcher.Position.Location;

            if (coord.IsUnknown != true)
            {
                Console.WriteLine("Lat: {0}, Long: {1}",
                    coord.Latitude,
                    coord.Longitude);
            }
            else
            {
                Console.WriteLine("Unknown latitude and longitude.");
            }
        }
    }
}

Le programme suivant montre comment recevoir des mises à jour continues de l'emplacement en s'abonnant à des événements PositionChanged.

using System;
using System.Device.Location;

namespace GetLocationEvent
{
    class Program
    {
        static void Main(string[] args)
        {
            CLocation myLocation = new CLocation();
            myLocation.GetLocationEvent();
            Console.WriteLine("Enter any key to quit.");
            Console.ReadLine();            
        }
        class CLocation
        {
            GeoCoordinateWatcher watcher;

            public void GetLocationEvent()
            {
                this.watcher = new GeoCoordinateWatcher();
                this.watcher.PositionChanged += new EventHandler<GeoPositionChangedEventArgs<GeoCoordinate>>(watcher_PositionChanged);
                bool started = this.watcher.TryStart(false, TimeSpan.FromMilliseconds(2000));
                if (!started)
                {
                    Console.WriteLine("GeoCoordinateWatcher timed out on start.");
                }
            }

            void watcher_PositionChanged(object sender, GeoPositionChangedEventArgs<GeoCoordinate> e)
            {
                PrintPosition(e.Position.Location.Latitude, e.Position.Location.Longitude);
            }

            void PrintPosition(double Latitude, double Longitude)
            {
                Console.WriteLine("Latitude: {0}, Longitude {1}", Latitude, Longitude);
            }
        }
    }
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence