Xamarin.Essentials: Coğrafi konum

Geolocation sınıfı, cihazın geçerli coğrafi konum koordinatlarını almak için API'ler 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.

Coğrafi Konum işlevine erişmek için aşağıdaki platforma özgü kurulum gereklidir:

[assembly: UsesPermission(Android.Manifest.Permission.AccessCoarseLocation)]
[assembly: UsesPermission(Android.Manifest.Permission.AccessFineLocation)]
[assembly: UsesFeature("android.hardware.location", Required = false)]
[assembly: UsesFeature("android.hardware.location.gps", Required = false)]
[assembly: UsesFeature("android.hardware.location.network", Required = false)]

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-feature android:name="android.hardware.location" android:required="false" />
<uses-feature android:name="android.hardware.location.gps" android:required="false" />
<uses-feature android:name="android.hardware.location.network" android:required="false" />

[assembly: UsesPermission(Manifest.Permission.AccessBackgroundLocation)]

<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

protected override void OnCreate(Bundle savedInstanceState) 
{
    //...
    base.OnCreate(savedInstanceState);
    Xamarin.Essentials.Platform.Init(this, savedInstanceState); // add this line to your code, it may also be called: bundle
    //...
}    

public override void OnRequestPermissionsResult(int requestCode, string[] permissions, Android.Content.PM.Permission[] grantResults)
{
    Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults);

    base.OnRequestPermissionsResult(requestCode, permissions, grantResults);
}

<key>NSLocationWhenInUseUsageDescription</key>
<string>Fill in a reason why your app needs access to location.</string>

Coğrafi Konum Kullanma

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

using Xamarin.Essentials;

Coğrafi Konum API'si gerektiğinde kullanıcıdan izinler de istenir.

yöntemini çağırarak cihazın bilinen son konumunu elde edebilirsiniz. Bu genellikle tam sorguyu daha hızlıdır, ancak daha az doğru olabilir ve önbelleğe alınmış null bir konum yoksa geri dönebilirsiniz.

try
{
    var location = await Geolocation.GetLastKnownLocationAsync();

    if (location != null)
    {
        Console.WriteLine($"Latitude: {location.Latitude}, Longitude: {location.Longitude}, Altitude: {location.Altitude}");
    }
}
catch (FeatureNotSupportedException fnsEx)
{
    // Handle not supported on device exception
}
catch (FeatureNotEnabledException fneEx)
{
    // Handle not enabled on device exception
}
catch (PermissionException pEx)
{
    // Handle permission exception
}
catch (Exception ex)
{
    // Unable to get location
}

Geçerli cihazın konum koordinatlarını sorgulamak için kullanılabilir. En iyisi tam geçiş yapmaktır GeolocationRequest ve cihazın konumunu almak biraz zaman CancellationToken alalır.

CancellationTokenSource cts;

async Task GetCurrentLocation()
{
    try
    {
        var request = new GeolocationRequest(GeolocationAccuracy.Medium, TimeSpan.FromSeconds(10));
        cts = new CancellationTokenSource();
        var location = await Geolocation.GetLocationAsync(request, cts.Token);

        if (location != null)
        {
            Console.WriteLine($"Latitude: {location.Latitude}, Longitude: {location.Longitude}, Altitude: {location.Altitude}");
        }
    }
    catch (FeatureNotSupportedException fnsEx)
    {
        // Handle not supported on device exception
    }
    catch (FeatureNotEnabledException fneEx)
    {
        // Handle not enabled on device exception
    }
    catch (PermissionException pEx)
    {
        // Handle permission exception
    }
    catch (Exception ex)
    {
        // Unable to get location
    }
}

protected override void OnDisappearing()
{
    if (cts != null && !cts.IsCancellationRequested)
        cts.Cancel();
    base.OnDisappearing();
}

Her cihazın farklı sağlayıcılar aracılığıyla coğrafi konum sorgulaması nedeniyle tüm değerlerin kullanılabilir olduğunu unutmayın. Örneğin, özelliği 0 değerine sahip veya deniz seviyesinin metre üzerinde olan pozitif bir Altitudenull değere sahip olabilir. Mevcut olmayacak diğer değerler ve değerlerini SpeedCourse içerir.

Coğrafi Konum Doğruluğu

Aşağıdaki tabloda platform başına doğruluk özetlemektedir:

En düşük

Düşük

Orta (Varsayılan)

Yüksek

En iyi

Sahte Konumları Algılama

Bazı cihazlar sağlayıcıdan veya sahte konumlar sağlayan bir uygulama tarafından sahte bir konum dönüşebilir. Herhangi bir üzerinde kullanarak bunu IsFromMockProviderLocation algılanabilir.

var request = new GeolocationRequest(GeolocationAccuracy.Medium);
var location = await Geolocation.GetLocationAsync(request);

if (location != null)
{
    if(location.IsFromMockProvider)
    {
        // location is from a mock provider
    }
}

İki Konum Arasındaki Uzaklık

ve LocationLocationExtensions sınıfları, CalculateDistance iki coğrafi konum arasındaki mesafeyi hesaplamaya olanak sağlayan yöntemleri tanımlar. Bu hesaplanmış mesafe yolları veya diğer yolları hesaba katmaz ve dünya yüzeyindeki iki nokta arasındaki en kısa mesafedir ve büyük daire uzaklığı veya harmanlamalı olarak da bilinen mesafedir ."

Aşağıda bir örnek verilmiştir:

Location boston = new Location(42.358056, -71.063611);
Location sanFrancisco = new Location(37.783333, -122.416667);
double miles = Location.CalculateDistance(boston, sanFrancisco, DistanceUnits.Miles);

Oluşturucu Location bu sırada enlem ve boylam bağımsız değişkenlerine sahip. Pozitif enlem değerleri ekvator'ın kuzeyidir ve pozitif boylam değerleri Asal Meridyen'in doğusu olur. Mil veya kilometre belirtmek için CalculateDistance son bağımsız değişkeni kullanın. sınıfı UnitConverters ayrıca iki birim arasında dönüştürme için ve yöntemlerini KilometersToMilesMilesToKilometers tanımlar.

Platform farkları

Yükseklik her platformda farklı şekilde hesaplanır.

API

• Xamarin. Essentials /coğrafi konum "Data-LinkType =" dış ">coğrafi konum kaynak kodu
• Coğrafi konum API 'SI belgeleri

İlgili video

Channel 9 ve YouTube'da daha fazla Xamarin videoları bulun.