CivicAddressResolver.ResolveAddress(GeoCoordinate) Метод

Определение

Пространство имен:

System.Device.Location

Сборка:

System.Device.dll

Синхронно разрешает административный адрес из расположения, выраженного в виде широты и долготы. Этот вызов блокирует выполнение вызывающего потока на время разрешения адреса.

public:
 virtual System::Device::Location::CivicAddress ^ ResolveAddress(System::Device::Location::GeoCoordinate ^ coordinate);

public System.Device.Location.CivicAddress ResolveAddress (System.Device.Location.GeoCoordinate coordinate);

abstract member ResolveAddress : System.Device.Location.GeoCoordinate -> System.Device.Location.CivicAddress
override this.ResolveAddress : System.Device.Location.GeoCoordinate -> System.Device.Location.CivicAddress

Public Function ResolveAddress (coordinate As GeoCoordinate) As CivicAddress

Параметры

coordinate

GeoCoordinate

GeoCoordinate содержит расположение для разрешения в административный адрес.

Возвращаемое значение

CivicAddress

Административный адрес, который разрешается из параметра coordinate. Значение Unknown возвращается, если не удается разрешить адрес.

Реализации

ResolveAddress(GeoCoordinate)

Исключения

ArgumentNullException

coordinate имеет значение null.

ArgumentException

coordinate не содержит допустимые значения широты и долготы.

Примеры

В следующей программе показано, как вызвать ResolveAddress для синхронного разрешения гражданского адреса.

using System;
using System.Device.Location;
namespace ResolveAddressSync
{
    class Program
    {
        static void Main(string[] args)
        {
            ResolveAddressSync();
        }
        static void ResolveAddressSync()
        {
            GeoCoordinateWatcher watcher = new GeoCoordinateWatcher(GeoPositionAccuracy.High);
            watcher.MovementThreshold = 1.0; // set to one meter
            watcher.TryStart(false, TimeSpan.FromMilliseconds(1000));

            CivicAddressResolver resolver = new CivicAddressResolver();

            if (watcher.Position.Location.IsUnknown == false)
            {
                CivicAddress address = resolver.ResolveAddress(watcher.Position.Location);

                if (!address.IsUnknown)
                {
                    Console.WriteLine("Country: {0}, Zip: {1}",
                            address.CountryRegion,
                            address.PostalCode);
                }
                else
                {
                    Console.WriteLine("Address unknown.");
                }
            }
        }
    }
}

Imports System.Device.Location

Module ResolveAddressSync

    Public Sub ResolveAddressSync()
        Dim watcher As GeoCoordinateWatcher
        watcher = New System.Device.Location.GeoCoordinateWatcher(GeoPositionAccuracy.High)
        Dim started As Boolean = False
        watcher.MovementThreshold = 1.0     'set to one meter
        started = watcher.TryStart(False, TimeSpan.FromMilliseconds(1000))

        Dim resolver As CivicAddressResolver = New CivicAddressResolver()
        If started Then
            If Not watcher.Position.Location.IsUnknown Then
                Dim address As CivicAddress = resolver.ResolveAddress(watcher.Position.Location)
                If Not address.IsUnknown Then
                    Console.WriteLine("Country: {0}, Zip: {1}",
                                address.CountryRegion,
                                address.PostalCode)
                Else
                    Console.WriteLine("Address unknown.")
                End If
            End If
        Else
            Console.WriteLine("GeoCoordinateWatcher timed out on start.")
        End If
    End Sub


    Public Sub Main()

        ResolveAddressSync()
        Console.WriteLine("Enter any key to quit.")
        Console.ReadLine()
    End Sub

End Module

Комментарии

Событие ResolveAddressCompleted возникает после завершения операции разрешения адреса. Гражданский адрес, разрешенный из coordinate параметра , возвращается Address членом ResolveAddressCompletedEventArgs объекта , который передается обработчику событий.