Mengonfigurasi gangguan real-time

Gangguan real-time adalah kumpulan fitur yang memberi tahu pengguna tentang gangguan di sepanjang rute mereka dan memungkinkan pengguna melaporkan dan 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.

Fitur gangguan real-time

• Pemberitahuan gangguan interaktif di sepanjang rute.
• Pemberitahuan 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.

Pemberitahuan gangguan interaktif di sepanjang rute

Saat aplikasi menampilkan rute, baik dalam ringkasan rute maupun selama navigasi aktif, gangguan saat ini akan muncul sebagai balon di sepanjang rute. Saat Anda mengaktifkan lapisan lalu lintas, gangguan di luar rute juga akan muncul di peta. Info penting mencakup ikon yang menunjukkan jenis gangguan.

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

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

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

Menampilkan detail gangguan saat pengguna mengetuk balon

Mengetuk info gangguan akan membuka kartu info dengan detail selengkapnya. Hal ini berlaku untuk info rute dan info di luar rute, meskipun info di luar rute hanya muncul jika lapisan lalu lintas diaktifkan. Kartu ini menampilkan jenis gangguan, waktu terakhir dilaporkan, dan terkadang opsi untuk memberikan suara apakah gangguan masih terjadi. Jenis kartu info dan opsi konfigurasinya bervariasi, bergantung pada apakah pengguna berada dalam navigasi aktif.

Kartu info balon pada ringkasan rute, sebelum memulai navigasi aktif

Sebelum memulai navigasi aktif, pengguna dapat mengetuk balon di rute atau di luar rute pada peta atau ringkasan rute untuk membuka kartu info. Pesan di luar rute memerlukan lapisan lalu lintas diaktifkan. Kartu info memberikan detail selengkapnya tentang gangguan tersebut.

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 balon teks selama navigasi aktif

Selama navigasi aktif, pengguna dapat mengetuk balon gangguan di rute atau di luar rute untuk membuka kartu info. Kartu ini menampilkan jenis gangguan dan waktu terakhir dilaporkan, serta menyertakan tombol bagi pengguna untuk memilih apakah gangguan masih ada.

Pemungutan suara tersedia untuk gangguan di rute dan di luar rute dalam jarak 5 km dari pengguna, tidak termasuk penutupan jalan. Google memproses suara ini untuk membantu menentukan apakah akan terus menampilkan gangguan atau tidak. Suara juga dapat muncul di peta untuk pengguna Google Maps dan Navigation SDK lainnya.

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

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

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

Pemberitahuan 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 tersebut 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 gangguan akan terus ditampilkan.

Anda dapat mengonfigurasi tampilan dialog 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);

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.

Melaporkan penutupan jalan dapat menampilkan rute alternatif untuk melewati segmen yang diblokir, sehingga meminta pengguna untuk mengonfirmasi atau menolak pengalihan rute. Fitur ini tunduk pada ketersediaan.

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 pengganti 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, verifikasi bahwa aplikasi berada dalam navigasi aktif dan pengguna berada di negara tempat pelaporan diaktifkan dengan memanggil isIncidentReportingAvailable. Jika salah satunya tidak benar, menu pelaporan tidak akan muncul.

  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());
  

Bekerja dengan UI navigasi kustom

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

Penempatan tombol pelaporan

Prompt Visibility API (Eksperimental)

// 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)