Konum ayarlarını değiştirme

Uygulamanızın konum istemesi veya izin güncellemeleri alması gerekiyorsa cihazın GPS ya da kablosuz ağ taraması gibi uygun sistem ayarlarını etkinleştirmesi gerekir. Cihazın GPS'i gibi hizmetleri doğrudan etkinleştirmek yerine, uygulamanız gerekli doğruluk/güç tüketimi ve istenen güncelleme aralığını belirtir; cihaz da sistem ayarlarında uygun değişiklikleri otomatik olarak yapar. Bu ayarlar LocationRequest veri nesnesiyle tanımlanır.

Bu derste, hangi ayarların etkin olduğunu kontrol etmek için Ayarlar İstemcisi'nin nasıl kullanılacağı ve kullanıcının tek bir dokunuşla ayarlarını güncellemesi için Konum Ayarları iletişim kutusunun nasıl gösterileceği gösterilmektedir.

Konum hizmetlerini yapılandırma

Google Play Hizmetleri ve çok kaynaklı konum sağlayıcısı tarafından sağlanan konum hizmetlerini kullanmak için uygulamanızı Ayarlar İstemcisi'ni kullanarak bağlayın, ardından mevcut konum ayarlarını kontrol edin ve gerekirse kullanıcıdan gerekli ayarları etkinleştirmesini isteyin.

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

Konum isteği oluşturma

Çok kaynaklı konum sağlayıcıya gönderilen isteklerle ilgili parametreleri depolamak için bir LocationRequest oluşturun. Parametreler, konum isteklerinin doğruluk düzeyini belirler. Mevcut tüm konum isteği seçeneklerinin ayrıntıları için LocationRequest sınıf referansına bakın. Bu ders, aşağıda açıklandığı gibi güncelleme aralığını, en hızlı güncelleme aralığını ve önceliği ayarlar:

Güncelleme aralığı

setInterval() - Bu yöntem, uygulamanızın konum güncellemelerini almayı tercih ettiği hızı milisaniye cinsinden belirler. Pil kullanımını optimize etmek için konum güncellemelerinin bu hızdan biraz daha hızlı veya yavaş olabileceğini ya da hiç güncelleme olmayabileceğini (örneğin, cihazın bağlantısı yoksa) unutmayın.

En hızlı güncelleme aralığı

setFastestInterval() - Bu yöntem, uygulamanızın konum güncellemelerini işleyebildiği en hızlı hızı milisaniye cinsinden belirler. Uygulamanız, güncellemeleri setInterval() içinde belirtilen orandan daha hızlı alma imkanı sunmuyorsa bu yöntemi çağırmanıza gerek yoktur.

Öncelik

setPriority() - Bu yöntem, isteğin önceliğini ayarlar. Böylece Google Play Hizmetleri konum hizmetlerine, kullanılacak konum kaynakları hakkında güçlü bir ipucu verilir. Aşağıdaki değerler desteklenir:

• PRIORITY_BALANCED_POWER_ACCURACY - Bir şehir bloğunda konum hassasiyeti istemek için bu ayarı kullanın. Bu doğruluk yaklaşık 100 metredir. Bu, genel bir doğruluk düzeyi olarak kabul edilir ve muhtemelen daha az güç tüketir. Bu ayarla, konum hizmetleri büyük olasılıkla kablosuz ve baz istasyonu konumlandırmasını kullanır. Bununla birlikte, konum sağlayıcı seçiminin, hangi kaynakların mevcut olduğu gibi diğer birçok faktöre bağlı olduğunu unutmayın.
• PRIORITY_HIGH_ACCURACY - Mümkün olan en kesin konumu istemek için bu ayarı kullanın. Bu ayarla, konum hizmetlerinin konumu belirlemek için GPS kullanma olasılığı daha yüksek olur.
• PRIORITY_LOW_POWER - Şehir düzeyinde kesinlik isteğinde bulunmak için bu ayarı kullanın. Bu kesinlik, yaklaşık 10 kilometrelik bir doğruluk oranı sunar. Bu, genel bir doğruluk düzeyi olarak kabul edilir ve muhtemelen daha az güç tüketir.
• PRIORITY_NO_POWER - Güç tüketimi üzerinde önemsiz bir etkiye ihtiyacınız varsa ancak mümkün olduğunda konum güncellemelerini almak istiyorsanız bu ayarı kullanın. Bu ayarla, uygulamanız konum güncellemelerini tetiklemez, ancak diğer uygulamalar tarafından tetiklenen konumları alır.

Konum isteğini oluşturun ve parametreleri şu kod örneğinde gösterildiği gibi ayarlayın:

fun createLocationRequest() {
  val locationRequest = LocationRequest.Builder()
      .setIntervalMillis(10000)
      .setFastestIntervalMillis(5000)
      .setPriority(LocationRequest.PRIORITY_HIGH_ACCURACY)
      .build()
}

protected void createLocationRequest() {
  LocationRequest locationRequest = LocationRequest.Builder()
      .setIntervalMillis(10000)
      .setFastestIntervalMillis(5000)
      .setPriority(LocationRequest.PRIORITY_HIGH_ACCURACY)
      .build();
}

