ขอสิทธิ์เข้าถึงตำแหน่ง

แอปที่ใช้บริการตำแหน่งต้องขอตำแหน่งเพื่อปกป้องความเป็นส่วนตัวของผู้ใช้ สิทธิ์

เมื่อขอสิทธิ์เข้าถึงตำแหน่ง ให้ทำตามแนวทางปฏิบัติแนะนำเดียวกันกับคุณ ใช้กับสิทธิ์รันไทม์อื่นๆ หรือไม่ ความแตกต่างที่สำคัญอย่างหนึ่งเกี่ยวกับสิทธิ์เข้าถึงตำแหน่งคือ มีสิทธิ์หลายอย่างที่เกี่ยวข้องกับตำแหน่ง สิทธิ์ที่คุณขอและวิธีขอสิทธิ์จะขึ้นอยู่กับข้อกำหนดตำแหน่งสำหรับ Use Case ของแอป

หน้าเว็บนี้อธิบายข้อกำหนดสถานที่ตั้งประเภทต่างๆ และให้ คําแนะนําเกี่ยวกับวิธีขอสิทธิ์เข้าถึงตําแหน่งในแต่ละกรณี

ประเภทการเข้าถึงตำแหน่ง

สิทธิ์แต่ละรายการมีชุดค่าผสมของลักษณะต่อไปนี้

ตำแหน่งเบื้องหน้า

หากแอปมีฟีเจอร์ที่แชร์หรือได้รับข้อมูลตำแหน่งเท่านั้น ครั้งเดียว หรือตามระยะเวลาที่กำหนดไว้ ฟีเจอร์นั้นจะต้องอยู่เบื้องหน้า การเข้าถึงตำแหน่ง ตัวอย่างบางส่วนมีดังนี้

  • ฟีเจอร์ภายในแอปการนำทางช่วยให้ผู้ใช้ขอเส้นทางแบบเลี้ยวต่อเลี้ยวได้
  • ฟีเจอร์ในแอปการรับส่งข้อความช่วยให้ผู้ใช้แชร์ตำแหน่งปัจจุบันกับผู้ใช้รายอื่นได้

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

  • กิจกรรมที่เป็นของแอปจะปรากฏขึ้น

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

    นอกจากนี้ เราขอแนะนำให้คุณประกาศประเภทบริการที่ทำงานอยู่เบื้องหน้าเป็น location ดังที่แสดงในข้อมูลโค้ดต่อไปนี้ ใน Android 10 (API ระดับ 29) ขึ้นไป คุณต้องประกาศบริการที่ทำงานอยู่เบื้องหน้าประเภทนี้

    <!-- Recommended for Android 9 (API level 28) and lower. -->
<!-- Required for Android 10 (API level 29) and higher. -->
<service
    android:name="MyNavigationService"
    android:foregroundServiceType="location" ... >
    <!-- Any inner elements would go here. -->
</service>

คุณประกาศความจำเป็นในเบื้องหน้าเมื่อแอปขอตำแหน่ง ACCESS_COARSE_LOCATION หรือสิทธิ์ ACCESS_FINE_LOCATION สิทธิ์ตามที่แสดงในข้อมูลโค้ดต่อไปนี้

<manifest ... >
  <!-- Always include this permission -->
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

  <!-- Include only if your app benefits from precise location access. -->
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
</manifest>

ตำแหน่งในเบื้องหลัง

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

  • ภายในแอปการแชร์ตำแหน่งของครอบครัว ฟีเจอร์หนึ่งจะอนุญาตให้ผู้ใช้แชร์ตำแหน่งกับสมาชิกในครอบครัวอย่างต่อเนื่อง
  • ภายในแอป IoT ฟีเจอร์หนึ่งจะอนุญาตให้ผู้ใช้กำหนดค่าอุปกรณ์ในบ้านให้ปิดเมื่อผู้ใช้ออกจากบ้านและเปิดอีกครั้งเมื่อผู้ใช้กลับถึงบ้าน

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

ใน Android 10 (API ระดับ 29) ขึ้นไป คุณต้องประกาศสิทธิ์ ACCESS_BACKGROUND_LOCATION ในไฟล์ Manifest ของแอปเพื่อขอสิทธิ์เข้าถึงตำแหน่งในเบื้องหลังขณะรันไทม์ ใน Android เวอร์ชันเก่า เมื่อแอปได้รับสิทธิ์เข้าถึงตำแหน่งเมื่อทำงานอยู่เบื้องหน้า ก็จะได้รับสิทธิ์เข้าถึงตำแหน่งเมื่อทำงานอยู่เบื้องหลังด้วยโดยอัตโนมัติ

