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

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

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

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

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

الفيديوهات

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

نماذج

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