تتناول هذه الصفحة ما يلي:
- كيفية طلب إذن الوصول إلى رصد الموقع الجغرافي في الخلفية
- كيفية التعامل مع الطلب استنادًا إلى إصدار حزمة تطوير البرامج (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، يُرجى الاطّلاع على المواد التالية:
اختبارات الرموز
الفيديوهات
نماذج
- نموذج تطبيق يوضّح كيفية استخدام أذونات الموقع الجغرافي.