Automotive Location Bypass API

Diese Funktion ermöglicht den Standortzugriff von Fahrern auf der Zulassungsliste Assistenz-Apps, die separat über die Option „Standort für Fahrer verwenden“ gesteuert werden Hilfe“ wechseln. Dadurch können diese Apps auch dann auf den Standort zugreifen, wenn die Option „Standort verwenden“ ausgeschaltet ist.

• Android 12 bietet dafür keine öffentliche API . Apps des Fahrassistenzsystems sollten wie gewohnt Standortaktualisierungen anfordern.
• Android 13 oder höher muss eine Standortanfrage senden um LocationManager.requestLocationUpdates() zu verwenden und eine LocationRequest-Objekt konfiguriert mit LocationRequest.setAdasGnssBypass(true)

Fahrassistenzsystem Location Bypass API verwenden

In den folgenden Abschnitten wird beschrieben, wie die Fahrassistenzsystem Location Bypass API verwendet wird. Weitere Informationen Weitere Informationen zur Nutzungsrichtlinie findest du unter Richtlinie zur Zulassungsliste der Standortumgehung:

Status des Fahrassistenzsystem-Schalters prüfen

Unter Android 13 und höher kannst du den Status des Schalters für das Fahrassistenzsystem prüfen bevor Sie Standortaktualisierungen anfordern.

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

Android Debug Bridge-Befehle (ADB) ausführen

Für Entwicklung und Tests kannst du den Status des Fahrassistenzsystems schnell prüfen oder ändern ohne die Standorteinstellungen zu wechseln.

1. So verwenden Sie ADB-Befehle, um den Status zu prüfen oder zu ändern:

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

Berechtigung festlegen

Im Folgenden finden Sie Informationen zu versionsspezifischen Android-Releases:

1. Unter Android 12 müssen Fahrassistenzsystem-Apps die SICHERHEIT_EINSTELLUNGEN_SCHREIBEN Berechtigung.
2. Unter Android 13 und höher Berechtigung „LOCATION_BYPASS“ ist erforderlich.

Apps auf dem Gerät der Zulassungsliste hinzufügen

Im Verzeichnis etc/sysconfig:

1. Fügen Sie den Paketnamen der App in eine Systemkonfigurationsdatei ein:

<!-- In a xml file under etc/sysconfig–>
<config>
…
<allow-adas-location-settings package="PACKAGE-NAME" />
…
</config>

Damit Ihr Paket in den Standorteinstellungen angezeigt wird, fügen Sie Ihren Paketnamen config_locationDriverAssistancePackageNames

Fügen Sie die URL der App zur Offenlegung der Datenschutzerklärung zu AndroidManifest.xml hinzu. Name der Metadaten muss privacy_policy sein.

<meta-data android:name="privacy_policy" android:value= privacy policy URL/>

Entfernen Sie die Option „Standort für Fahrassistenzsystem verwenden“.

Wenn Sie keine standortbasierte Fahrassistenzsystem-App haben, die den Standort von Android anfordert, können Sie den Codeblock auskommentieren, um den Schalter für die Standorteinstellungen zu entfernen.

1. Offen packages/apps/Car/Settings/res/xml/location_settings_fragment.xml und dann und kommentiere den folgenden Code aus.

   <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. Nachdem du den Schalter entfernt hast, setze config_defaultAdasGnssLocationEnabled auf false.

Automotive-Testsuite ausführen

Google bietet einen ATS-Test (Automotive Test Suite), mit dem sichergestellt wird, Pakete auf einem Gerät wurden von Google auf die Zulassungsliste gesetzt. Der Test ist remote konfiguriert. Ich Sie müssen nicht bis zum nächsten ATS-Release warten, um ein neues Paket hinzufügen zu können. Weitere Informationen erhalten Sie unter Führen Sie Autotests in der Verpackung durch.