Idioma

CivicAddressResolver.ResolveAddress(GeoCoordinate) Método

Definição

Espaço de Nomes:
System.Device.Location
Assemblagem:
System.Device.dll

Resolve sincronizadamente um endereço cívico a partir de uma localização baseada na latitude e longitude. Esta chamada bloqueia a execução do fio de chamadas enquanto o endereço está a ser resolvido.

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

Parâmetros

coordinate
GeoCoordinate

O GeoCoordinate que contém a localização para resolver para um endereço cívico.

Devoluções

CivicAddress

O endereço cívico que é resolvido a partir do coordinate parâmetro. Unknown é devolvido se o endereço não puder ser resolvido.

Implementações

ResolveAddress(GeoCoordinate)

Exceções

ArgumentNullException

coordinate é null.

ArgumentException

coordinate não contém uma latitude e longitude válidas.

Exemplos

O programa seguinte demonstra como chamar ResolveAddress para resolver um endereço cívico de forma síncrona.

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)
            {
                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

Observações

O ResolveAddressCompleted evento é ativado quando a operação de resolução de endereços termina. O endereço civic que é resolvido a partir do coordinate parâmetro é devolvido pelo Address membro do ResolveAddressCompletedEventArgs objeto que é passado ao gestor de eventos.

Aplica-se a