Xamarin.Essentials: 지오코딩

Geocoding 클래스는 위치 좌표에 장소 표시를 지오코딩하고 좌표를 장소 표시로 역 지오코딩하는 API를 제공합니다.

시작하기

이 API를 사용하기 전에 라이브러리가 제대로 설치되고 프로젝트에 설정되어 있는지 확인하기 위해 Xamarin.Essentials에 대한 시작 가이드를 읽어보세요.

지오코딩 기능에 액세스하려면 다음 플랫폼 관련 설정이 필요합니다.

Android

추가 설정이 필요하지 않습니다.

iOS

추가 설정이 필요하지 않습니다.

UWP

지오코딩 기능을 사용하려면 Bing Maps API 키가 필요합니다. Bing Maps 체험 계정을 등록합니다. 내 계정 > 내 키에서 새 키를 만들고 애플리케이션 유형(UWP 앱의 경우 공용 Windows 앱(UWP, 8.x 이하)이어야 함)에 따라 정보를 입력합니다.

지오코딩 메서드를 호출하기 전에 애플리케이션 수명 초기에 API 키를 설정합니다(UWP에서만 사용 가능).

Platform.MapServiceToken = "YOUR-KEY-HERE";

지오코딩 사용

클래스에서 Xamarin.Essentials에 대한 참조를 추가합니다.

using Xamarin.Essentials;

주소의 위치 좌표를 가져옵니다.

try
{
    var address =  "Microsoft Building 25 Redmond WA USA";
    var locations = await Geocoding.GetLocationsAsync(address);

    var location = locations?.FirstOrDefault();
    if (location != null)
    {
        Console.WriteLine($"Latitude: {location.Latitude}, Longitude: {location.Longitude}, Altitude: {location.Altitude}");
    }
}
catch (FeatureNotSupportedException fnsEx)
{
    // Feature not supported on device
}
catch (Exception ex)
{
    // Handle exception that may have occurred in geocoding
}

고도를 항상 사용할 수는 없습니다. 사용할 수 없는 경우 Altitude 속성은 null이거나 값이 0일 수 있습니다. 고도를 사용할 수 있는 경우 값은 해발 미터 단위입니다.

역방향 지오코딩 사용

역방향 지오코딩은 기존 좌표 집합의 placemarks를 가져오는 프로세스입니다.

try
{
    var lat = 47.673988;
    var lon = -122.121513;

    var placemarks = await Geocoding.GetPlacemarksAsync(lat, lon);

    var placemark = placemarks?.FirstOrDefault();
    if (placemark != null)
    {
        var geocodeAddress =
            $"AdminArea:       {placemark.AdminArea}\n" +
            $"CountryCode:     {placemark.CountryCode}\n" +
            $"CountryName:     {placemark.CountryName}\n" +
            $"FeatureName:     {placemark.FeatureName}\n" +
            $"Locality:        {placemark.Locality}\n" +
            $"PostalCode:      {placemark.PostalCode}\n" +
            $"SubAdminArea:    {placemark.SubAdminArea}\n" +
            $"SubLocality:     {placemark.SubLocality}\n" +
            $"SubThoroughfare: {placemark.SubThoroughfare}\n" +
            $"Thoroughfare:    {placemark.Thoroughfare}\n";

        Console.WriteLine(geocodeAddress);
    }
}
catch (FeatureNotSupportedException fnsEx)
{
    // Feature not supported on device
}
catch (Exception ex)
{
    // Handle exception that may have occurred in geocoding
}

두 위치 간 거리

Location 및 LocationExtensions 클래스는 두 위치 간 거리를 계산하는 메서드를 정의합니다. 예제는 지리적 위치 문서를 Xamarin.Essentials참조하세요.

API

• 지오코딩 소스 코드
• 지오코딩 API 문서

관련 동영상

Channel 9 및 YouTube에서 더 많은 Xamarin 비디오를 확인하세요.