เปลี่ยนการตั้งค่าตำแหน่ง

หากแอปของคุณจำเป็นต้องขอตำแหน่งหรือรับการอัปเดตสิทธิ์ อุปกรณ์จะต้องเปิดใช้การตั้งค่าระบบที่เหมาะสม เช่น การสแกน GPS หรือ Wi-Fi แอปจะระบุระดับความแม่นยำ/การสิ้นเปลืองพลังงานที่ต้องการและช่วงเวลาการอัปเดตที่ต้องการแทนการเปิดใช้บริการโดยตรง เช่น GPS ของอุปกรณ์ จากนั้นอุปกรณ์จะทำการเปลี่ยนแปลงที่เหมาะสมในการตั้งค่าระบบโดยอัตโนมัติ การตั้งค่าเหล่านี้กําหนดโดยออบเจ็กต์ข้อมูล LocationRequest

บทเรียนนี้จะแสดงวิธีใช้ไคลเอ็นต์การตั้งค่าเพื่อตรวจสอบการตั้งค่าที่เปิดใช้อยู่ และแสดงกล่องโต้ตอบการตั้งค่าตำแหน่งเพื่อให้ผู้ใช้อัปเดตการตั้งค่าได้ด้วยการแตะเพียงครั้งเดียว

กำหนดค่าบริการตำแหน่ง

หากต้องการใช้บริการตำแหน่งที่ Google Play Services และผู้ให้บริการตำแหน่งแบบรวมไว้ให้ ให้เชื่อมต่อแอปโดยใช้ Settings Client จากนั้นตรวจสอบการตั้งค่าตำแหน่งปัจจุบันและแจ้งให้ผู้ใช้เปิดการตั้งค่าที่จำเป็น หากจำเป็น

แอปที่มีฟีเจอร์ใช้บริการตำแหน่งต้องขอสิทธิ์เข้าถึงตำแหน่ง โดยขึ้นอยู่กับกรณีการใช้งานของฟีเจอร์เหล่านั้น

ตั้งค่าคำขอตำแหน่ง

หากต้องการจัดเก็บพารามิเตอร์สําหรับคําขอที่ส่งไปยังผู้ให้บริการ Fused Location ให้สร้าง LocationRequest พารามิเตอร์จะเป็นตัวกำหนดระดับความแม่นยำของคำขอตำแหน่ง ดูรายละเอียดของตัวเลือกคำขอตำแหน่งทั้งหมดที่มีได้ที่ข้อมูลอ้างอิงชั้นเรียน LocationRequest บทเรียนนี้จะกำหนดช่วงเวลาการอัปเดต ช่วงเวลาการอัปเดตที่เร็วที่สุด และลำดับความสำคัญตามที่อธิบายไว้ด้านล่าง

ช่วงเวลาการอัปเดต

setInterval() - วิธีนี้จะกำหนดอัตราเป็นมิลลิวินาทีที่แอปต้องการรับการอัปเดตตำแหน่ง โปรดทราบว่าการอัปเดตตำแหน่งอาจเร็วหรือช้ากว่าอัตรานี้เพื่อเพิ่มประสิทธิภาพการใช้งานแบตเตอรี่ หรืออาจไม่มีการอัปเดตเลย (เช่น หากอุปกรณ์ไม่มีการเชื่อมต่อ)

ช่วงเวลาการอัปเดตที่เร็วที่สุด

setFastestInterval() - วิธีนี้จะกำหนดอัตราที่เร็วที่สุดเป็นมิลลิวินาที ซึ่งแอปของคุณจะจัดการการอัปเดตตำแหน่งได้ คุณไม่จำเป็นต้องเรียกใช้เมธอดนี้ เว้นแต่แอปจะได้รับประโยชน์จากการรับการอัปเดตเร็วกว่าอัตราที่ระบุไว้ใน setInterval()

ความสำคัญ

setPriority() - วิธีการนี้จะกำหนดลำดับความสำคัญของคำขอ ซึ่งจะช่วยให้บริการตำแหน่งของบริการ Google Play มีคำแนะนำที่ชัดเจนเกี่ยวกับแหล่งที่มาของตำแหน่งที่จะใช้ ค่าที่รองรับมีดังนี้

• PRIORITY_BALANCED_POWER_ACCURACY - ใช้การตั้งค่านี้เพื่อขอความแม่นยำของตำแหน่งภายในบล็อกของเมือง ซึ่งมีความแม่นยำประมาณ 100 เมตร ซึ่งถือว่ามีความแม่นยำในระดับหยาบ และอาจมีแนวโน้มที่จะใช้พลังงานน้อยลง เมื่อใช้การตั้งค่านี้ บริการตำแหน่งมีแนวโน้มที่จะใช้ตำแหน่ง Wi-Fi และเสาสัญญาณมือถือ อย่างไรก็ตาม โปรดทราบว่าการเลือกผู้ให้บริการตำแหน่งขึ้นอยู่กับปัจจัยอื่นๆ อีกหลายอย่าง เช่น แหล่งที่มาที่พร้อมใช้งาน
• PRIORITY_HIGH_ACCURACY - ใช้การตั้งค่านี้เพื่อขอตำแหน่งที่แม่นยำที่สุด การตั้งค่านี้จะทำให้บริการระบุตำแหน่งมีแนวโน้มที่จะใช้ GPS เพื่อระบุตำแหน่ง
• PRIORITY_LOW_POWER - ใช้การตั้งค่านี้เพื่อขอความแม่นยำระดับเมือง ซึ่งมีความแม่นยำประมาณ 10 กิโลเมตร ซึ่งถือว่ามีความแม่นยำในระดับหยาบ และอาจมีแนวโน้มที่จะใช้พลังงานน้อยลง
• PRIORITY_NO_POWER - ใช้การตั้งค่านี้หากต้องการลดการใช้พลังงานให้เหลือน้อยที่สุด แต่ต้องการรับการอัปเดตตำแหน่งเมื่อพร้อมใช้งาน เมื่อใช้การตั้งค่านี้ แอปจะไม่ทริกเกอร์การอัปเดตตำแหน่ง แต่จะรับตำแหน่งที่แอปอื่นๆ ทริกเกอร์

