GeoCoordinateWatcher クラス

定義

public ref class GeoCoordinateWatcher : IDisposable, System::ComponentModel::INotifyPropertyChanged, System::Device::Location::IGeoPositionWatcher<System::Device::Location::GeoCoordinate ^>

[System.Security.SecurityCritical]
public class GeoCoordinateWatcher : IDisposable, System.ComponentModel.INotifyPropertyChanged, System.Device.Location.IGeoPositionWatcher<System.Device.Location.GeoCoordinate>

[<System.Security.SecurityCritical>]
type GeoCoordinateWatcher = class
    interface IDisposable
    interface INotifyPropertyChanged
    interface IGeoPositionWatcher<GeoCoordinate>

Public Class GeoCoordinateWatcher
Implements IDisposable, IGeoPositionWatcher(Of GeoCoordinate), INotifyPropertyChanged

継承

Object

GeoCoordinateWatcher

属性

SecurityCriticalAttribute

実装

INotifyPropertyChanged IGeoPositionWatcher<GeoCoordinate> IDisposable

例

次のプログラムは、 を作成 GeoCoordinateWatcher し、初期化タイムアウトを使用してデータの取得を開始する方法を示しています。 その後、コードは場所の座標 (既知の場合) を出力します。

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.");
            }
        }
    }
}

Imports System.Device.Location

Module GetLocationProperty
    Public Sub GetLocationProperty()
        Dim watcher As New System.Device.Location.GeoCoordinateWatcher()
        watcher.TryStart(False, TimeSpan.FromMilliseconds(1000))

        Dim coord As GeoCoordinate = watcher.Position.Location

        If coord.IsUnknown <> True Then
            Console.WriteLine("Lat: {0}, Long: {1}", coord.Latitude, coord.Longitude)
        Else
            Console.WriteLine("Unknown latitude and longitude.")
        End If
    End Sub

    Public Sub Main()
        GetLocationProperty()
        Console.ReadLine()
    End Sub

End Module

次のプログラムは、イベントをサブスクライブして継続的な場所の更新を受信する方法を PositionChanged 示しています。

using System;
using System.Device.Location;

namespace GetLocationEvent
{
    class AsyncProgram
    {
        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);
            }
        }
    }
}

Imports System.Device.Location

Module GetLocationEvent
    Public Class CLocation
        Private WithEvents watcher As GeoCoordinateWatcher
        Public Sub GetLocationEvent()
            watcher = New System.Device.Location.GeoCoordinateWatcher()
            AddHandler watcher.PositionChanged, AddressOf watcher_PositionChanged
            Dim started As Boolean = watcher.TryStart(False, TimeSpan.FromMilliseconds(1000))

            If Not started Then
                Console.WriteLine("GeoCoordinateWatcher timed out on start.")
            End If
        End Sub

        Private Sub watcher_PositionChanged(ByVal sender As Object, ByVal e As GeoPositionChangedEventArgs(Of GeoCoordinate))
            PrintPosition(e.Position.Location.Latitude, e.Position.Location.Longitude)
        End Sub

        Private Sub PrintPosition(ByVal Latitude As Double, ByVal Longitude As Double)
            Console.WriteLine("Latitude: {0}, Longitude {1}", Latitude, Longitude)
        End Sub
    End Class


    Public Sub Main()
        Dim myLocation As New CLocation()
        myLocation.GetLocationEvent()
        Console.WriteLine("Enter any key to quit.")
        Console.ReadLine()
    End Sub

End Module

注釈

クラスは GeoCoordinateWatcher 、現在の場所プロバイダーから座標ベースの場所データを提供します。 現在の場所プロバイダーは、すべてのプロバイダーからのデータの経過時間と精度、場所アプリケーションによって要求される精度、場所プロバイダーに関連する電力消費とパフォーマンスへの影響など、さまざまな要因に基づいて、コンピューター上で最も高いものとして優先順位が付けられます。 たとえば、GPS デバイスが屋内で衛星信号を失い、Wi-Fi 三角形分割プロバイダーがコンピューター上で最も正確なプロバイダーになると、現在の場所プロバイダーが時間の経過と同時に変化する可能性があります。

場所データへのアクセスを開始するには、 を作成GeoCoordinateWatcherし、 を呼び出すか、 をTryStart呼び出Startして、現在の場所プロバイダーからのデータの取得を開始します。

プロパティを Status 確認して、データが使用可能かどうかを確認できます。 データが使用可能な場合は、 プロパティから場所を 1 回取得するか、イベントを Position 処理して継続的な場所の更新を PositionChanged 受け取ることができます。

、Status、および Position プロパティは PermissionをサポートINotifyPropertyChangedしているため、アプリケーションはこれらのプロパティにデータバインドできます。

Windows 7 では、場所プロバイダーがインストールされ、コンピューターの System.Device.Location 場所を解決できる場合、すべてのクラスが完全に機能します。

メモ Windows 7 より前のバージョンの Windows では、次の条件が適用されます。

• コンストラクターを持つすべての System.Device.Location オブジェクトを作成できますが、 プロパティの Status 値 Disabledは常に になります。

• の プロパティによってLocation示される場所は常に になりますUnknown。Position

• 場所イベントは発生しません。

コンストラクター

プロパティ

メソッド

イベント

明示的なインターフェイスの実装

適用対象