<manifest ... >
  <!-- Required only when requesting background location access on
       Android 10 (API level 29) and higher. -->
  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
</manifest>

ความถูกต้อง

Android รองรับระดับความแม่นยำของตำแหน่งต่อไปนี้

โดยประมาณ
แสดงตำแหน่งอุปกรณ์โดยประมาณ หากค่าประมาณตำแหน่งนี้มาจาก LocationManagerService หรือ FusedLocationProvider, ค่าโดยประมาณนี้ถูกต้องภายในระยะประมาณ 3 ตารางกิโลเมตร (ประมาณ 1.2 ตารางกิโลเมตร ไมล์) แอปของคุณจะได้รับตําแหน่งที่ความแม่นยำระดับนี้เมื่อคุณ ประกาศสิทธิ์ ACCESS_COARSE_LOCATION แต่ไม่ประกาศสิทธิ์ ACCESS_FINE_LOCATION
แน่นอน
ให้การประมาณตำแหน่งของอุปกรณ์ที่แม่นยำที่สุด หากค่าประมาณตำแหน่งมาจาก LocationManagerService หรือ FusedLocationProvider โดยทั่วไปค่าประมาณนี้จะอยู่ภายในประมาณ 50 เมตร (160 ฟุต) และบางครั้งจะแม่นยำถึงภายในไม่กี่เมตร (10 ฟุต) หรือแม่นยำกว่านั้น แอปของคุณสามารถรับ ตำแหน่งที่มีความแม่นยำระดับนี้เมื่อคุณประกาศ ACCESS_FINE_LOCATION สิทธิ์

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

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

ขอสิทธิ์เข้าถึงตำแหน่งขณะรันไทม์

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

รูปที่ 1 แสดงตัวอย่างวิธีดำเนินการขั้นตอนนี้ แอปนี้ประกอบด้วย "แชร์ตำแหน่ง" ฟีเจอร์ที่ต้องเข้าถึงตำแหน่งในเบื้องหน้า แอป แต่จะไม่ขอสิทธิ์เข้าถึงตำแหน่ง จนกว่าผู้ใช้จะเลือก ปุ่มแชร์ตำแหน่ง

หลังจากที่ผู้ใช้เลือกปุ่ม &quot;แชร์ตำแหน่ง&quot; แล้ว กล่องโต้ตอบสิทธิ์เข้าถึงตำแหน่งของระบบจะปรากฏขึ้น
รูปที่ 1 ฟีเจอร์การแชร์ตำแหน่งที่ต้องใช้ การเข้าถึงตำแหน่งที่ทำงานอยู่เบื้องหน้า ฟีเจอร์จะเปิดใช้ก็ต่อเมื่อผู้ใช้เลือก อนุญาตขณะใช้แอปเท่านั้น

ผู้ใช้ให้สิทธิ์ได้เฉพาะตำแหน่งโดยประมาณ

ใน Android 12 (API ระดับ 31) ขึ้นไป ผู้ใช้จะขอให้แอปของคุณดึงข้อมูลตำแหน่งโดยประมาณเท่านั้นได้ แม้ว่าแอปจะขอสิทธิ์รันไทม์ ACCESS_FINE_LOCATION ก็ตาม

หากต้องการจัดการพฤติกรรมที่ผู้ใช้อาจทำเช่นนี้ อย่าขอสิทธิ์ ACCESS_FINE_LOCATION เพียงอย่างเดียว แต่ให้ขอACCESS_FINE_LOCATION และ ACCESS_COARSE_LOCATION สิทธิ์ในคำขอรันไทม์รายการเดียว หากคุณพยายามส่งคำขออย่างเดียว ACCESS_FINE_LOCATION ระบบจะไม่สนใจคำขอในรุ่นของ Android 12 หากแอปกำหนดเป้าหมายเป็น Android 12 ขึ้นไป ระบบจะบันทึกข้อความแสดงข้อผิดพลาดต่อไปนี้ใน Logcat

ACCESS_FINE_LOCATION must be requested with ACCESS_COARSE_LOCATION.

เมื่อแอปขอทั้ง ACCESS_FINE_LOCATION และ ACCESS_COARSE_LOCATION กล่องโต้ตอบสิทธิ์ของระบบจะมีตัวเลือกต่อไปนี้สำหรับผู้ใช้

  • แม่นยํา: อนุญาตให้แอปได้รับข้อมูลตำแหน่งที่แน่นอน
  • โดยประมาณ: อนุญาตให้แอปรับเฉพาะข้อมูลตำแหน่งโดยประมาณ

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

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

