طلب رصد الموقع الجغرافي في الخلفية

تتناول هذه الصفحة ما يلي:

• كيفية طلب الوصول إلى بيانات الموقع الجغرافي في الخلفية
• كيفية معالجة الطلب استنادًا إلى إصدار حزمة تطوير البرامج (SDK) المستهدَف لتطبيقك
• كيف تؤثّر الإعدادات المفضّلة للمستخدمين في الموقع الجغرافي التقريبي في كيفية حصول تطبيقك على بيانات الموقع الجغرافي في الخلفية

ملاحظة: إذا كانت إحدى الميزات في تطبيقك تحصل على بيانات الموقع الجغرافي من الخلفية، تأكَّد من أنّ الوصول إلى البيانات ضروري. ننصحك بالحصول على المعلومات التي تحتاجها الميزة بطرق أخرى. لمزيد من المعلومات عن الوصول إلى الموقع الجغرافي في الخلفية، يُرجى الاطّلاع على صفحة الوصول إلى الموقع الجغرافي في الخلفية.

الشكل 7. تتضمّن صفحة الإعدادات خيارًا يُسمى السماح طوال الوقت، والذي يمنح إذنًا بالوصول إلى الموقع الجغرافي في الخلفية.

تعتمد محتويات مربّع حوار الأذونات على إصدار حزمة SDK المستهدف

عندما تطلب إحدى الميزات في تطبيقك الوصول إلى بيانات الموقع الجغرافي في الخلفية على جهاز يعمل بنظام Android 10 (المستوى 29 من واجهة برمجة التطبيقات)، يتضمّن مربّع حوار أذونات النظام خيارًا بعنوان السماح في كل الأوقات. إذا اختار المستخدم هذا الخيار، تحصل الميزة في تطبيقك على إذن الوصول إلى بيانات الموقع الجغرافي في الخلفية.

في نظام التشغيل Android 11 (المستوى 30 لواجهة برمجة التطبيقات) والإصدارات الأحدث، لا يحتوي مربّع حوار النظام على خيار السماح طوال الوقت. بدلاً من ذلك، على المستخدمين تفعيل ميزة "تحديد الموقع الجغرافي" في الخلفية من صفحة الإعدادات، كما هو موضّح في الشكل 7.

يمكنك مساعدة المستخدمين في الانتقال إلى صفحة الإعدادات هذه باتّباع أفضل الممارسات عند طلب إذن تحديد الموقع الجغرافي في الخلفية. تعتمد عملية منح الإذن على إصدار حزمة تطوير البرامج (SDK) المستهدَف لتطبيقك.

يستهدف التطبيق الإصدار 11 من نظام التشغيل Android أو إصدارًا أحدث

إذا لم يتم منح تطبيقك الإذن ACCESS_BACKGROUND_LOCATION، وshouldShowRequestPermissionRationale() عرض true، يجب عرض واجهة مستخدم تعليمية للمستخدمين تتضمّن ما يلي:

• شرح واضح لسبب حاجة ميزة تطبيقك إلى الوصول إلى الموقع الجغرافي في الخلفية
• التصنيف المرئي للمستخدم لخيار الإعدادات الذي يمنح إذن الوصول إلى الموقع الجغرافي في الخلفية (على سبيل المثال، السماح طوال الوقت في الشكل 7). يمكنك الاتصال بالرقم getBackgroundPermissionOptionLabel() للحصول على هذا التصنيف. يتمّ ترجمة قيمة العنصر الذي يتمّ إرجاعه من خلال هذه الطريقة لتتوافق مع اللغة المفضّلة على جهاز المستخدِم.
• خيار للمستخدمين لرفض الإذن إذا رفض المستخدمون منح إذن الوصول إلى الموقع الجغرافي في الخلفية، من المفترض أن يتمكنوا من مواصلة استخدام تطبيقك.

الشكل 8. إشعار لتذكير المستخدم بأنّه منح أحد التطبيقات إذنًا بالوصول إلى بيانات الموقع الجغرافي في الخلفية

يستهدف التطبيق الإصدار 10 من نظام التشغيل Android أو إصدارًا أقدم

عندما تطلب إحدى الميزات في تطبيقك الوصول إلى الموقع الجغرافي في الخلفية، يظهر للمستخدمين مربّع حوار النظام. يتضمّن مربّع الحوار هذا خيارًا للانتقال إلى موقع تطبيقك الجغرافي وخيارات الأذونات في صفحة الإعدادات.

ما دام تطبيقك يتّبع أفضل الممارسات لطلب أذونات تحديد الموقع الجغرافي، ليس عليك إجراء أي تغييرات للسماح بهذا السلوك.

يمكن للمستخدم التأثير في دقة تحديد الموقع الجغرافي في الخلفية

إذا طلب المستخدم الموقع الجغرافي التقريبي، تنطبق خيارات المستخدم في مربع حوار أذونات الموقع الجغرافي أيضًا على رصد الموقع الجغرافي في الخلفية. بعبارة أخرى، إذا منح المستخدم تطبيقك إذن ACCESS_BACKGROUND_LOCATION ولكنه منحه إذن الوصول إلى الموقع الجغرافي التقريبي فقط في المقدّمة، لن يحصل تطبيقك سوى على إذن الوصول إلى الموقع الجغرافي التقريبي في الخلفية أيضًا.

مصادر إضافية

لمزيد من المعلومات حول أذونات تحديد الموقع الجغرافي في Android، يمكنك الاطّلاع على المراجع التالية:

الدروس التطبيقية حول الترميز

• أفضل الممارسات المتعلقة بالخصوصية

الفيديوهات

• كيفية العثور على حالات استخدام محتمل للموقع الجغرافي في الخلفية

نماذج

• نموذج تطبيق لعرض استخدام أذونات تحديد الموقع الجغرافي