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