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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 ดังที่แสดงในตัวอย่างโค้ดต่อไปนี้

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@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