ממשק API למעקף של מיקום כלי רכב

התכונה הזו מאפשרת גישה למיקום של נהגים שנמצאים ברשימת ההיתרים או בחבילה עם Android על אפליקציות עזרה שנשלטים בנפרד באמצעות האפשרות 'שימוש במיקום עבור הנהג' עזרה'. ההגדרה הזו מאפשרת לאפליקציות האלה לגשת למיקום גם כשהפעולה 'שימוש במיקום' המתג במצב כבוי.

• ב-Android 12 אין API ציבורי לתכונה הזו . אפליקציות עזרה לנהג צריכות לבקש עדכוני מיקום כרגיל.
• צריך לשלוח בקשת מיקום מ-Android מגרסה 13 ואילך כדי להשתמש ב-LocationManager.requestLocationUpdates() ולהעביר אובייקט LocationRequest הוגדר באמצעות LocationRequest.setAdasGnssBypass(true).

שימוש בממשק ה-API למעקף של מיקום העזרה לנהג

בקטעים הבאים מוסבר איך להשתמש בממשק ה-API של עקיפת מיקום עזרה לנהג. למידה מידע נוסף על מדיניות השימוש: מדיניות בנושא רשימת היתרים לעקיפת מיקום.

בודקים את הסטטוס של מתג העזרה לנהג

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

עליך להוסיף אל AndroidManifest.xml את כתובת ה-URL של האפליקציה לגילוי נאות במדיניות הפרטיות. השם של המטא-נתונים צריכים להיות 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 מספקת חבילת בדיקות של Automotive (ATS), שנועדה להבטיח שכל סיוע לנהג חבילות במכשיר נוספו לרשימת ההיתרים ב-Google. הבדיקה מוגדרת מרחוק. שלך לא צריכים לחכות עד למהדורת ATS הבאה כדי להוסיף חבילה חדשה. מידע נוסף זמין בכתובת השלמת בדיקות כלי רכב בקופסה.