Memproses peristiwa navigasi

Aplikasi Anda dapat memproses peristiwa yang terjadi saat pengguna menavigasi sepanjang rute.

Ringkasan

Gunakan antarmuka berikut untuk memproses peristiwa navigasi:

Melihat kode

Mendeteksi kedatangan di tujuan

Di sini, tujuan mengacu pada tujuan akhir atau titik jalan. Untuk mendeteksi kedatangan, panggil Navigator.addArrivalListener(), yang mendaftar untuk callback saat perangkat mencapai tujuan.

Setelah tiba, Navigation SDK for Android akan mengaktifkan callback onArrival() dan menghentikan panduan belokan demi belokan. Anda harus memanggil Navigator.continueToNextDestination() secara eksplisit untuk melanjutkan ke titik jalan berikutnya, dan Navigator.startGuidance() untuk melanjutkan navigasi belokan demi belokan.

Saat Anda memanggil continueToNextDestination(), navigator akan menghapus semua informasi tentang tujuan sebelumnya. Jika ingin menganalisis informasi tentang segmen rute sebelumnya, Anda harus mengambil informasi dari navigator sebelum memanggil continueToNextDestination().

Untuk menghindari kebocoran memori, Anda harus memanggil removeArrivalListener(listener) saat tidak lagi memerlukan pemroses.

mNavigator.addArrivalListener(new Navigator.ArrivalListener() {
    @Override
    public void onArrival(ArrivalEvent arrivalEvent) {
        displayMessage("onArrival: You've arrived at a waypoint: "
                +   mNavigator.getCurrentRouteSegment().getDestinationWaypoint().getTitle(),
                DISPLAY_BOTH);
        // Start turn-by-turn guidance for the next leg of the route.
        if (arrivalEvent.isFinalDestination()) {
            displayMessage("onArrival: You've arrived at the final destination.",
                    DISPLAY_BOTH);
        } else {
            mNavigator.continueToNextDestination();
            mNavigator.startGuidance();
        }
    }
});

Menerima pembaruan lokasi

Dapatkan RoadSnappedLocationProvider dari NavigationApi, lalu panggil RoadSnappedLocationProvider.addLocationListener() untuk mendaftar ke callback saat lokasi atau arah perangkat berubah. Perhatikan bahwa lokasi ini disambungkan ke jalan, sehingga mungkin berbeda dengan lokasi yang ditampilkan oleh penyedia lokasi gabungan di Location API layanan Google Play.

Navigation SDK memberikan update lokasi sesering mungkin. Saat update lokasi tersedia, Navigation SDK akan mengaktifkan callback onLocationChanged().

Pembaruan lokasi yang diambil dari jalan tidak bergantung pada navigasi, dan dapat dilanjutkan bahkan setelah navigasi dihentikan. Berlangganan pembaruan lokasi dapat menyebabkan pengurasan baterai, kebocoran memori, atau pengumpulan data lokasi perangkat yang tidak disengaja jika Anda membiarkan pembaruan lokasi berjalan di latar belakang. Panggil RoadSnappedLocationProvider.removeLocationListener saat Anda tidak lagi memerlukan pemroses.

mRoadSnappedLocationProvider =
        NavigationApi.getRoadSnappedLocationProvider(getApplication());
if (mRoadSnappedLocationProvider != null) {
    mRoadSnappedLocationProvider.addLocationListener(
            new RoadSnappedLocationProvider.LocationListener() {
                @Override
                public void onLocationChanged(Location location) {
                    displayMessage("onLocationUpdated: Navigation engine has provided a new"
                                    +   " road-snapped location: "
                                    +   location.toString(),
                            DISPLAY_LOG);
                }
            });
} else {
    displayMessage("ERROR: Failed to get a location provider", DISPLAY_LOG);
}

Menerima pembaruan waktu dan jarak