PRIORITY_HIGH_ACCURACY önceliği, uygulama manifestinde tanımladığınız ACCESS_FINE_LOCATION izin ayarı ve 5.000 milisaniye (5 saniye) olan hızlı güncelleme aralığıyla birlikte, çok kaynaklı konum sağlayıcısının birkaç fit içinde doğru konum güncellemeleri döndürmesine neden olur. Bu yaklaşım, konumu gerçek zamanlı olarak gösteren harita uygulamaları için uygundur.

Performans ipucu: Uygulamanız konum güncellemesi aldıktan sonra ağa erişiyor veya başka uzun süreli çalışmalar yapıyorsa en hızlı aralığı daha yavaş bir değere ayarlayın. Bu ayarlama, uygulamanızın kullanamadığı güncellemeleri almasını engeller. Uzun süreli çalışmalar tamamlandıktan sonra en hızlı aralığı tekrar hızlı bir değere ayarlayın.

Geçerli konum ayarlarını al

Google Play Hizmetleri'ne ve Konum Hizmetleri API'sine bağlandıktan sonra kullanıcının cihazının geçerli konum ayarlarını alabilirsiniz. Bunu yapmak için bir LocationSettingsRequest.Builder oluşturup bir veya daha fazla konum isteği ekleyin. Aşağıdaki kod snippet'inde, önceki adımda oluşturulan konum isteğinin nasıl ekleneceği gösterilmektedir:

val builder = LocationSettingsRequest.Builder()
        .addLocationRequest(locationRequest)

LocationSettingsRequest.Builder builder = new LocationSettingsRequest.Builder()
     .addLocationRequest(locationRequest);

Sonra, geçerli konum ayarlarının uygun olup olmadığını kontrol edin:

val builder = LocationSettingsRequest.Builder()

// ...

val client: SettingsClient = LocationServices.getSettingsClient(this)
val task: Task<LocationSettingsResponse> = client.checkLocationSettings(builder.build())

LocationSettingsRequest.Builder builder = new LocationSettingsRequest.Builder();

// ...

SettingsClient client = LocationServices.getSettingsClient(this);
Task<LocationSettingsResponse> task = client.checkLocationSettings(builder.build());

Task tamamlandığında, uygulamanız LocationSettingsResponse nesnesindeki durum koduna bakarak konum ayarlarını kontrol edebilir. Uygulamanız, alakalı konum ayarlarının mevcut durumu hakkında daha da fazla ayrıntı almak için LocationSettingsResponse nesnesinin getLocationSettingsStates() yöntemini çağırabilir.

Kullanıcıdan konum ayarlarını değiştirmesini iste

Konum ayarlarının konum isteği için uygun olup olmadığını belirlemek üzere Task nesnesine konum ayarlarını doğrulayan bir OnFailureListener ekleyin. Ardından, onFailure() yöntemine iletilen Exception nesnesinin, ResolvableApiException sınıfının bir örneği olup olmadığını kontrol edin. Bu, ayarların değiştirilmesi gerektiğini belirtir. Ardından, startResolutionForResult() numaralı telefonu arayarak konum ayarlarını değiştirme izni isteyen bir iletişim kutusu görüntüleyin.

Aşağıdaki kod snippet'i, kullanıcının konum ayarlarının, konum hizmetlerinin LocationRequest oluşturmasına izin verip vermediğini nasıl belirleyeceğini ve gerekirse konum ayarlarını değiştirme izninin nasıl isteneceğini gösterir:

task.addOnSuccessListener { locationSettingsResponse ->
    // All location settings are satisfied. The client can initialize
    // location requests here.
    // ...
}

task.addOnFailureListener { exception ->
    if (exception is ResolvableApiException){
        // Location settings are not satisfied, but this can be fixed
        // by showing the user a dialog.
        try {
            // Show the dialog by calling startResolutionForResult(),
            // and check the result in onActivityResult().
            exception.startResolutionForResult(this@MainActivity,
                    REQUEST_CHECK_SETTINGS)
        } catch (sendEx: IntentSender.SendIntentException) {
            // Ignore the error.
        }
    }
}

task.addOnSuccessListener(this, new OnSuccessListener<LocationSettingsResponse>() {
    @Override
    public void onSuccess(LocationSettingsResponse locationSettingsResponse) {
        // All location settings are satisfied. The client can initialize
        // location requests here.
        // ...
    }
});

task.addOnFailureListener(this, new OnFailureListener() {
    @Override
    public void onFailure(@NonNull Exception e) {
        if (e instanceof ResolvableApiException) {
            // Location settings are not satisfied, but this can be fixed
            // by showing the user a dialog.
            try {
                // Show the dialog by calling startResolutionForResult(),
                // and check the result in onActivityResult().
                ResolvableApiException resolvable = (ResolvableApiException) e;
                resolvable.startResolutionForResult(MainActivity.this,
                        REQUEST_CHECK_SETTINGS);
            } catch (IntentSender.SendIntentException sendEx) {
                // Ignore the error.
            }
        }
    }
});

Bir sonraki ders olan Konum Güncellemelerini Alma, düzenli konum güncellemelerini nasıl alacağınızı gösterir.