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 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.

Catatan: Ketersediaan fitur gangguan real-time dan jenis gangguan tertentu bervariasi menurut wilayah. Untuk mengetahui 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.
• Peringatan 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 atau selama navigasi aktif, gangguan saat ini akan muncul sebagai keterangan di sepanjang rute. Info penting menyertakan 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);

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 disetel ke false.

Menampilkan detail gangguan saat pengguna mengetuk balon

Pengguna dapat mengetuk info singkat untuk menampilkan kartu info dengan informasi selengkapnya tentang gangguan, termasuk jenis gangguan, waktu terakhir dilaporkan, dan dalam beberapa kasus, opsi untuk memilih apakah gangguan masih terjadi. Ada dua jenis kartu info berbeda yang dapat muncul, bergantung pada apakah pengguna sedang dalam navigasi aktif, dan opsi konfigurasi bervariasi untuk setiap jenis.

Kartu info balon teks pada ringkasan rute, sebelum memulai navigasi aktif

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

Anda dapat mengontrol kemampuan pengguna untuk mengetuk balon peringatan 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

Saat info gangguan muncul di sepanjang rute selama navigasi aktif, pengguna dapat mengetuk info gangguan tersebut untuk menampilkan kartu info dengan informasi selengkapnya tentang gangguan, termasuk jenis gangguan dan waktu terakhir kali dilaporkan, serta 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 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 peringatan 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 disetel ke false.

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

Catatan: Saat pengguna mendekati gangguan di sepanjang rute selama navigasi aktif, gangguan tersebut akan diumumkan dengan peringatan audio. Pemberitahuan 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 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.

Catatan: Jika Anda menerapkan tombol pelaporan kustom, pastikan untuk menyetel 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());
  

Bekerja dengan UI navigasi kustom

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

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

Penempatan tombol pelaporan

Secara default, tombol pelaporan gangguan diposisikan di ujung bawah/sudut belakang 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 setiap perintah yang ditampilkan oleh Navigation SDK disusun 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)