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.

Kullanmaya başlayın

Bu API'yi kullanmaya başlamak için kitaplığın projelerinizde düzgün yüklendiğinden ve ayarlandığından emin olmak için Xamarin.Essentials kullanmaya başlama 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ızda için Xamarin.Essentials bir başvuru ekleyin:

using Xamarin.Essentials;

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

yöntemini çağırarak cihazın bilinen son konumunu alabilirsiniz.GetLastKnownLocationAsync Bu genellikle tam sorgu yaparken daha hızlıdır, ancak daha az doğru olabilir ve önbelleğe alınmış bir konum yoksa döndürebilir null .

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 GetLocationAsync için kullanılabilir. Tam olarak geçirmek GeolocationRequest en iyisidir ve CancellationToken cihazın konumunu almak biraz zaman alabileceğinden.

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 olabileceğini unutmayın. Örneğin, Altitude özelliği 0 değerine sahip veya deniz seviyesinden metre yüksek olan pozitif bir değere sahip olabilir null. Mevcut olmayabilecek diğer değerler ve Coursedeğerlerini içerirSpeed.

Coğrafi Konum Doğruluğu

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

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 konum döndürebilir. Bunu herhangi bir Locationüzerinde kullanarak IsFromMockProvider algılayabilirsiniz.

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 sınıfları, Location iki coğrafi konum arasındaki mesafeyi hesaplamanıza olanak sağlayan yöntemleri tanımlarCalculateDistance.LocationExtensions Bu hesaplanan mesafe yolları veya diğer yolları dikkate almaz ve dünya yüzeyindeki iki nokta arasındaki en kısa mesafedir, büyük daire uzaklığı olarak da bilinir veya eş zamanlı olarak, mesafe "karga uçarken".

Bir örnek aşağıda 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şturucunun Location enlem ve boylam bağımsız değişkenleri bu sıradadır. Pozitif enlem değerleri ekvatorun kuzeyinde, pozitif boylam değerleri ise Prime Meridian'ın doğusundadır. Mil veya kilometre belirtmek için CalculateDistance son bağımsız değişkeni kullanın. UnitConverters sınıfı ayrıca ve MilesToKilometers iki birim arasında dönüştürme yöntemlerini tanımlarKilometersToMiles.

Platform Farkları

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

API

• Coğrafi konum kaynak kodu
• Coğrafi Konum API'si belgeleri

İlgili Video

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