CivicAddressResolver.ResolveAddress(GeoCoordinate) Método

Definición

Espacio de nombres:

System.Device.Location

Ensamblado:

System.Device.dll

Resuelve sincrónicamente una dirección de una ciudad a partir de una ubicación basada en latitud y longitud. Esta llamada bloqueará la ejecución del subproceso que realiza la llamada mientras se resuelve la dirección.

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

GeoCoordinate que contiene la ubicación que se va a resolver como una dirección de una ciudad.

Devoluciones

CivicAddress

Dirección de una ciudad resuelta a partir del parámetro coordinate. Se devuelve Unknown si no se puede resolver la dirección.

Implementaciones

ResolveAddress(GeoCoordinate)

Excepciones

ArgumentNullException

coordinate es null.

ArgumentException

coordinate no contiene una latitud y longitud válidas.

Ejemplos

En el siguiente programa se muestra cómo llamar ResolveAddress a para resolver una dirección civil de forma sincrónica.

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

Comentarios

El ResolveAddressCompleted evento se genera cuando se completa la operación de resolución de direcciones. El miembro del ResolveAddressCompletedEventArgs objeto que se pasa al controlador de eventos devuelve la Address dirección civic que se resuelve desde el coordinate parámetro .