Nghe sự kiện điều hướng

Ứng dụng của bạn có thể nghe các sự kiện xảy ra khi người dùng di chuyển dọc theo một tuyến đường.

Tổng quan

Sử dụng các giao diện sau để theo dõi sự kiện điều hướng:

Xem mã

Phát hiện việc đến một điểm đến

Ở đây, đích đến là một đích đến cuối cùng hoặc một điểm tham chiếu. Để phát hiện trạng thái đến, hãy gọi Navigator.addArrivalListener() để đăng ký một lệnh gọi lại khi thiết bị đến một đích đến.

Khi đến nơi, Navigation SDK cho Android sẽ kích hoạt lệnh gọi lại onArrival() và dừng hướng dẫn từng chặng. Bạn phải gọi rõ ràng Navigator.continueToNextDestination() để chuyển đến điểm trung gian tiếp theo và Navigator.startGuidance() để tiếp tục chỉ đường từng chặng.

Khi bạn gọi continueToNextDestination(), trình điều hướng sẽ loại bỏ mọi thông tin về đích đến trước đó. Nếu muốn phân tích thông tin về đoạn tuyến trước đó, bạn phải truy xuất thông tin từ trình điều hướng trước khi gọi continueToNextDestination().

Để tránh rò rỉ bộ nhớ, bạn phải gọi removeArrivalListener(listener) khi không cần trình nghe nữa.

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

Nhận thông tin cập nhật vị trí

Lấy RoadSnappedLocationProvider từ NavigationApi, sau đó gọi RoadSnappedLocationProvider.addLocationListener() để đăng ký lệnh gọi lại khi vị trí hoặc tiêu đề của thiết bị thay đổi. Xin lưu ý rằng vị trí này được gắn với một con đường nên có thể khác với vị trí do trình cung cấp vị trí kết hợp trả về trong các API vị trí của Dịch vụ Google Play.

SDK Điều hướng cung cấp thông tin cập nhật về vị trí thường xuyên nhất có thể. Khi có thông tin cập nhật vị trí, SDK điều hướng sẽ kích hoạt lệnh gọi lại onLocationChanged().

Thông tin cập nhật vị trí chụp đường phố độc lập với tính năng chỉ đường và có thể tiếp tục ngay cả sau khi tính năng chỉ đường dừng lại. Việc đăng ký nhận thông tin cập nhật vị trí có thể gây tiêu hao pin, rò rỉ bộ nhớ hoặc vô tình thu thập dữ liệu vị trí của thiết bị nếu bạn để thông tin cập nhật vị trí chạy ở chế độ nền. Gọi RoadSnappedLocationProvider.removeLocationListener khi bạn không cần trình nghe nữa.

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

Nhận thông tin cập nhật về thời gian và khoảng cách

Gọi Navigator.addRemainingTimeOrDistanceChangedListener() để đăng ký lệnh gọi lại khi thời gian còn lại (giây) hoặc khoảng cách (mét) thay đổi nhiều hơn một ngưỡng nhất định.

Khi thay đổi về thời gian hoặc khoảng cách vượt quá số lượng đã chỉ định, SDK Điều hướng sẽ kích hoạt lệnh gọi lại onRemainingTimeOrDistanceChanged().

Để xem thời gian và quãng đường còn lại, hãy gọi Navigator.getTimeAndDistanceList(). Lưu ý rằng thời gian và khoảng cách trong danh sách là tích luỹ: chúng cho biết thời gian và khoảng cách từ vị trí hiện tại đến từng điểm tham chiếu, chứ không phải từ điểm tham chiếu này đến điểm tham chiếu khác. Đối tượng TimeAndDistance hiện cũng trả về delaySeverity. Enum này sẽ là nặng, trung bình, nhẹ hoặc không xác định. Màu này tương ứng với màu bạn thấy trên eta trong giao diện người dùng của bản đồ (nặng = đỏ, trung bình = vàng, sáng = xanh lục). Điều này sẽ hữu ích nếu bạn cần tạo chân trang eta của riêng mình.

Để tránh rò rỉ bộ nhớ, bạn phải gọi Navigator.removeRemainingTimeOrDistanceChangedListener(listener) khi không cần trình nghe nữa.

Mẫu bên dưới yêu cầu lệnh gọi lại nếu thời gian còn lại thay đổi nhiều hơn 60 giây hoặc quãng đường còn lại thay đổi nhiều hơn 100 mét.

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

Bạn có thể hiển thị thông tin về thời gian và quãng đường còn lại bằng màn hình tích hợp bằng cách sử dụng phương thức setEtaCardEnabled() và truyền một thông số có giá trị TRUE. Để ẩn màn hình hiển thị thời gian và khoảng cách, hãy đặt giá trị này thành FALSE.

Bạn cũng có thể hiển thị ETA cho nhiều điểm trung gian bằng cách sử dụng phương thức getTimeAndDistanceList().

Nhận thông tin cập nhật về tuyến đường

Gọi Navigator.addRouteChangedListener() để đăng ký lệnh gọi lại khi tuyến này thay đổi.

Khi tuyến đường thay đổi, SDK điều hướng sẽ kích hoạt lệnh gọi lại onRouteChanged(). Bạn có thể gọi Navigator.getRouteSegmentsNavigator.getCurrentRouteSegment() để tìm tuyến đường mới.

Để tránh rò rỉ bộ nhớ, bạn phải gọi removeRouteChangedListener(listener) khi không cần trình nghe nữa.

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

Phát hiện thời điểm chế độ ban đêm thay đổi

Gọi NavigationView.addOnNightModeChangedListener hoặc SupportNavigationFragment.addOnNightModeChangedListener để đăng ký lệnh gọi lại khi chế độ ban đêm thay đổi.

Ví dụ sau đây minh hoạ việc theo dõi các thay đổi về chế độ ban đêm trên một mảnh điều hướng.

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

Bạn cũng có thể đặt chế độ ban đêm theo phương thức lập trình. Để biết thêm thông tin, hãy xem phần Đặt chế độ ban đêm.