Konum güncellemeleri isteyin

Konum bilgilerinin uygun şekilde kullanılması, uygulamanızın kullanıcıları için faydalı olabilir. Örneğin, uygulamanız yürürken veya araç kullanırken kullanıcıların yol bulmasına yardımcı oluyorsa ya da öğelerin konumunu izliyorsa düzenli aralıklarla cihazın konumunu alması gerekir. Coğrafi konumun (enlem ve boylam) yanı sıra, kullanıcıya cihazın yön (yatay yönü), rakımı veya hızı gibi ek bilgiler vermek isteyebilirsiniz. Bu bilgiler ve daha fazlası, uygulamanızın çok kaynaklı konum sağlayıcıdan alabileceği Location nesnesinde bulunur. Bunun üzerine API, uygulamanızı, WiFi ve GPS (Küresel Konumlandırma Sistemi) gibi şu anda mevcut olan konum sağlayıcılara dayalı olarak mevcut en iyi konumla düzenli olarak günceller. Konumun doğruluğu sağlayıcılara, istediğiniz konum izinlerine ve konum isteğinde belirlediğiniz seçeneklere göre belirlenir.

Bu derste, çok kaynaklı konum sağlayıcıdaki requestLocationUpdates() yöntemini kullanarak bir cihazın konumuyla ilgili düzenli güncellemeleri nasıl isteyeceğiniz gösterilmektedir.

Bilinen son konumu alma

Cihazın bilinen son konumu, periyodik konum güncellemelerine başlamadan önce uygulamanın bilinen bir konuma sahip olmasını sağlayarak, başlangıç için kullanışlı bir temel sağlar. Bilinen Son Konumu Edinme dersinde, getLastLocation() numaralı telefonu arayarak bilinen son konuma nasıl ulaşacağınız hakkında bilgi edinebilirsiniz. Aşağıdaki bölümlerde yer alan snippet'lerde, uygulamanızın bilinen son konumu zaten aldığı ve mCurrentLocation genel değişkeninde bir Location nesnesi olarak depoladığı varsayılmaktadır.

Konum isteğinde bulunma

Konum güncellemeleri istemeden önce uygulamanızın konum hizmetlerine bağlanması ve konum isteğinde bulunması gerekir. Konum Ayarlarını Değiştirme dersinde bunu nasıl yapacağınız gösterilmektedir. Konum isteği yapıldıktan sonra requestLocationUpdates() numaralı telefonu arayarak düzenli güncellemeleri başlatabilirsiniz.

İsteğin biçimine bağlı olarak, çok kaynaklı konum sağlayıcı LocationCallback.onLocationResult() geri çağırma yöntemini çağırır ve buna Location nesnelerinin bir listesini iletir veya genişletilmiş verilerinde konumu içeren bir PendingIntent yayınlar. Güncellemelerin doğruluğu ve sıklığı, hem istediğiniz konum izinlerinden hem de konum isteği nesnesinde ayarladığınız seçeneklerden etkilenir.

Bu derste, LocationCallback geri çağırma yaklaşımını kullanarak güncellemeyi nasıl alacağınız gösterilmektedir. LocationRequest nesnesi örneğinizi ileterek requestLocationUpdates() çağrısı ve bir LocationCallback. Aşağıdaki kod örneğinde gösterildiği gibi bir startLocationUpdates() yöntemi tanımlayın:

Kotlin

override fun onResume() {
    super.onResume()
    if (requestingLocationUpdates) startLocationUpdates()
}

private fun startLocationUpdates() {
    fusedLocationClient.requestLocationUpdates(locationRequest,
            locationCallback,
            Looper.getMainLooper())
}

Java

@Override
protected void onResume() {
    super.onResume();
    if (requestingLocationUpdates) {
        startLocationUpdates();
    }
}

private void startLocationUpdates() {
    fusedLocationClient.requestLocationUpdates(locationRequest,
            locationCallback,
            Looper.getMainLooper());
}

Yukarıdaki kod snippet'inin, kullanıcının konum güncellemelerini açıp açmadığını izlemek için kullanılan requestingLocationUpdates adlı boole işaretini belirttiğine dikkat edin. Kullanıcılar konum güncellemelerini kapattıysa uygulamanızın konum gereksinimi hakkında kendilerini bilgilendirebilirsiniz. Boole işaretinin değerini etkinliğin örneklerinde koruma hakkında daha fazla bilgi için Etkinliğin Durumunu Kaydetme bölümüne bakın.

Konum güncelleme geri çağırmasını tanımlayın

Çok kaynaklı konum sağlayıcı, LocationCallback.onLocationResult() geri çağırma yöntemini çağırır. Gelen bağımsız değişken, konumun enlem ve boylamını içeren bir liste Location nesnesi içerir. Aşağıdaki snippet'te LocationCallback arayüzünün nasıl uygulanacağı ve yöntemin nasıl tanımlanacağı, ardından konum güncellemesinin zaman damgasını almanın ve uygulamanızın kullanıcı arayüzünde enlem, boylam ve zaman damgasının nasıl görüntüleneceğini gösterir:

Kotlin

private lateinit var locationCallback: LocationCallback

// ...

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

    locationCallback = object : LocationCallback() {
        override fun onLocationResult(locationResult: LocationResult?) {
            locationResult ?: return
            for (location in locationResult.locations){
                // Update UI with location data
                // ...
            }
        }
    }
}

Java

