واجهة برمجة التطبيقات لتجاوز الموقع الجغرافي في Automotive

تسمح هذه الميزة بالوصول إلى الموقع الجغرافي لبرنامج التشغيل المُدرَج في القائمة المسموح بها والمضمّن في نظام التشغيل Android. مساعدة التطبيقات على التحكّم بشكل منفصل من خلال خيار "استخدام الموقع الجغرافي للسائق" مساعدة". يتيح ذلك لهذه التطبيقات الوصول إلى الموقع الجغرافي حتى عند ضبط الخيار "استخدام الموقع الجغرافي". في وضع الإيقاف.

• لا يوفّر Android 12 واجهة برمجة تطبيقات عامة لهذا الغرض. الجديدة. يجب أن تطلب تطبيقات "مساعدة السائق" إجراء تعديلات على الموقع الجغرافي كالمعتاد.
• يجب أن يطلب نظام Android 13 والإصدارات الأحدث طلب الموقع الجغرافي لاستخدام LocationManager.requestLocationUpdates() واجتياز تم ضبط الكائن LocationRequest باستخدام LocationRequest.setAdasGnssBypass(true)

استخدام واجهة برمجة التطبيقات الخاصة بتجاوز موقع "مساعدة السائق"

توضّح الأقسام التالية كيفية استخدام واجهة برمجة التطبيقات الخاصة بتجاوز موقع مساعدة السائق. للتعلّم مزيد من المعلومات حول سياسة الاستخدام، راجع سياسة القائمة المسموح بها لتجاوز الموقع الجغرافي

التحقُّق من حالة مفتاح مساعدة السائق

في نظام التشغيل Android 13 والإصدارات الأحدث، يمكنك الاطّلاع على حالة مفتاح تبديل مساعدة السائق. قبل طلب تحديثات الموقع.

// Returns the current status of "Use location for driver assistance".
locationManager.isAdasGnssLocationEnabled();

تشغيل أوامر Android Debug Bridge (ADB)

للتطوير والاختبار، يمكنك التحقق بسرعة من حالة مساعدة السائق أو تغييرها التبديل بدون استخدام إعدادات الموقع.

1. لاستخدام أوامر 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 الخاصة بإصدار معيّن:

1. في Android 12، يجب أن تتضمّن تطبيقات "مساعدة السائق" ما يلي: WRITE_SECURE_SETTINGS إذن.
2. في نظام التشغيل Android 13 والإصدارات الأحدث، يجب منح إذن LOCATION_BYPASS.

إضافة تطبيق إلى القائمة المسموح بها على جهازك

في الدليل etc/sysconfig:

1. أضِف اسم حزمة التطبيق في ملف 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، يمكنك التعليق على مجموعة الرموز لإزالة مفتاح التبديل إلى "إعدادات الموقع".

1. مفتوح packages/apps/Car/Settings/res/xml/location_settings_fragment.xml ثم للتعليق على التعليمات البرمجية التالية.

   <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/>

2. بعد إزالة مفتاح التبديل، اضبط config_defaultAdasGnssLocationEnabled على false

تشغيل مجموعة اختبار Automotive

توفّر Google اختبار مجموعة أدوات اختبار السيارات (ATS) لضمان تقديم جميع خدمات مساعدة السائق. تمت إضافة الحِزم المتوفّرة على أحد الأجهزة إلى القائمة المسموح بها لدى Google. يتم ضبط الاختبار عن بُعد. إِنْتَ ولا يحتاجون إلى الانتظار حتى إصدار ATS التالي لإضافة حزمة جديدة. يمكنك معرفة المزيد على إكمال اختبارات السيارات في صندوق: