Bilinen son konumu alma

Uygulamanız, Google Play Hizmetleri konum API'lerini kullanarak kullanıcının cihazının bilinen son konumunu isteyebilir. Çoğu durumda, kullanıcının mevcut konumuyla ilgilenirsiniz. Bu konum genellikle cihazın bilinen son konumuna eşdeğerdir.

Özellikle, cihazın bilinen son konumunu almak için çok kaynaklı konum sağlayıcıyı kullanın. Çok kaynaklı konum sağlayıcı, Google Play Hizmetleri'ndeki konum API'lerinden biridir. Temel konum teknolojisini yönetir ve yüksek doğruluk veya düşük güç gibi gereksinimleri üst düzeyde belirtebilmeniz için basit bir API sağlar. Ayrıca cihazın pil gücü kullanımını da optimize eder.

Not: Uygulamanız arka planda çalışırken konuma erişim, uygulamanın temel işlevi açısından kritik öneme sahip olmalı ve kullanıcılara uygun açıklama yapılmalıdır.

Bu derste, çok kaynaklı konum sağlayıcıdaki getLastLocation() yöntemini kullanarak bir cihazın konumu için nasıl tek bir istekte bulunacağınız gösterilmektedir.

Google Play Hizmetleri'ni ayarlama

Çok kaynaklı konum sağlayıcıya erişmek için uygulamanızın geliştirme projesinin Google Play Hizmetleri'ni içermesi gerekir. SDK Yöneticisi aracılığıyla Google Play Hizmetleri bileşenini indirip yükleyin ve kitaplığı projenize ekleyin. Ayrıntılar için Google Play Hizmetleri'ni Kurma kılavuzuna bakın.

Uygulama izinlerini belirtme

Özellikleri konum hizmetlerini kullanan uygulamalar, bu özelliklerin kullanım alanlarına bağlı olarak konum izinleri istemelidir.

Konum hizmetleri istemcisi oluşturma

Etkinliğinizin onCreate() yönteminde, aşağıdaki kod snippet'inde gösterildiği gibi çok kaynaklı konum sağlayıcı istemcisinin bir örneğini oluşturun.

Kotlin

private lateinit var fusedLocationClient: FusedLocationProviderClient

override fun onCreate(savedInstanceState: Bundle?) {
    // ...

    fusedLocationClient = LocationServices.getFusedLocationProviderClient(this)
}

Java

private FusedLocationProviderClient fusedLocationClient;

// ..

@Override
protected void onCreate(Bundle savedInstanceState) {
    // ...

    fusedLocationClient = LocationServices.getFusedLocationProviderClient(this);
}

Bilinen son konumu alma

Konum Hizmetleri istemcisini oluşturduktan sonra kullanıcının cihazının bilinen son konumunu alabilirsiniz. Uygulamanız bunlara bağlandığında cihazın konumunu almak için çok kaynaklı konum sağlayıcının getLastLocation() yöntemini kullanabilirsiniz. Bu çağrı tarafından döndürülen konumun hassasiyeti, konum izinleri isteme ile ilgili kılavuzda açıklandığı şekilde uygulama manifest dosyanıza eklediğiniz izin ayarına göre belirlenir.

Bilinen son konumu istemek için getLastLocation() yöntemini çağırın. Aşağıdaki kod snippet'inde istek ve yanıtın basit bir şekilde işlenmesi gösterilmektedir:

Kotlin

fusedLocationClient.lastLocation
        .addOnSuccessListener { location : Location? ->
            // Got last known location. In some rare situations this can be null.
        }

Java

fusedLocationClient.getLastLocation()
        .addOnSuccessListener(this, new OnSuccessListener<Location>() {
            @Override
            public void onSuccess(Location location) {
                // Got last known location. In some rare situations this can be null.
                if (location != null) {
                    // Logic to handle location object
                }
            }
        });

getLastLocation() yöntemi, bir coğrafi konumun enlem ve boylam koordinatlarını içeren Location nesnesini almak için kullanabileceğiniz bir Task döndürür. Konum nesnesi aşağıdaki durumlarda null olabilir:

• Cihaz ayarlarında konum kapalıdır. Son konum daha önce alınmış olsa bile sonuç null olabilir. Bunun nedeni, konumun devre dışı bırakılmasının önbelleği de temizlemesidir.
• Cihazın konumu hiç kaydedilmemiştir. Bu durum, yeni bir cihazda veya fabrika ayarlarına geri yüklenmiş bir cihazda görülebilir.
• Cihazdaki Google Play Hizmetleri yeniden başlatıldı ve hizmetler yeniden başlatıldıktan sonra konum isteyen etkin bir çok kaynaklı konum sağlayıcı istemcisi yok. Bu durumdan kaçınmak için yeni bir istemci oluşturabilir ve konum güncellemelerini kendiniz isteyebilirsiniz. Daha fazla bilgi için Konum güncellemeleri isteme başlıklı makaleyi inceleyin.

En iyi konum tahminini seçme

FusedLocationProviderClient, cihaz konum bilgilerini almak için çeşitli yöntemler sunar. Uygulamanızın kullanım alanına bağlı olarak aşağıdakilerden birini seçin:

• getLastLocation() konum tahminini daha hızlı alır ve uygulamanızın pil kullanımını en aza indirir. Ancak yakın zamanda başka bir istemci konumu etkin bir şekilde kullanmadıysa konum bilgileri güncel olmayabilir.

• getCurrentLocation() daha güncel ve doğru konum bilgilerini daha tutarlı bir şekilde alır. Ancak bu yöntem, cihazda etkin konum hesaplamasının yapılmasına neden olabilir.

  Mümkün olduğunda yeni bir konum almanın önerilen yolu budur ve requestLocationUpdates() kullanarak konum güncellemelerini kendiniz başlatıp yönetmek gibi alternatiflerden daha güvenlidir. Uygulamanız requestLocationUpdates() yöntemini çağırıyorsa konum kullanılamadığında veya yeni bir konum alındıktan sonra istek doğru şekilde durdurulmadığında bazen büyük miktarda güç tüketebilir.

Ek kaynaklar

Android'de mevcut konumu getirme hakkında daha fazla bilgi için aşağıdaki materyalleri inceleyin:

Örnekler

• Mevcut konumu getirirken en iyi uygulamaları gösteren örnek uygulama.