تتيح هذه الميزة التحكّم بشكل منفصل في الوصول إلى الموقع الجغرافي لتطبيقات "مساعدة السائق" المُدرَجة في القائمة المسموح بها والمُضمّنة في نظام التشغيل Android، وذلك من خلال مفتاح التبديل "استخدام الموقع الجغرافي لتطبيقات "مساعدة السائق". ويؤدي ذلك إلى السماح لهذه التطبيقات بالوصول إلى الموقع الجغرافي حتى عندما يكون خيار "استخدام الموقع الجغرافي" متوقفًا.
- لا يقدّم نظام التشغيل Android 12 واجهة برمجة تطبيقات عامة لهذه الميزة. من المفترض أن تطلب تطبيقات مساعدة السائق تعديلات على الموقع الجغرافي كالمعتاد.
- يجب أن يقدّم نظام التشغيل Android 13 والإصدارات الأحدث طلبًا للحصول على الموقع الجغرافي
من أجل استخدام
LocationManager.requestLocationUpdates()وإدخالLocationRequestتم ضبطه باستخدامLocationRequest.setAdasGnssBypass(true).
استخدام واجهة برمجة التطبيقات لتجاوز الموقع الجغرافي في ميزات "مساعدة السائق"
توضّح الأقسام التالية كيفية استخدام واجهة برمجة التطبيقات لتجاوز الموقع الجغرافي لنظام مساعدة السائق. للاطّلاع على مزيد من المعلومات عن سياسة الاستخدام، يُرجى الاطّلاع على سياسة القائمة المسموح بها لتجاوز القيود الجغرافية.
التحقّق من حالة مفتاح مساعدة السائق
في الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث، يمكنك التحقّق من حالة مفتاح تفعيل ميزات مساعدة السائق قبل طلب تحديثات الموقع الجغرافي.
// Returns the current status of "Use location for driver assistance". locationManager.isAdasGnssLocationEnabled();
تنفيذ أوامر Android Debug Bridge (ADB)
لأغراض التطوير والاختبار، يمكنك التحقّق من حالة مفاتيح تفعيل/إيقاف ميزات مساعدة السائق أو تغييرها بسرعة بدون استخدام "إعدادات الموقع الجغرافي".
- لاستخدام أوامر ADB للتحقّق من الحالة أو تغييرها:
// Gets the status of ADAS location. adb shell cmd location is-adas-gnss-location-enabled // Enables ADAS location. adb shell cmd location set-adas-gnss-location-enabled true // Disables ADAS location. adb shell cmd location set-adas-gnss-location-enabled false
ضبط الإذن
يُرجى الاطّلاع على ما يلي لمعرفة إصدارات Android المحدّدة:
- في Android 12، يجب أن تحصل تطبيقات مساعدة السائق على إذن WRITE_SECURE_SETTINGS.
- في نظام التشغيل Android 13 والإصدارات الأحدث، يجب الحصول على إذن
LOCATION_BYPASS.
إضافة تطبيق إلى القائمة المسموح بها على جهازك
في دليل etc/sysconfig:
- أضِف اسم حزمة التطبيق في ملف XML لإعدادات النظام:
<!-- In a xml file under etc/sysconfig–> <config> … <allow-adas-location-settings package="PACKAGE-NAME" /> … </config>
لضمان ظهور حِزمك في واجهة مستخدم "إعدادات الموقع الجغرافي"، أضِف اسم حِزمك إلى ملف config_locationDriverAssistancePackageNames.
أضِف عنوان URL لبيان الإفصاح عن سياسة الخصوصية في التطبيق إلى AndroidManifest.xml. يجب أن يكون اسم
البيانات الوصفية هو privacy_policy.
<meta-data android:name="privacy_policy" android:value= privacy policy URL/>
إزالة مفتاح التبديل "استخدام الموقع الجغرافي لميزة "مساعدة السائق"
إذا لم يكن لديك تطبيق مساعدة سائق مستند إلى الموقع الجغرافي يطلب الموقع الجغرافي من Android، يمكنك تعليق مجموعة الرموز البرمجية لإزالة مفتاح التبديل لإعدادات الموقع الجغرافي.
- افتحملف
packages/apps/Car/Settings/res/xml/location_settings_fragment.xmlثم kommentierte الرمز البرمجي التالي.<com.android.car.ui.preference.CarUiTwoActionSwitchPreference android:fragment="com.android.car.settings.location.AdasLocationFragment" android:key="@string/pk_location_driver_assistance_state_switch" android:title="@string/location_driver_assistance_toggle_title" android:summary="@string/location_driver_assistance_toggle_summary" settings:controller="com.android.car.settings.location.AdasLocationSwitchPreferenceController" settings:searchable="true"/> <com.android.car.settings.common.DividerPreference/>
- بعد إزالة مفتاح التبديل، اضبط
config_defaultAdasGnssLocationEnabledعلىfalse.
تشغيل مجموعة أدوات اختبار السيارات
توفّر Google مجموعة اختبارات للسيارات (ATS)، ما يضمن أنّ جميع حِزم مساعدة السائق على الجهاز قد تم إدراجها في القائمة المسموح بها لدى Google. يتم ضبط الاختبار عن بُعد. ليس عليك انتظار إصدار ATS التالي لإضافة حزمة جديدة. يمكنك الاطّلاع على مزيد من المعلومات على الرابط Complete Automotive Tests in a Box (اختبارات السيارات الكاملة في علبة).