API Pengabaian Lokasi Automotive

Fitur ini memungkinkan akses lokasi pengemudi yang diizinkan, dipaketkan Android bantuan aplikasi untuk dikontrol secara terpisah oleh "Gunakan lokasi untuk pengemudi bantuan”. Hal ini memungkinkan aplikasi tersebut mengakses lokasi bahkan saat "Gunakan lokasi" tombolnya saat ini nonaktif.

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

Menggunakan API pengabaian lokasi bantuan bagi pengemudi

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

Memeriksa status tombol bantuan bagi pengemudi

Di Android 13 dan yang lebih baru, 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 bantuan bagi pengemudi beralih 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 bagian berikut untuk rilis Android khusus versi:

  1. Di Android 12, aplikasi bantuan bagi pengemudi harus memiliki TULIS_SECURE_SETELAN izin akses.
  2. Di Android 13 dan yang lebih baru, Izin LOCATION_BYPASS diperlukan.

Menambahkan aplikasi ke daftar yang diizinkan di perangkat

Dalam 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 Anda ke config_locationDriverAssistancePackageNames.

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

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

Hapus "tombol Gunakan lokasi untuk bantuan bagi pengemudi"

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

  1. Terbuka 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 rangkaian pengujian Automotive

Google menyediakan pengujian Automotive Test Suite (ATS), yang memastikan bahwa semua bantuan bagi pengemudi paket di perangkat telah diizinkan dengan Google. Pengujian ini dikonfigurasi dari jarak jauh. Anda tidak perlu menunggu sampai rilis ATS berikutnya untuk menambahkan paket baru. Pelajari selengkapnya di Selesaikan Pengujian Otomotif di Kotak.