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.