การใช้ข้อมูลตำแหน่งอย่างเหมาะสมจะเป็นประโยชน์ต่อผู้ใช้แอปของคุณ ตัวอย่างเช่น หากแอปช่วยผู้ใช้ค้นหาเส้นทางขณะเดินหรือขับรถ หรือหากแอปติดตามตำแหน่งของเนื้อหา แอปจะต้องรับตำแหน่งของอุปกรณ์เป็นระยะๆ นอกจากสถานที่ตั้งทางภูมิศาสตร์ (ละติจูดและลองจิจูด) แล้ว คุณอาจต้องการให้ข้อมูลเพิ่มเติมแก่ผู้ใช้ เช่น ทิศทาง (ทิศทางการเดินทางในแนวนอน) ระดับความสูง หรือความเร็วของอุปกรณ์ ข้อมูลนี้และข้อมูลอื่นๆ มีอยู่ในออบเจ็กต์ 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() ดังที่แสดงในตัวอย่างโค้ดต่อไปนี้
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());
}
โปรดทราบว่าข้อมูลโค้ดก่อนหน้านี้อ้างอิงถึงแฟล็กบูลีน requestingLocationUpdates ซึ่งใช้เพื่อติดตามว่าผู้ใช้เปิดหรือปิดการอัปเดตตำแหน่ง หากผู้ใช้ปิดการอัปเดตตำแหน่ง คุณสามารถแจ้งให้ผู้ใช้ทราบถึงข้อกำหนดด้านตำแหน่งของแอปได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการคงค่าของแฟล็กบูลีนในอินสแตนซ์ต่างๆ ของกิจกรรมได้ที่บันทึกสถานะของกิจกรรม
กำหนด Callback การอัปเดตตำแหน่ง
ผู้ให้บริการ Fused Location จะเรียกใช้เมธอด 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
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ Callback 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
แหล่งข้อมูลเพิ่มเติม
ดูข้อมูลเพิ่มเติมได้จากแหล่งข้อมูลต่อไปนี้
ตัวอย่าง
- แอปตัวอย่างเพื่อสาธิตการรับการอัปเดตตำแหน่งใน Android