กล่องโต้ตอบจะอ้างอิงตำแหน่งโดยประมาณเท่านั้นและ มี 3 ปุ่ม โดยปุ่มหนึ่งอยู่เหนือปุ่มอีกปุ่มหนึ่ง
รูปที่ 2 กล่องโต้ตอบสิทธิ์ของระบบที่ปรากฏขึ้นเมื่อแอปของคุณขอ ACCESS_COARSE_LOCATION เท่านั้น
กล่องโต้ตอบมีตัวเลือก 2 ชุด โดยชุดหนึ่งอยู่เหนือกล่องโต้ตอบ
รูปที่ 3 กล่องโต้ตอบสิทธิ์ของระบบที่ปรากฏขึ้นเมื่อแอปของคุณขอทั้ง ACCESS_FINE_LOCATION และ ACCESS_COARSE_LOCATION ในคำขอรันไทม์เดียว

ตัวเลือกของผู้ใช้มีผลต่อการให้สิทธิ์

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

แน่นอน โดยประมาณ
ขณะใช้แอป ACCESS_FINE_LOCATION และ
ACCESS_COARSE_LOCATION		 ACCESS_COARSE_LOCATION
เฉพาะครั้งนี้ ACCESS_FINE_LOCATION และ
ACCESS_COARSE_LOCATION		 ACCESS_COARSE_LOCATION
ปฏิเสธ ไม่มีสิทธิ์เข้าถึงตำแหน่ง ไม่มีสิทธิ์เข้าถึงตำแหน่ง

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

Kotlin

val locationPermissionRequest = registerForActivityResult(
        ActivityResultContracts.RequestMultiplePermissions()
    ) { permissions ->
        when {
            permissions.getOrDefault(Manifest.permission.ACCESS_FINE_LOCATION, false) -> {
                // Precise location access granted.
            }
            permissions.getOrDefault(Manifest.permission.ACCESS_COARSE_LOCATION, false) -> {
                // Only approximate location access granted.
            } else -> {
                // No location access granted.
            }
        }
    }

// ...

// Before you perform the actual permission request, check whether your app
// already has the permissions, and whether your app needs to show a permission
// rationale dialog. For more details, see Request permissions.
locationPermissionRequest.launch(arrayOf(
    Manifest.permission.ACCESS_FINE_LOCATION,
    Manifest.permission.ACCESS_COARSE_LOCATION))

Java

ActivityResultLauncher<String[]> locationPermissionRequest =
    registerForActivityResult(new ActivityResultContracts
        .RequestMultiplePermissions(), result -> {
            Boolean fineLocationGranted = result.getOrDefault(
                    Manifest.permission.ACCESS_FINE_LOCATION, false);
            Boolean coarseLocationGranted = result.getOrDefault(
                    Manifest.permission.ACCESS_COARSE_LOCATION,false);
            if (fineLocationGranted != null && fineLocationGranted) {
                // Precise location access granted.
            } else if (coarseLocationGranted != null && coarseLocationGranted) {
                // Only approximate location access granted.
            } else {
                // No location access granted.
            }
        }
    );

// ...

// Before you perform the actual permission request, check whether your app
// already has the permissions, and whether your app needs to show a permission
// rationale dialog. For more details, see Request permissions.
locationPermissionRequest.launch(new String[] {
    Manifest.permission.ACCESS_FINE_LOCATION,
    Manifest.permission.ACCESS_COARSE_LOCATION
});

ขออัปเกรดเป็นตำแหน่งที่แน่นอน

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

หากต้องการขอให้ผู้ใช้อัปเกรดการเข้าถึงตำแหน่งของแอปจากแบบใกล้เคียงเป็นแบบแม่นยำ ให้ทำดังนี้

  1. หากจำเป็น ให้อธิบายว่าทำไมแอปของคุณจึงต้องใช้ สิทธิ์
  2. ขอสิทธิ์ ACCESS_FINE_LOCATION และ ACCESS_COARSE_LOCATION เนื่องจากผู้ใช้ได้อนุญาตให้ระบบมอบสิทธิ์เข้าถึงตำแหน่งโดยประมาณแก่แอปของคุณแล้ว กล่องโต้ตอบของระบบจึงแตกต่างออกไปในครั้งนี้ ดังที่แสดงในรูปที่ 4 และรูปที่ 5
