NavigationView

class publik NavigationView memperluas RelativeLayout

Tampilan yang menampilkan peta untuk navigasi.

Pengguna class ini harus meneruskan semua metode siklus proses dari Activity atau Fragment yang berisi tampilan ini ke metode yang sesuai di class ini. Secara khusus, Anda harus meneruskan metode berikut:

Jika NavView ditambahkan setelah Activity atau Fragment induknya telah melalui siklus proses pembuatannya, Anda harus memanggil onCreate(Bundle), onStart(), dan onResume() secara manual untuk melakukan inisialisasi dengan benar. Demikian pula, jika NavView dilepas dari Activity atau Fragment induknya, Anda harus memanggil onPause(), onStop(), dan onDestroy() secara manual untuk mencegah kebocoran.

Catatan: Anda disarankan untuk tidak menambahkan anak-anak ke tampilan ini.

Semua panggilan ke NavView harus dilakukan di UI thread.

Ringkasan Class Bertingkat

antarmuka NavigationView.OnNightModeChangedListener Antarmuka untuk pemroses yang akan diberi tahu saat UI memasuki atau keluar dari "mode malam". 
antarmuka NavigationView.OnRecenterButtonClickedListener Antarmuka untuk pemroses yang akan diberi tahu saat tombol pusatkan diklik. 

Ringkasan Konstanta Turunan

Ringkasan Kolom Turunan

Ringkasan Konstruktor Publik

NavigationView(Konteks konteks)
NavigationView(Konteks konteks, atribut AttributeSet)
NavigationView(Konteks konteks, atribut AttributeSet, int defStyleAttr)

Ringkasan Metode Publik

Kamera
getCamera()
Menampilkan objek kamera yang dapat digunakan untuk mengubah area pandang peta.
NavigationMap
getMap()
Menampilkan objek yang dapat digunakan untuk menambahkan konten ke peta.
void
onConfigurationChanged(Konfigurasi konfigurasi)
void
onCreate(Paket savedInstanceState)
void
void
void
void
onSaveInstanceState(Bundle outState)
void
void
onStop()
void
onTrimMemory(level int)
void
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)
Mengganti mode tampilan default untuk info PWT selama navigasi.
void
setCalloutInfoFormatOverride(RouteCalloutInfoFormat calloutInfoFormatOverride)
Menetapkan mode format info info untuk info rute.
void
setCompassEnabled(boolean diaktifkan)
Menyetel apakah kompas terlihat.
void
setCustomControl(Kontrol tampilan, posisi CustomControlPosition)
Menyetel tampilan kontrol khusus yang akan muncul pada posisi yang diberikan di UI navigasi.
void
setEtaCardEnabled(boolean diaktifkan)
Menyetel apakah kartu PWT terlihat selama navigasi.
void
setForceNightMode(int nightMode)
Menetapkan ForceNightMode saat ini.
void
setHeaderEnabled(boolean diaktifkan)
Menyetel apakah header navigasi belokan demi belokan terlihat selama navigasi.
void
setOnNightModeChangedListener(pemroses NavigationView.OnNightModeChangedListener)
Menetapkan pemroses yang akan segera diberi tahu mengenai status "mode malam" saat ini dan setiap kali UI memasuki atau keluar dari "mode malam".
void
setOnRecenterButtonClickedListener(pemroses NavigationView.OnRecenterButtonClickedListener)
Menetapkan pemroses yang akan diberi tahu saat tombol pusatkan diklik.
void
setRecenterButtonEnabled(boolean diaktifkan)
Menetapkan apakah tombol tengah kembali akan ditampilkan.
void
setSpeedAlertOptions(SpeedAlertOptions speedAlertOptions)
Menetapkan SpeedAlertOptions untuk menyesuaikan nilai minimum pemicu untuk SpeedAlertSeverity.
void
setSpeedLimitIconEnabled(boolean diaktifkan)
Menentukan apakah ikon batas kecepatan ditampilkan.
void
setSpeedometerIconEnabled(boolean diaktifkan)
Menentukan apakah ikon speedometer ditampilkan.
void
setSpeedometerUiOptions(SpeedometerUiOptions speedometerUiOptions)
Menyetel konfigurasi UI speedometer SpeedometerUiOptions berdasarkan SpeedAlertSeverity.
void
setStylingOptions(StylingOptions styleOptions)
Menetapkan beberapa opsi gaya untuk UI navigasi.
void
setTrafficIncidentCardsEnabled(boolean diaktifkan)
Menetapkan apakah kartu insiden lalu lintas harus ditampilkan saat pengguna mengklik ikon insiden lalu lintas.
void
setTrafficPromptsEnabled(boolean diaktifkan)
Menetapkan apakah perintah traffic akan ditampilkan.

Ringkasan Metode Turunan

Konstruktor Publik

publik NavigationView (Konteks konteks)

Parameter
context