สร้างคำขอตำแหน่งและตั้งค่าพารามิเตอร์ตามที่แสดงในตัวอย่างโค้ดนี้

Kotlin

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

Java

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

ลำดับความสำคัญของ PRIORITY_HIGH_ACCURACY ร่วมกับการตั้งค่าสิทธิ์ ACCESS_FINE_LOCATION ที่คุณกำหนดไว้ในไฟล์ Manifest ของแอป และช่วงเวลาการอัปเดตที่รวดเร็ว 5,000 มิลลิวินาที (5 วินาที) ทำให้ผู้ให้บริการตำแหน่งแบบรวมแสดงข้อมูลอัปเดตตำแหน่งที่แม่นยำภายในระยะไม่กี่ฟุต วิธีนี้เหมาะสำหรับแอปการแมปที่แสดงตำแหน่งแบบเรียลไทม์

เคล็ดลับด้านประสิทธิภาพ: หากแอปเข้าถึงเครือข่ายหรือทํางานอื่นๆ ที่ใช้เวลานานหลังจากได้รับการอัปเดตตําแหน่ง ให้ปรับช่วงเวลาที่เร็วที่สุดเป็นค่าที่ช้าลง การปรับนี้จะช่วยป้องกันไม่ให้แอปของคุณได้รับการอัปเดตที่ใช้ไม่ได้ เมื่องานระยะยาวเสร็จสิ้นแล้ว ให้ตั้งค่าช่วงเวลาที่เร็วที่สุดกลับไปเป็นค่าที่เร็ว

รับการตั้งค่าตำแหน่งปัจจุบัน

เมื่อคุณเชื่อมต่อกับบริการ Google Play และ API ของบริการตำแหน่งแล้ว คุณจะได้รับการตั้งค่าตำแหน่งปัจจุบันของอุปกรณ์ของผู้ใช้ หากต้องการดำเนินการ ให้สร้าง LocationSettingsRequest.Builder แล้วเพิ่มคำขอตำแหน่งอย่างน้อย 1 รายการ ข้อมูลโค้ดต่อไปนี้แสดงวิธีเพิ่มคําขอตําแหน่งที่สร้างขึ้นในขั้นตอนก่อนหน้า

Kotlin

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

Java

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

ต่อไปให้ตรวจสอบว่าเป็นไปตามการตั้งค่าตำแหน่งปัจจุบันหรือไม่ ดังนี้

Kotlin

val builder = LocationSettingsRequest.Builder()

// ...

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

Java

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

// ...

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

เมื่อ Task เสร็จสมบูรณ์แล้ว แอปจะตรวจสอบการตั้งค่าตำแหน่งได้โดยดูที่รหัสสถานะจากออบเจ็กต์ LocationSettingsResponse หากต้องการรายละเอียดเพิ่มเติมเกี่ยวกับสถานะปัจจุบันของการตั้งค่าตำแหน่งที่เกี่ยวข้อง แอปสามารถเรียกใช้เมธอดของออบเจ็กต์ LocationSettingsResponse getLocationSettingsStates()

แจ้งให้ผู้ใช้เปลี่ยนการตั้งค่าตำแหน่ง

หากต้องการตรวจสอบว่าการตั้งค่าตำแหน่งเหมาะสมกับคำขอตำแหน่งหรือไม่ ให้เพิ่ม OnFailureListener ลงในออบเจ็กต์ Task ที่ตรวจสอบการตั้งค่าตำแหน่ง จากนั้นตรวจสอบว่าออบเจ็กต์ Exception ที่ส่งไปยังเมธอด onFailure() เป็นอินสแตนซ์ของคลาส ResolvableApiException หรือไม่ ซึ่งบ่งชี้ว่าต้องมีการเปลี่ยนการตั้งค่า จากนั้นแสดงกล่องโต้ตอบที่แจ้งให้ผู้ใช้ขอสิทธิ์แก้ไขการตั้งค่าตำแหน่งโดยเรียกใช้ startResolutionForResult()

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีตรวจสอบว่าการตั้งค่าตำแหน่งของผู้ใช้อนุญาตให้บริการหาตำแหน่งสร้าง LocationRequest หรือไม่ รวมถึงวิธีขอสิทธิ์จากผู้ใช้เพื่อเปลี่ยนการตั้งค่าตำแหน่งหากจำเป็น

Kotlin

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.
        }
    }
}

Java

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.
            }
        }
    }
});

บทเรียนถัดไป การรับการอัปเดตตำแหน่ง จะแสดงวิธีรับการอัปเดตตำแหน่งเป็นระยะ