تتناول هذه الصفحة ما يلي:
- كيفية طلب إذن رصد الموقع الجغرافي في الخلفية
- كيفية التعامل مع الطلب استنادًا إلى إصدار حزمة تطوير البرامج (SDK) المستهدَف لتطبيقك
- تأثير إعدادات المستخدم المفضّلة للموقع الجغرافي التقريبي في طريقة حصول تطبيقك على بيانات الموقع الجغرافي في الخلفية
تعتمد محتويات مربّع حوار الأذونات على إصدار حزمة تطوير البرامج (SDK) المستهدَفة
عندما تطلب إحدى الميزات في تطبيقك الحصول على إذن الوصول إلى رصد الموقع الجغرافي في الخلفية على جهاز يعمل بنظام التشغيل Android 10 (مستوى واجهة برمجة التطبيقات 29)، سيتضمّن مربّع حوار أذونات النظام خيارًا باسم السماح في جميع الأوقات. إذا اختار المستخدم هذا الخيار، ستحصل الميزة في تطبيقك على إذن الوصول إلى رصد الموقع الجغرافي في الخلفية.
في نظام التشغيل Android 11 (المستوى 30 لواجهة برمجة التطبيقات) والإصدارات الأحدث، لا يتضمّن مربّع حوار النظام خيار السماح طوال الوقت. بدلاً من ذلك، على المستخدمين تفعيل إذن الوصول إلى بيانات الموقع الجغرافي في الخلفية من خلال صفحة الإعدادات، كما هو موضّح في الشكل 7.
يمكنك مساعدة المستخدمين في الانتقال إلى صفحة الإعدادات هذه باتّباع أفضل الممارسات عند طلب إذن الوصول إلى بيانات الموقع الجغرافي في الخلفية. تعتمد عملية منح الإذن على إصدار حزمة تطوير البرامج (SDK) المستهدَف لتطبيقك.
يستهدف التطبيق الإصدار 11 من نظام التشغيل Android أو الإصدارات الأحدث
إذا لم يتم منح تطبيقك الإذن ACCESS_BACKGROUND_LOCATION، وكان
shouldShowRequestPermissionRationale() يعرض القيمة true، اعرض واجهة مستخدم تعليمية للمستخدمين تتضمّن ما يلي:
- توضيح واضح لسبب حاجة ميزة تطبيقك إلى الوصول إلى بيانات الموقع الجغرافي في الخلفية
- التصنيف الظاهر للمستخدم لخيار الإعدادات الذي يمنح إذن الوصول إلى الموقع الجغرافي في الخلفية (على سبيل المثال، السماح طوال الوقت في الشكل 7). يمكنك الاتصال بالرقم
getBackgroundPermissionOptionLabel()للحصول على هذا التصنيف. يتم تعديل قيمة العرض لهذه الطريقة لتناسب اللغة المفضّلة على جهاز المستخدم. - خيار للمستخدمين لرفض الإذن إذا رفض المستخدمون منح إذن الوصول إلى بيانات الموقع الجغرافي في الخلفية، يجب أن يتمكّنوا من مواصلة استخدام تطبيقك.
يستهدف التطبيق الإصدار 10 من نظام التشغيل Android أو الإصدارات الأقدم
عندما تطلب إحدى الميزات في تطبيقك إذن الوصول إلى رصد الموقع الجغرافي في الخلفية، يظهر للمستخدمين مربّع حوار في نظام التشغيل. يتضمّن مربّع الحوار هذا خيارًا للانتقال إلى خيارات أذونات تحديد الموقع الجغرافي لتطبيقك في صفحة الإعدادات.
طالما أنّ تطبيقك يتّبع أفضل الممارسات لطلب أذونات تحديد الموقع الجغرافي، لن تحتاج إلى إجراء أي تغييرات لدعم هذا السلوك.
يمكن للمستخدم التأثير في دقة رصد الموقع الجغرافي في الخلفية
إذا طلب المستخدم تحديد الموقع الجغرافي التقريبي، تنطبق أيضًا خيارات المستخدم في مربّع حوار أذونات تحديد الموقع الجغرافي على رصد الموقع الجغرافي في الخلفية. بعبارة أخرى، إذا منح المستخدم تطبيقك إذن ACCESS_BACKGROUND_LOCATION ولكنّه منح إذن الوصول إلى الموقع الجغرافي التقريبي فقط في المقدّمة، سيحصل تطبيقك على إذن الوصول إلى الموقع الجغرافي التقريبي في الخلفية أيضًا.
مراجع إضافية
لمزيد من المعلومات حول أذونات تحديد الموقع الجغرافي في Android، يمكنك الاطّلاع على المواد التالية:
اختبارات الرموز
الفيديوهات
نماذج
- نموذج تطبيق لتوضيح كيفية استخدام أذونات تحديد الموقع الجغرافي