public NavigationView (Konteks konteks, atribut AttributeSet)

Parameter
context
attrs

public NavigationView (Konteks konteks, attrSet attrs, int defStyleAttr)

Parameter
context
attrs
defStyleAttr

Metode Publik

public Kamera getCamera ()

Menampilkan objek kamera yang dapat digunakan untuk mengubah area pandang peta. Metode ini hanya boleh dipanggil di UI thread.

Hasil
  • objek Camera yang terkait dengan tampilan ini

public NavigationMap getMap ()

Menampilkan objek yang dapat digunakan untuk menambahkan konten ke peta. Metode ini hanya boleh dipanggil di UI thread.

public void onConfigurationChanged (Konfigurasi konfigurasi)

Parameter
config

public void onCreate (Bundle savedInstanceState)

Parameter
savedInstanceState

public void onDestroy ()

publik void onPause ()

public void onResume ()

public void onSaveInstanceState (Bundle outState)

Parameter
outState

public void onStart ()

public void onStop ()

public void onTrimMemory (int level)

Parameter
yaitu tingkat klik

public void setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)

Mengganti mode tampilan default untuk info PWT selama navigasi. Meneruskan null akan mereset mode tampilan default.

Parameter
calloutInfoDisplayModeOverride mode tampilan baru yang diinginkan.

public void setCalloutInfoFormatOverride (RouteCalloutInfoFormat calloutInfoFormatOverride)

Menetapkan mode format info info untuk info rute. Jika metode ini tidak dipanggil, info akan mengikuti perilaku seperti yang ditetapkan oleh RouteCalloutInfoFormat.DEFAULT.

Parameter
calloutInfoFormatOverride format info baru yang diinginkan.

public void setCompassEnabled (boolean enabled)

Menyetel apakah kompas terlihat. Metode ini hanya boleh dipanggil di UI thread.

Parameter
diaktifkan

public void setCustomControl (View control, CustomControlPosition posisi)

Menyetel tampilan kontrol khusus yang akan muncul pada posisi yang diberikan di UI navigasi. Jika sudah ada kontrol kustom di posisi yang ditentukan, kontrol tersebut akan diganti. Memanggil metode ini dengan nilai kontrol null akan menghapus kontrol kustom di posisi yang diberikan. Jika kontrol telah ditambahkan di posisi yang berbeda atau sudah memiliki induk, kontrol tersebut akan diabaikan. Metode ini hanya boleh dipanggil di UI thread.

Parameter
kontrol tampilan yang akan diposisikan dalam UI navigasi
position menentukan tempat kontrol kustom akan ditempatkan di UI relatif terhadap kontrol bawaan.

public void setEtaCardEnabled (boolean enabled)

Menyetel apakah kartu PWT terlihat selama navigasi. Metode ini hanya boleh dipanggil di UI thread.

Parameter
diaktifkan

public void setForceNightMode (int nightMode)

Menetapkan ForceNightMode saat ini.

Parameter
nightMode

public void setHeaderEnabled (boolean enabled)

Menyetel apakah header navigasi belokan demi belokan terlihat selama navigasi. Metode ini hanya boleh dipanggil di UI thread.

Parameter
diaktifkan

public void setOnNightModeChangedListener (NavigationView.OnNightModeChangedListener)

Menetapkan pemroses yang akan segera diberi tahu mengenai status "mode malam" saat ini dan setiap kali UI memasuki atau keluar dari "mode malam". Metode ini hanya boleh dipanggil di UI thread.

Catatan: Untuk menghindari kebocoran memori, setOnNightModeChangedListener(null) harus dipanggil saat pemroses tidak lagi diperlukan.

Parameter
pemroses pemroses yang akan diberi tahu saat UI memasuki atau keluar dari mode malam

public void setOnRecenterButtonClickedListener (pemroses NavigationView.OnRecenterButtonClickedListener)

Menetapkan pemroses yang akan diberi tahu saat tombol pusatkan diklik. Metode ini hanya boleh dipanggil di UI thread.

Catatan: Untuk menghindari kebocoran memori, setOnRecenterButtonClickedListener(null) harus dipanggil saat pemroses tidak lagi diperlukan.

Parameter
pemroses pemroses yang akan diberi tahu saat tombol Recenter diklik

public void setRecenterButtonEnabled (boolean enabled)

Menetapkan apakah tombol tengah kembali akan ditampilkan. Metode ini hanya boleh dipanggil di UI thread.

Parameter
diaktifkan

public void setSpeedAlertOptions (SpeedAlertOptions speedAlertOptions)

Menetapkan SpeedAlertOptions untuk menyesuaikan nilai minimum pemicu untuk SpeedAlertSeverity.

Anda dapat menggunakan metode ini untuk menyesuaikan nilai minimum pemicu notifikasi kecepatan dalam persentase untuk notifikasi MINOR dan MAJOR. Anda juga dapat menggunakan metode ini untuk mengonfigurasi waktu dalam detik yang diperlukan untuk mengupgrade notifikasi kecepatan dari MINOR ke MAJOR.

