Xamarin.Essentials: Eşleme

Map sınıfı, bir uygulamanın yüklü harita uygulamasını belirli bir konuma veya yer işaretine açmasını sağlar.

başlarken

Bu API'yi kullanmaya başlamak için kitaplığın projelerinize düzgün bir şekilde yük olduğundan ve ayar olduğundan emin olmak için başlangıç kılavuzunu okuyun.

Harita kullanma

sınıfınıza Xamarin.Essentials bir başvuru ekleyin:

using Xamarin.Essentials;

Map işlevi, isteğe bağlı ile açmak için veya ile OpenAsyncLocation yöntemini Placemark çağırarak MapLaunchOptions çalışır.

public class MapTest
{
    public async Task NavigateToBuilding25()
    {
        var location = new Location(47.645160, -122.1306032);
        var options =  new MapLaunchOptions { Name = "Microsoft Building 25" };

        try
        {
            await Map.OpenAsync(location, options);
        }
        catch (Exception ex)
        {
            // No map application available to open
        }
    }
}

bir ile Placemark alıtırken aşağıdaki bilgiler gereklidir:

• CountryName
• AdminArea
• Thoroughfare
• Locality

public class MapTest
{
    public async Task NavigateToBuilding25()
    {
        var placemark = new Placemark
            {
                CountryName = "United States",
                AdminArea = "WA",
                Thoroughfare = "Microsoft Building 25",
                Locality = "Redmond"
            };
        var options =  new MapLaunchOptions { Name = "Microsoft Building 25" };

        try
        {
            await Map.OpenAsync(placemark, options);
        }
        catch (Exception ex)
        {
            // No map application available to open or placemark can not be located
        }
    }
}

Uzantı Metotları

Zaten bir veya başvurusu LocationPlacemark varsa, isteğe bağlı ile yerleşik uzantı yöntemini OpenMapAsyncMapLaunchOptions kullanabilirsiniz:

public class MapTest
{
    public async Task OpenPlacemarkOnMap(Placemark placemark)
    {
        try
        {
            await placemark.OpenMapAsync();
        }
        catch (Exception ex)
        {
            // No map application available to open
        }
    }
}

Yön Modu

herhangi bir OpenMapAsync çağrısı yapmadan çağrısı MapLaunchOptions yaptısanız, harita belirtilen konuma başlatacak. İsteğe bağlı olarak, cihazın geçerli konumundan hesaplanan bir gezinti yolunuz olabilir. Bu, üzerinde ayarıyla NavigationMode başarılı MapLaunchOptions olur:

public class MapTest
{
    public async Task NavigateToBuilding25()
    {
        var location = new Location(47.645160, -122.1306032);
        var options =  new MapLaunchOptions { NavigationMode = NavigationMode.Driving };

        await Map.OpenAsync(location, options);
    }
}

Platform Farkları

Platform Uygulama Özellikleri

API

• Xamarin.Essentials /Map" data-linktype="external">Eşleme kaynak kodu
• Harita API'si belgeleri

İlgili Video

Channel 9 ve YouTube'da daha fazla Xamarin videosu bulun.