Panggil Navigator.addRemainingTimeOrDistanceChangedListener() untuk mendaftar ke callback saat waktu tersisa (detik) atau jarak (meter) berubah lebih dari nilai minimum yang ditentukan.

Jika perubahan waktu atau jarak melebihi jumlah yang ditentukan, Navigation SDK akan memicu callback onRemainingTimeOrDistanceChanged().

Untuk menemukan waktu dan jarak yang tersisa, panggil Navigator.getTimeAndDistanceList(). Perhatikan bahwa waktu dan jarak dalam daftar bersifat kumulatif: waktu dan jarak tersebut menunjukkan waktu dan jarak dari lokasi saat ini ke setiap titik jalan, bukan dari satu titik jalan ke titik jalan lainnya. Objek TimeAndDistance kini juga menampilkan delaySeverity. Enum ini akan berat, sedang, ringan, atau tidak diketahui. Ini sesuai dengan warna yang Anda lihat di eta di UI peta (berat = merah, sedang = kuning, terang = hijau). Hal ini berguna jika Anda perlu membuat footer estimasi waktu tiba Anda sendiri.

Untuk menghindari kebocoran memori, Anda harus memanggil Navigator.removeRemainingTimeOrDistanceChangedListener(listener) saat tidak lagi memerlukan pemroses.

Contoh di bawah meminta callback jika waktu yang tersisa berubah lebih dari 60 detik atau jarak yang tersisa berubah lebih dari 100 meter.

mNavigator.addRemainingTimeOrDistanceChangedListener(60, 100,
        new Navigator.RemainingTimeOrDistanceChangedListener() {
            @Override
            public void onRemainingTimeOrDistanceChanged() {
                displayMessage("onRemainingTimeOrDistanceChanged: Time or distance estimate"
                        +   " has changed.",
                        DISPLAY_LOG);
            }
        });

Anda dapat menampilkan informasi waktu dan jarak yang tersisa menggunakan layar bawaan menggunakan metode setEtaCardEnabled() dan meneruskan parameter dengan nilai TRUE. Untuk menyembunyikan tampilan waktu dan jarak, tetapkan nilai ini ke FALSE.

Anda juga dapat mengekspos perkiraan waktu tiba untuk beberapa titik jalan menggunakan metode getTimeAndDistanceList().

Mendapatkan info terbaru rute

Panggil Navigator.addRouteChangedListener() untuk mendaftarkan callback saat rute berubah.

Saat rute berubah, Navigation SDK akan mengaktifkan callback onRouteChanged(). Anda dapat memanggil Navigator.getRouteSegments dan Navigator.getCurrentRouteSegment() untuk menemukan rute baru.

Untuk menghindari kebocoran memori, Anda harus memanggil removeRouteChangedListener(listener) saat tidak lagi memerlukan pemroses.

mNavigator.addRouteChangedListener(new Navigator.RouteChangedListener() {
    @Override
    public void onRouteChanged() {
        displayMessage("onRouteChanged: The driver's route has changed. Current waypoint: "
                +   mNavigator.getCurrentRouteSegment().getDestinationWaypoint().getTitle(),
                DISPLAY_LOG);
    }
});

Mendeteksi saat mode malam berubah

Panggil NavigationView.addOnNightModeChangedListener atau SupportNavigationFragment.addOnNightModeChangedListener untuk mendaftar ke callback saat mode malam berubah.

Contoh berikut menunjukkan pemrosesan perubahan mode malam di fragmen navigasi.

mNavFragment.addOnNightModeChangedListener(new NavigationView.OnNightModeChangedListener() {
    @Override
    public void onNightModeChanged(NightModeChangedEvent nightModeChangedEvent) {
        displayMessage("Night mode is active: " + nightModeChangedEvent.inNightMode(),
        DISPLAY_LOG);
    }
});

Anda juga dapat menyetel mode malam secara terprogram. Untuk mengetahui informasi selengkapnya, lihat Menetapkan mode malam.