Dengan menetapkan null SpeedAlertOptions atau tidak menyetel apa pun, notifikasi kecepatan default NavSDK akan menampilkan: notifikasi kecepatan menampilkan teks merah di latar belakang putih/gelap untuk mode siang/malam masing-masing saat kecepatan di bawah 5 mpj atau 10 kpj di atas batas kecepatan, dan menampilkan teks putih di latar belakang merah saat melaju dengan kecepatan lebih dari 5 mpj atau 10 kpj.

Parameter
speedAlertOptions

public void setSpeedLimitIconEnabled (boolean enabled)

Menentukan apakah ikon batas kecepatan ditampilkan. Hanya panggil metode ini di UI thread.

Jika diaktifkan, ikon batas kecepatan yang menunjukkan batas kecepatan jalan akan muncul di sudut awal bawah selama panduan. Ikon ini hanya muncul di lokasi yang menyediakan data batas kecepatan yang andal. Saat terlihat, ikon speedometer akan dipasang.

Jika tombol pusatkan kembali diaktifkan, ikon batas kecepatan akan disembunyikan untuk sementara saat tombol pusatkan kembali ditampilkan.

Catatan: Pengemudi harus mengikuti semua rambu yang terpasang di jalan, dan menggunakan ikon batas kecepatan hanya sebagai referensi. Keakuratan data batas kecepatan tidak dapat dijamin. Anda dapat melaporkan ketidakakuratan dalam data batas kecepatan kami dengan mengajukan kasus di Portal Dukungan Google Cloud.

Parameter
diaktifkan

public void setSpeedometerIconEnabled (boolean enabled)

Menentukan apakah ikon speedometer ditampilkan. Hanya panggil metode ini di UI thread.

Jika diaktifkan, ikon speedometer yang menunjukkan kecepatan kendaraan akan muncul di sudut awal bawah selama panduan. Saat ikon batas kecepatan terlihat, ikon tersebut akan dilampirkan, kemudian speedometer dapat memiliki warna teks dan latar belakang yang berbeda, bergantung pada tingkat keparahan kecepatannya.

Mengaktifkan ikon speedomter juga akan mengaktifkan ikon batas kecepatan, tetapi Anda dapat menggunakan setSpeedLimitIconEnabled(boolean) untuk menonaktifkan/mengaktifkan ikon batas kecepatan secara terpisah.

Jika tombol pusatkan diaktifkan, ikon speedometer akan disembunyikan untuk sementara saat tombol pusatkan kembali ditampilkan.

Parameter
diaktifkan

public void setSpeedometerUiOptions (SpeedometerUiOptions speedometerUiOptions)

Menyetel konfigurasi UI speedometer SpeedometerUiOptions berdasarkan SpeedAlertSeverity. Hanya panggil metode ini di UI thread.

Dengan menetapkan SpeedometerUiOptions null, Anda akan menghapus yang sebelumnya jika ditetapkan. Jika tidak ada SpeedometerUiOptions yang dikonfigurasi, UI speedometer akan beralih ke konfigurasi default NavSDK untuk pemberitahuan kecepatan SpeedAlertSeverity yang berbeda:

  • Peringatan kecepatan MINOR dalam mode siang: teks merah dengan latar belakang putih
  • Peringatan kecepatan MINOR dalam mode malam: teks merah di latar belakang gelap
  • Peringatan kecepatan MAJOR dalam mode siang: teks putih dengan latar belakang merah
  • Peringatan kecepatan MAJOR dalam mode malam: teks putih dengan latar belakang merah

Parameter
speedometerUiOptions

public void setStylingOptions (StylingOptions stylesOptions)

Menetapkan beberapa opsi gaya untuk UI navigasi. Metode ini hanya boleh dipanggil di UI thread.

Parameter
stylingOptions

public void setTrafficIncidentCardsEnabled (boolean enabled)

Menetapkan apakah kartu insiden lalu lintas harus ditampilkan saat pengguna mengklik ikon insiden lalu lintas. Metode ini hanya boleh dipanggil di UI thread.

Perhatikan bahwa saat navigasi terpandu berjalan, detail insiden lalu lintas akan ditampilkan dalam perintah. Untuk menonaktifkan detail insiden lalu lintas selama navigasi, setTrafficPromptsEnabled(boolean) harus digunakan.

Parameter
diaktifkan

public void setTrafficPromptsEnabled (boolean enabled)

Menetapkan apakah perintah traffic akan ditampilkan. Dialog traffic akan muncul secara berkala untuk memberikan informasi terbaru kepada pengguna terkait kondisi lalu lintas selama navigasi. Metode ini hanya boleh dipanggil di UI thread.

Parameter
diaktifkan