Automotive Location Bypass API

Fitur ini memungkinkan akses lokasi aplikasi bantuan bagi pengemudi yang diizinkan, yang dipaketkan dengan Android, dikontrol secara terpisah oleh tombol “Gunakan lokasi untuk bantuan bagi pengemudi”. Hal ini memungkinkan aplikasi tersebut mengakses lokasi meskipun tombol "Gunakan lokasi" dinonaktifkan.

  • Android 12 tidak menyediakan API publik untuk fitur ini. Aplikasi bantuan bagi pengemudi harus meminta pembaruan lokasi seperti biasa.
  • Android 13 dan yang lebih tinggi harus membuat permintaan lokasi untuk menggunakan LocationManager.requestLocationUpdates() dan meneruskan objek LocationRequest yang dikonfigurasi dengan LocationRequest.setAdasGnssBypass(true).

Menggunakan API bypass lokasi bantuan bagi pengemudi

Bagian berikut menjelaskan cara menggunakan API bypass lokasi bantuan bagi pengemudi. Untuk mempelajari lebih lanjut kebijakan penggunaan, lihat Kebijakan Daftar yang Diizinkan untuk Pengabaian Lokasi.

Memeriksa status tombol bantuan bagi pengemudi

Di Android 13 dan yang lebih tinggi, Anda dapat memeriksa status tombol bantuan bagi pengemudi sebelum meminta pembaruan lokasi.

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

Menjalankan perintah Android Debug Bridge (ADB)

Untuk pengembangan dan pengujian, Anda dapat dengan cepat memeriksa atau mengubah status tombol bantuan bagi pengemudi tanpa menggunakan Setelan Lokasi.

  1. Untuk menggunakan perintah ADB guna memeriksa atau mengubah status:
    // 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

Setel izin

Lihat referensi berikut untuk rilis Android khusus versi:

  1. Di Android 12, aplikasi bantuan bagi pengemudi harus memiliki izin WRITE_SECURE_SETTINGS.
  2. Di Android 13 dan yang lebih tinggi, izin LOCATION_BYPASS diperlukan.

Menambahkan aplikasi ke daftar yang diizinkan di perangkat Anda

Di direktori etc/sysconfig:

  1. Tambahkan nama paket aplikasi dalam file XML konfigurasi sistem:
  2. <!-- In a xml file under etc/sysconfig–>
    <config>
    …
    <allow-adas-location-settings package="PACKAGE-NAME" />
    …
    </config>

Untuk memastikan paket Anda muncul di UI Setelan Lokasi, tambahkan nama paket ke config_locationDriverAssistancePackageNames.

Tambahkan URL pengungkapan kebijakan privasi aplikasi ke AndroidManifest.xml. Nama metadata harus privacy_policy.

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

Menghapus "Gunakan lokasi untuk tombol bantuan bagi pengemudi"

Jika Anda tidak memiliki aplikasi bantuan bagi pengemudi yang didukung lokasi yang meminta lokasi dari Android, Anda dapat menjadikan blok kode sebagai komentar untuk menghapus tombol Setelan Lokasi.

  1. Buka packages/apps/Car/Settings/res/xml/location_settings_fragment.xml, lalu jadikan kode berikut sebagai komentar.
    <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. Setelah menghapus tombol, tetapkan config_defaultAdasGnssLocationEnabled ke false.

Menjalankan Automotive Test Suite

Google menyediakan pengujian Automotive Test Suite (ATS), yang memastikan bahwa semua paket bantuan bagi pengemudi di perangkat telah diizinkan oleh Google. Pengujian dikonfigurasi dari jarak jauh. Anda tidak perlu menunggu hingga rilis ATS berikutnya untuk menambahkan paket baru. Anda dapat mempelajari lebih lanjut di Complete Automotive Tests in a Box.