private LocationCallback locationCallback;

// ...

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

    locationCallback = new LocationCallback() {
        @Override
        public void onLocationResult(LocationResult locationResult) {
            if (locationResult == null) {
                return;
            }
            for (Location location : locationResult.getLocations()) {
                // Update UI with location data
                // ...
            }
        }
    };
}

Konum güncellemelerini durdur

Etkinlik artık odakta değilken (ör. kullanıcı başka bir uygulamaya veya aynı uygulamadaki farklı bir etkinliğe geçtiğinde) konum güncellemelerini durdurmak isteyip istemediğinizi düşünün. Bu, uygulamanın arka planda çalışırken bile bilgi toplaması gerekmiyorsa güç tüketimini azaltmak için kullanışlı olabilir. Bu bölümde, etkinliğin onPause() yöntemindeki güncellemeleri nasıl durdurabileceğiniz gösterilmektedir.

Konum güncellemelerini durdurmak için aşağıdaki kod örneğinde gösterildiği gibi bir LocationCallback ileterek removeLocationUpdates() çağrısı yapın:

Kotlin

override fun onPause() {
    super.onPause()
    stopLocationUpdates()
}

private fun stopLocationUpdates() {
    fusedLocationClient.removeLocationUpdates(locationCallback)
}

Java

@Override
protected void onPause() {
    super.onPause();
    stopLocationUpdates();
}

private void stopLocationUpdates() {
    fusedLocationClient.removeLocationUpdates(locationCallback);
}

Konum güncellemelerinin şu anda açık olup olmadığını izlemek için bir boole (requestingLocationUpdates) kullanın. Etkinliğin onResume() yönteminde konum güncellemelerinin şu anda etkin olup olmadığını kontrol edin. Etkin değilse etkinleştirin:

Kotlin

override fun onResume() {
    super.onResume()
    if (requestingLocationUpdates) startLocationUpdates()
}

Java

@Override
protected void onResume() {
    super.onResume();
    if (requestingLocationUpdates) {
        startLocationUpdates();
    }
}

Etkinliğin durumunu kaydetme

Cihazın yapılandırmasında yapılan bir değişiklik (ör. ekran yönünün veya dilin değiştirilmesi), mevcut etkinliğin kaldırılmasına neden olabilir. Dolayısıyla uygulamanız, etkinliği yeniden oluşturmak için ihtiyaç duyduğu tüm bilgileri depolamalıdır. Bunu yapmanın bir yolu, Bundle nesnesinde depolanan bir örnek durumunu kullanmaktır.

Aşağıdaki kod örneğinde, örneğin durumunu kaydetmek için etkinliğin onSaveInstanceState() geri çağırma işlevinin nasıl kullanılacağı gösterilmektedir:

Kotlin

override fun onSaveInstanceState(outState: Bundle?) {
    outState?.putBoolean(REQUESTING_LOCATION_UPDATES_KEY, requestingLocationUpdates)
    super.onSaveInstanceState(outState)
}

Java

@Override
protected void onSaveInstanceState(Bundle outState) {
    outState.putBoolean(REQUESTING_LOCATION_UPDATES_KEY,
            requestingLocationUpdates);
    // ...
    super.onSaveInstanceState(outState);
}

Etkinliğin önceki örneğindeki kayıtlı değerleri (varsa) geri yüklemek için bir updateValuesFromBundle() yöntemi tanımlayın. Aşağıdaki kod örneğinde gösterildiği gibi, etkinliğin onCreate() yönteminden yöntemi çağırın:

Kotlin

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

private fun updateValuesFromBundle(savedInstanceState: Bundle?) {
    savedInstanceState ?: return

    // Update the value of requestingLocationUpdates from the Bundle.
    if (savedInstanceState.keySet().contains(REQUESTING_LOCATION_UPDATES_KEY)) {
        requestingLocationUpdates = savedInstanceState.getBoolean(
                REQUESTING_LOCATION_UPDATES_KEY)
    }

    // ...

    // Update UI to match restored state
    updateUI()
}

Java

@Override
public void onCreate(Bundle savedInstanceState) {
    // ...
    updateValuesFromBundle(savedInstanceState);
}

private void updateValuesFromBundle(Bundle savedInstanceState) {
    if (savedInstanceState == null) {
        return;
    }

    // Update the value of requestingLocationUpdates from the Bundle.
    if (savedInstanceState.keySet().contains(REQUESTING_LOCATION_UPDATES_KEY)) {
        requestingLocationUpdates = savedInstanceState.getBoolean(
                REQUESTING_LOCATION_UPDATES_KEY);
    }

    // ...

    // Update UI to match restored state
    updateUI();
}

Örnek durumunu kaydetme hakkında daha fazla bilgi için Android Etkinliği sınıf referansına bakın.

Not: Daha kalıcı bir depolama için kullanıcının tercihlerini uygulamanızın SharedPreferences bölümünde depolayabilirsiniz. Etkinliğinizin onPause() yönteminde paylaşılan tercihi ayarlayın ve onResume() bölümünden tercihi alın. Tercihleri kaydetme hakkında daha fazla bilgi için Anahtar/Değer Gruplarını Kaydetme bölümüne bakın.

Ek kaynaklar

Daha fazla bilgi edinmek için aşağıdaki kaynaklardan yararlanın:

Numuneler

  • Android'de konum güncellemelerini aldığınızı göstermek için örnek uygulama.