Pilih platform: Android iOS

Mengonfigurasi gangguan real-time

Produk atau fitur ini ada dalam Pratinjau (pra-GA). Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Gangguan real-time adalah kumpulan fitur yang memberi tahu pengguna tentang gangguan sepanjang rute mereka dan memungkinkan pengguna melaporkan serta memverifikasi gangguan yang mereka alami. Contoh gangguan meliputi kecelakaan kendaraan, kemacetan lalu lintas, kehadiran polisi dan kamera pengukur kecepatan, konstruksi, penutupan jalur, dan kondisi cuaca tertentu. Halaman ini menjelaskan fitur gangguan real-time dan opsi konfigurasinya, termasuk pertimbangan untuk aplikasi yang menggunakan UI navigasi kustom.

Catatan: Ketersediaan fitur gangguan real-time dan jenis gangguan tertentu bervariasi menurut wilayah. Untuk informasi selengkapnya, lihat Cakupan negara dan wilayah Navigation SDK. Selain itu, gangguan real-time tidak tersedia di Android Auto.

Fitur gangguan real-time

Navigation SDK menyertakan fitur gangguan real-time berikut sebagai bagian dari pengalaman navigasi inti:

• Info gangguan interaktif di sepanjang rute.
• Notifikasi gangguan otomatis dengan pemungutan suara selama navigasi aktif.
• Pelaporan gangguan selama navigasi aktif.

Fitur ini dapat dikonfigurasi dan diaktifkan secara default. Bagian berikut memberikan informasi selengkapnya tentang fitur dan opsi konfigurasi yang tersedia.

Info gangguan interaktif di sepanjang rute

Saat aplikasi menampilkan rute, baik dalam ringkasan rute maupun selama navigasi aktif, gangguan saat ini akan muncul sebagai info di sepanjang rute. Info menyertakan ikon yang menunjukkan jenis gangguan.

Anda dapat mengontrol tampilan info gangguan di sepanjang rute menggunakan setTrafficPromptsEnabled, yang juga mengontrol tampilan notifikasi otomatis saat pengguna mendekati gangguan.

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

Catatan: setTrafficPromptsEnabled hanya mengontrol tampilan info untuk gangguan yang dilaporkan pengguna. Beberapa jenis gangguan, seperti penutupan jalan dari otoritas lalu lintas, mungkin masih terlihat meskipun setTrafficPromptsEnabled ditetapkan ke false.

Menampilkan detail gangguan saat pengguna mengetuk info

Pengguna dapat mengetuk info untuk menampilkan kartu info dengan informasi selengkapnya tentang gangguan, termasuk jenis gangguan, waktu terakhir kali dilaporkan, dan dalam beberapa kasus, opsi untuk memberikan suara apakah gangguan masih ada. Ada dua jenis kartu info yang dapat muncul, bergantung pada apakah pengguna berada dalam navigasi aktif, dan opsi konfigurasi bervariasi untuk setiap jenis.

Kartu info info di ringkasan rute, sebelum memulai navigasi aktif

Saat pengguna mengetuk info pada ringkasan rute, sebelum memulai navigasi aktif, kartu info akan muncul dengan informasi selengkapnya tentang gangguan.

Anda dapat mengontrol kemampuan pengguna untuk mengetuk info gangguan pada ringkasan rute untuk menampilkan informasi selengkapnya menggunakan setTrafficIncidentCardsEnabled .

// Using the SupportNavigationFragment
mNavFragment.setTrafficIncidentCardsEnabled(true);

// Using the NavigationView
navigationView.setTrafficIncidentCardsEnabled(true);

Kartu info info selama navigasi aktif

Saat info gangguan muncul di sepanjang rute selama navigasi aktif, pengguna dapat mengetuk info untuk menampilkan kartu info dengan informasi selengkapnya tentang gangguan, termasuk jenis gangguan dan waktu terakhir kali dilaporkan, serta tombol untuk memberikan suara apakah gangguan masih ada. Suara yang dikirimkan oleh pengguna diproses oleh Google dan dapat ditampilkan di peta untuk pengguna Google Maps dan pengguna Navigation SDK lainnya, serta digunakan untuk menentukan apakah akan terus menampilkan gangguan.

Anda dapat mengontrol tampilan dan kemampuan ketuk info gangguan selama navigasi aktif menggunakan setTrafficPromptsEnabled , yang juga mengontrol tampilan info di sepanjang rute dan tampilan pemberitahuan otomatis saat pengguna mendekati gangguan.

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

Catatan: setTrafficPromptsEnabled hanya mengontrol tampilan info untuk gangguan yang dilaporkan pengguna. Beberapa jenis gangguan, seperti penutupan jalan dari otoritas lalu lintas, mungkin masih terlihat meskipun setTrafficPromptsEnabled ditetapkan ke false.

Notifikasi gangguan otomatis dengan pemungutan suara selama navigasi aktif

Selama navigasi aktif, saat pengguna mendekati gangguan di sepanjang rute, perintah akan muncul dengan informasi tentang gangguan dan tombol untuk memberikan suara apakah gangguan masih ada. Suara yang dikirimkan oleh pengguna diproses oleh Google dan dapat ditampilkan di peta untuk pengguna Google Maps dan Navigation SDK lainnya, serta digunakan untuk menentukan apakah akan terus menampilkan gangguan.

