ขออัปเดตตำแหน่ง

การใช้ข้อมูลตำแหน่งอย่างเหมาะสมจะเป็นประโยชน์ต่อผู้ใช้แอป เช่น หากแอปช่วยผู้ใช้ในการค้นหาเส้นทางขณะเดินหรือขับรถ หรือหากแอปติดตามตำแหน่งของสินทรัพย์ แอปจะต้องรับตำแหน่งของอุปกรณ์เป็นระยะๆ นอกจากสถานที่ตั้งทางภูมิศาสตร์ (ละติจูดและลองจิจูด) แล้ว คุณอาจต้องการให้ข้อมูลเพิ่มเติมแก่ผู้ใช้ เช่น ทิศทาง (ทิศทางการเคลื่อนที่ในแนวนอน) ความสูง หรือความเร็วของอุปกรณ์ ข้อมูลนี้และข้อมูลอื่นๆ มีอยู่ในออบเจ็กต์ Location ที่แอปสามารถดึงข้อมูลจากผู้ให้บริการตำแหน่งแบบรวม ด้วยเหตุนี้ API จึงอัปเดตแอปเป็นระยะๆ ด้วยตำแหน่งที่ดีที่สุดที่พร้อมใช้งาน โดยอิงตามผู้ให้บริการตำแหน่งที่พร้อมใช้งานในปัจจุบัน เช่น Wi-Fi และ GPS (ระบบกำหนดตำแหน่งทั่วโลก) ความแม่นยำของตำแหน่งจะขึ้นอยู่กับผู้ให้บริการ, สิทธิ์เข้าถึงตำแหน่งที่คุณขอ และตัวเลือกที่คุณตั้งค่าในคำขอตำแหน่ง

บทเรียนนี้จะแสดงวิธีขอการอัปเดตตำแหน่งของอุปกรณ์เป็นประจําโดยใช้เมธอด requestLocationUpdates() ในผู้ให้บริการตำแหน่งแบบรวม

รับตำแหน่งที่รู้จักล่าสุด

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

ส่งคำขอตำแหน่ง

ก่อนที่จะขออัปเดตตำแหน่ง แอปต้องเชื่อมต่อกับบริการตำแหน่งและส่งคำขอตำแหน่ง บทเรียนเกี่ยวกับการเปลี่ยนการตั้งค่าตำแหน่งจะแสดงวิธีดำเนินการนี้ เมื่อส่งคำขอตำแหน่งแล้ว คุณจะเริ่มต้นการอัปเดตตามปกติได้โดยโทรไปที่ requestLocationUpdates()

ผู้ให้บริการตำแหน่งที่ผสานจะเรียกใช้เมธอดการเรียกกลับ LocationCallback.onLocationResult() และส่งรายการออบเจ็กต์ Location หรือจะส่ง PendingIntent ที่มีตำแหน่งในข้อมูลแบบขยายก็ได้ ทั้งนี้ขึ้นอยู่กับรูปแบบของคำขอ ความแม่นยำและความถี่ในการอัปเดตจะขึ้นอยู่กับสิทธิ์เข้าถึงตำแหน่งที่คุณได้ส่งคำขอและตัวเลือกที่คุณกำหนดไว้ในออบเจ็กต์คำขอตำแหน่ง

บทเรียนนี้จะแสดงวิธีรับการอัปเดตโดยใช้แนวทางการเรียกกลับ LocationCallback เรียกใช้ requestLocationUpdates() โดยส่งอินสแตนซ์ของออบเจ็กต์ LocationRequest และ LocationCallback กำหนดเมธอด startLocationUpdates() ดังที่แสดงในตัวอย่างโค้ดต่อไปนี้

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

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

กำหนดการเรียกกลับการอัปเดตตำแหน่ง

ผู้ให้บริการตำแหน่งที่ผสานจะเรียกใช้เมธอด Callback ของ LocationCallback.onLocationResult() อาร์กิวเมนต์ขาเข้ามีออบเจ็กต์รายการ Location ที่มีละติจูดและลองจิจูดของตำแหน่ง ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้LocationCallback อินเทอร์เฟซและกำหนดเมธอด จากนั้นรับการประทับเวลาของการอัปเดตตำแหน่ง และแสดงละติจูด ลองจิจูด และการประทับเวลาในอินเทอร์เฟซผู้ใช้ของแอป

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

หยุดการอัปเดตตำแหน่ง

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

หากต้องการหยุดการอัปเดตตำแหน่ง ให้โทรหา removeLocationUpdates() แล้วส่งต่อ LocationCallback ดังที่แสดงในตัวอย่างโค้ดต่อไปนี้

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

ใช้บูลีน requestingLocationUpdates เพื่อติดตามว่าขณะนี้การอัปเดตตำแหน่งเปิดอยู่หรือไม่ ในเมธอด onResume() ของกิจกรรม ให้ตรวจสอบว่าขณะนี้การอัปเดตตำแหน่งทำงานอยู่หรือไม่ และเปิดใช้งานหากไม่ได้ทำงานอยู่ โดยทำดังนี้

Kotlin

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

Java

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

บันทึกสถานะของกิจกรรม

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

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้การเรียกกลับของกิจกรรม onSaveInstanceState() เพื่อบันทึกสถานะอินสแตนซ์

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

กำหนดเมธอด updateValuesFromBundle() เพื่อกู้คืนค่าที่บันทึกไว้จากอินสแตนซ์ก่อนหน้าของกิจกรรม หากมี เรียกใช้เมธอดจากเมธอด onCreate() ของกิจกรรม ดังที่แสดงในตัวอย่างโค้ดต่อไปนี้

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการบันทึกสถานะอินสแตนซ์ได้ที่ข้อมูลอ้างอิงคลาส Android Activity

หมายเหตุ: หากต้องการพื้นที่เก็บข้อมูลที่ถาวรมากขึ้น คุณสามารถจัดเก็บค่ากําหนดของผู้ใช้ไว้ในSharedPreferencesของแอป ตั้งค่ากำหนดที่แชร์ในเมธอด onPause() ของกิจกรรม และเรียกข้อมูลค่ากำหนดใน onResume() ดูข้อมูลเพิ่มเติมเกี่ยวกับการบันทึกค่ากําหนดได้ที่หัวข้อการบันทึกชุดคีย์-ค่า

แหล่งข้อมูลเพิ่มเติม

หากต้องการดูข้อมูลเพิ่มเติม โปรดใช้ประโยชน์จากแหล่งข้อมูลต่อไปนี้

ตัวอย่าง

• แอปตัวอย่างเพื่อสาธิตการรับการอัปเดตตำแหน่งใน Android