Saat menggunakan template berikut, Anda dapat menambahkan dukungan bagi pengguna untuk berinteraksi dengan peta yang Anda gambar, seperti mengizinkan mereka melihat berbagai bagian peta dengan melakukan zoom dan menggeser.
| Template | Dukungan level Car App API |
|---|---|
NavigationTemplate |
2 |
(tidak digunakan lagi) |
4 |
(tidak digunakan lagi) |
4 |
(tidak digunakan lagi) |
5 (template diperkenalkan) |
MapWithContentTemplate |
7 (template diperkenalkan) |
Menerapkan callback interaktivitas
Antarmuka SurfaceCallback memiliki beberapa metode callback yang dapat Anda
terapkan untuk menambahkan interaktivitas ke peta yang dibuat dengan template di bagian
sebelumnya:
| Interaksi | Metode | Dukungan level Car App API |
|---|---|---|
| Ketuk | onClick |
5 |
| Cubit untuk zoom | onScale |
2 |
| Tarik dengan satu sentuhan | onScroll |
2 |
| Ayunkan jari dengan satu sentuhan | onFling |
2 |
| Ketuk dua kali |
(host template menentukan faktor skala) |
2 |
| Sentuhan putar dalam mode geser |
(host template menentukan faktor jarak) |
2 |
Menambahkan strip tindakan peta
Template ini dapat memiliki strip tindakan peta untuk tindakan terkait peta seperti memperbesar dan memperkecil, memusatkan kembali, menampilkan kompas, dan tindakan lain yang Anda pilih untuk ditampilkan. Strip tindakan peta dapat berisi hingga empat tombol khusus ikon yang dapat dimuat ulang tanpa memengaruhi kedalaman tugas. Strip tindakan disembunyikan saat dalam status tidak ada aktivitas dan muncul kembali dalam status aktif.
Untuk menerima callback interaktivitas peta, Anda harus menambahkan tombol Action.PAN
di strip tindakan peta. Saat pengguna menekan tombol Geser, host akan memasuki mode geser, seperti yang dijelaskan dalam Memahami mode geser.
Jika aplikasi Anda menghilangkan tombol Action.PAN di strip tindakan peta, aplikasi tidak akan
menerima input pengguna dari metode SurfaceCallback, dan host akan menutup mode geser
yang diaktifkan sebelumnya.
Di layar sentuh, tombol Geser tidak ditampilkan.
Memahami mode geser
Dalam mode geser, host template menerjemahkan input pengguna dari perangkat input non-sentuh,
seperti pengontrol putar dan touchpad, ke metode
SurfaceCallback yang sesuai. Tanggapi tindakan pengguna untuk masuk atau keluar dari mode geser
dengan metode setPanModeListener di NavigationTemplate.Builder.
Host dapat menyembunyikan komponen UI lainnya di template saat pengguna berada dalam mode
geser.