Anda dapat mengonfigurasi tampilan perintah pemberitahuan selama navigasi aktif menggunakan setTrafficPromptsEnabled , yang juga mengontrol tampilan info di sepanjang rute.

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

Catatan: Saat pengguna mendekati gangguan di sepanjang rute selama navigasi aktif, gangguan tersebut akan diumumkan dengan pemberitahuan audio. Notifikasi audio tidak terpengaruh oleh konfigurasi tampilan perintah. Namun, Anda dapat mengonfigurasi semua perintah suara selama navigasi aktif menggunakan AudioGuidance .

Pelaporan gangguan selama navigasi aktif

Selama mode navigasi aktif, tombol akan muncul di UI navigasi yang memungkinkan pengguna melaporkan gangguan baru di sepanjang rute mereka. Saat pengguna mengetuk tombol, menu dengan jenis gangguan yang tersedia untuk dilaporkan akan muncul. Laporan yang dikirimkan pengguna diproses oleh Google dan dapat ditampilkan di peta untuk pengguna Google Maps dan Navigation SDK lainnya.

Catatan: Saat pengguna pertama kali memulai navigasi aktif, tombol pelaporan akan muncul dalam status yang diperluas dengan label "Laporkan". Tombol kemudian diciutkan untuk hanya menampilkan ikon.

Menampilkan atau menyembunyikan tombol pelaporan standar

Anda dapat mengonfigurasi visibilitas tombol pelaporan standar selama navigasi aktif menggunakan setReportIncidentButtonEnabled .

// Enables the incident reporting button to show in situations where incident
// reporting is possible.

// Using the SupportNavigationFragment
mNavFragment.setReportIncidentButtonEnabled(true);

// Using the NavigationView
navigationView.setReportIncidentButtonEnabled(true);

Menambahkan tombol pelaporan kustom

Sebagai ganti tombol pelaporan gangguan standar, Anda dapat menambahkan tombol pelaporan kustom ke UI navigasi. Saat pengguna mengklik tombol kustom, Anda dapat memicu tampilan menu pelaporan dengan memanggil metode showReportIncidentsPanel. Sebelum menambahkan tombol pelaporan kustom, pastikan aplikasi berada dalam navigasi aktif dan pengguna berada di negara tempat pelaporan diaktifkan dengan memanggil isIncidentReportingAvailable. Jika salah satu hal ini tidak benar, menu pelaporan tidak akan muncul.

Catatan: Jika Anda menerapkan tombol pelaporan kustom, pastikan untuk menetapkan setReportIncidentButtonEnabled ke false guna menyembunyikan tombol pelaporan standar.

Button customReportIncidentButton = findViewById(R.id.custom_reporting_button);

// Check if reporting is available before displaying your button
customReportIncidentButton.setVisibility(
    navigationView.isReportingAvailable ? View.VISIBLE : View.GONE);

// Trigger the reporting flow if the button is clicked
customReportIncidentButton.setOnClickListener(v ->
    navigationView.showReportIncidentsPanel());

Menggunakan UI navigasi kustom

Jika penerapan Navigation SDK Anda menyertakan elemen UI kustom, Anda perlu mempertimbangkan elemen gangguan real-time untuk menghindari konflik.

Catatan: Untuk informasi selengkapnya tentang cara menggunakan elemen UI kustom, lihat Mengubah UI navigasi.

Pemosisi tombol pelaporan

Secara default, tombol pelaporan gangguan diposisikan di ujung bawah/sudut akhir peta—di sisi kanan untuk bahasa kiri ke kanan dan sisi kiri untuk bahasa kanan ke kiri. Jika Anda perlu memindahkan tombol pelaporan untuk memberi ruang bagi elemen UI kustom, tambahkan kontrol kustom BOTTOM_END_BELOW atau FOOTER, yang akan mendorong posisi tombol ke atas di layar. Menempatkan UI kustom Anda sendiri dalam kontrol kustom juga memastikan bahwa perintah apa pun yang ditampilkan oleh Navigation SDK dilapisi dengan benar di atas elemen UI kustom Anda saat ditampilkan. Jika Anda tidak dapat menggunakan kontrol kustom, gunakan Prompt Visibility API untuk mengelola potensi konflik UI.

Catatan: Kontrol kustom FOOTER hanya memengaruhi posisi tombol pelaporan dalam orientasi potret.

Prompt Visibility API (Eksperimental)

Prompt Visibility API membantu Anda menghindari konflik antara elemen UI yang dihasilkan oleh Navigation SDK dan elemen UI kustom Anda sendiri dengan menambahkan pemroses untuk menerima callback sebelum elemen UI Navigation SDK akan muncul dan segera setelah elemen dihapus. Anda dapat menerima callback untuk elemen gangguan real-time, termasuk kartu info, perintah, dan menu pelaporan gangguan—serta untuk notifikasi lain yang dihasilkan oleh Navigation SDK.

// Sample listener
val listener: PromptVisibilityChangedListener = { isVisible ->
	if (isVisible) {
		customFab.visibility = false
		customFooter.visibility = false
		moveSomeOtherThingsAround()
	} else {
		customFab.visibility = true
		customFooter.visibility = true
		moveSomeThingsBackToWhereTheyWereBefore()
	}
}

// Inside onCreate()
navigationView.addPromptVisibilityChangedListener(listener)

// Inside onDestroy()
navigationView.removePromptVisibilityChangedListener(listener)