กล่องโต้ตอบจะมีตัวเลือก &quot;เปลี่ยนเป็นตำแหน่งที่แน่นอน&quot; &quot;เฉพาะครั้งนี้&quot; และ &quot;ปฏิเสธ&quot;
รูปที่ 4 ก่อนหน้านี้ผู้ใช้เลือกโดยประมาณและขณะใช้แอป (ในกล่องโต้ตอบจากรูปที่ 3)
กล่องโต้ตอบจะมีตัวเลือก &quot;เฉพาะครั้งนี้&quot; และ &quot;ปฏิเสธ&quot;
รูปที่ 5 ก่อนหน้านี้ผู้ใช้ได้เลือกโดยประมาณและเฉพาะครั้งนี้ (ในกล่องโต้ตอบจากรูปที่ 3)

ขอเฉพาะตำแหน่งเบื้องหน้าในตอนแรก

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

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

ปุ่มที่เปิดใช้การเข้าถึงตำแหน่งในเบื้องหน้าคือ ระยะห่างครึ่งหนึ่งของหน้าจอจากปุ่มที่เปิดใช้พื้นหลัง สถานที่
รูปที่ 6 ฟีเจอร์ทั้ง 2 รายการต้องใช้สิทธิ์เข้าถึงตำแหน่ง แต่มีเพียงฟีเจอร์ "แนะนำสถานที่ใกล้เคียง" เท่านั้นที่ต้องใช้สิทธิ์เข้าถึงตำแหน่งในเบื้องหลัง

กระบวนการส่งคำขอเพิ่มมีดังนี้

  1. ในตอนแรก แอปควรแนะนำผู้ใช้ไปยังฟีเจอร์ที่ต้องเข้าถึงตำแหน่งในเบื้องหน้า เช่น ฟีเจอร์ "แชร์ตำแหน่ง" ในรูปที่ 1 หรือฟีเจอร์ "แสดงตำแหน่งปัจจุบัน" ในรูปที่ 2

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

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

ขอตำแหน่งในเบื้องหลังหากจำเป็น

รูปที่ 7 หน้าการตั้งค่ามีตัวเลือกที่ชื่อว่า อนุญาตตลอด ซึ่งจะระบุตำแหน่งในเบื้องหลัง สิทธิ์เข้าถึง

เนื้อหาของกล่องโต้ตอบสิทธิ์จะขึ้นอยู่กับเวอร์ชัน SDK เป้าหมาย

เมื่อฟีเจอร์ในแอปขอตำแหน่งในเบื้องหลังในอุปกรณ์ที่ทํางาน Android 10 (API ระดับ 29) กล่องโต้ตอบสิทธิ์ของระบบจะมีตัวเลือก ที่ชื่อว่าอนุญาตตลอด หากผู้ใช้เลือกตัวเลือกนี้ คุณลักษณะใน แอปของคุณจะได้รับสิทธิ์เข้าถึงตำแหน่งในเบื้องหลัง

อย่างไรก็ตาม ใน Android 11 (API ระดับ 30) ขึ้นไป กล่องโต้ตอบของระบบจะไม่มีตัวเลือกอนุญาตทุกครั้ง แต่ผู้ใช้ต้องเปิดใช้ตำแหน่งในเบื้องหลังในหน้าการตั้งค่าแทน ดังที่แสดงในรูปที่ 7

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

แอปกำหนดเป้าหมายเป็น Android 11 ขึ้นไป

หากแอปไม่ได้รับสิทธิ์ ACCESS_BACKGROUND_LOCATION และ shouldShowRequestPermissionRationale() แสดงผลเป็น true ให้แสดง UI ที่ให้ความรู้แก่ผู้ใช้ ซึ่งประกอบด้วยข้อมูลต่อไปนี้

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

แอปกำหนดเป้าหมายเป็น Android 10 หรือต่ำกว่า

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

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

ผู้ใช้ส่งผลต่อความแม่นยำของตำแหน่งในเบื้องหลังได้

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

การช่วยเตือนเกี่ยวกับการให้สิทธิ์เข้าถึงตำแหน่งในเบื้องหลัง

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

ตรวจสอบข้อกำหนดสถานที่ตั้งในทรัพยากร Dependency ของ SDK ของแอป

ตรวจสอบว่าแอปของคุณใช้ SDK ที่ขึ้นอยู่กับสิทธิ์เข้าถึงตำแหน่งหรือไม่ โดยเฉพาะสิทธิ์ ACCESS_FINE_LOCATION อ่านบทความนี้ใน Medium เกี่ยวกับการทำความรู้จักลักษณะการทำงานของ SDK ทรัพยากร Dependency

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

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับสิทธิ์เข้าถึงตำแหน่งใน Android โปรดดูข้อมูลต่อไปนี้ วัสดุ:

Codelab

วิดีโอ

ตัวอย่าง

ก่อนหน้า
About user location
ถัดไป
Get the last known location