Memproses peristiwa navigasi

Aplikasi Anda dapat memproses peristiwa yang terjadi saat pengguna bernavigasi di 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 mendaftarkan callback saat perangkat mencapai tujuan.

Setelah tiba, Navigation SDK untuk Android 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 mendaftarkan callback saat lokasi atau arah perangkat berubah. Perhatikan bahwa lokasi ini dipaskan ke jalan, sehingga mungkin berbeda dengan lokasi yang ditampilkan oleh penyedia lokasi gabungan di API lokasi layanan Google Play.

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

Pembaruan lokasi yang ditangkap oleh jalan tidak bergantung pada navigasi, dan dapat berlanjut bahkan setelah navigasi berhenti. 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);
}

Terima info terbaru waktu dan jarak

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

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

Untuk menemukan waktu dan jarak yang tersisa, panggil Navigator.getTimeAndDistanceList(). Perhatikan bahwa waktu dan jarak dalam daftar bersifat kumulatif: keduanya menampilkan waktu dan jarak dari lokasi saat ini ke setiap titik jalan, bukan dari satu titik jalan ke titik jalan yang lain. Objek TimeAndDistance sekarang juga menampilkan delaySeverity. Enum ini akan bersifat berat, meduim, ringan, atau tidak diketahui. Hal ini berkaitan dengan warna yang Anda lihat di eta di UI peta (berat = merah, sedang = kuning, terang = hijau). Hal ini bermanfaat jika Anda perlu membuat {i>footer <i}eta{i> <i}Anda sendiri.

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

Contoh di bawah ini 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 menampilkan PWT untuk beberapa titik jalan menggunakan metode getTimeAndDistanceList().

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