Navigationsereignisse im Blick behalten

Ihre App kann auf Ereignisse warten, die auftreten, wenn der Nutzer entlang einer Route navigiert.

Überblick

Verwenden Sie die folgenden Oberflächen, um auf Navigationsereignisse zu warten:

Code

Ankunft an einem Ziel erkennen

Hier bezeichnet ein Ziel entweder ein endgültiges Ziel oder einen Wegpunkt. Zur Erkennung der Ankunft rufen Sie Navigator.addArrivalListener() auf. Dadurch wird ein Callback registriert, wenn das Gerät ein Ziel erreicht.

Nach der Ankunft löst das Navigation SDK for Android den onArrival()-Callback aus und stoppt die detaillierte Routenführung. Sie müssen explizit Navigator.continueToNextDestination() aufrufen, um zum nächsten Wegpunkt zu gelangen, und Navigator.startGuidance(), um die detaillierte Routenführung fortzusetzen.

Wenn Sie continueToNextDestination() aufrufen, verwirft der Navigator alle Informationen zum vorherigen Ziel. Wenn Sie Informationen zum vorherigen Routensegment analysieren möchten, müssen Sie die Informationen aus dem Navigator abrufen, bevor Sie continueToNextDestination() aufrufen.

Zur Vermeidung von Speicherlecks müssen Sie removeArrivalListener(listener) aufrufen, wenn Sie den Listener nicht mehr benötigen.

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

Standortaktualisierungen empfangen

Rufen Sie ein RoadSnappedLocationProvider von NavigationApi ab und rufen Sie dann RoadSnappedLocationProvider.addLocationListener() auf, um sich für einen Callback zu registrieren, wenn sich der Standort oder die Richtung des Geräts ändert. Dieser Standort ist an einer Straße ausgerichtet und kann sich daher von dem Standort unterscheiden, der vom Anbieter für kombinierte Standortbestimmung in den Standort-APIs der Google Play-Dienste zurückgegeben wird.

Das Navigation SDK aktualisiert den Standort so oft wie möglich. Wenn ein Standortupdate verfügbar ist, löst das Navigation SDK den Callback onLocationChanged() aus.

Updates zu angefahrenen Straßen sind unabhängig von der Navigation und können auch nach einer Unterbrechung der Navigation fortgesetzt werden. Wenn du Standortupdates abonnierst, kann das zu einer Akkuentladung, einem Speicherleck oder einer unbeabsichtigten Erfassung von Gerätestandortdaten führen, wenn die Standortupdates im Hintergrund ausgeführt werden. Rufen Sie RoadSnappedLocationProvider.removeLocationListener auf, wenn Sie den Listener nicht mehr benötigen.

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

Aktuelle Informationen zu Zeit und Entfernung erhalten

Rufen Sie Navigator.addRemainingTimeOrDistanceChangedListener() auf, um sich für einen Callback zu registrieren, wenn sich die verbleibende Zeit (Sekunden) oder Entfernung (Meter) um mehr als einen bestimmten Grenzwert ändert.

Wenn die Zeit- oder Entfernungsänderung den angegebenen Wert überschreitet, löst das Navigation SDK den onRemainingTimeOrDistanceChanged()-Callback aus.

Um die verbleibende Zeit und Strecke zu ermitteln, rufen Sie Navigator.getTimeAndDistanceList() auf. Die Zeitangaben und Entfernungen in der Liste sind kumulativ: Sie zeigen die Zeit und Entfernung zwischen dem aktuellen Standort und den einzelnen Wegpunkten an, nicht zwischen den einzelnen Wegpunkten. Das TimeAndDistance-Objekt gibt jetzt auch delaySeverity zurück. Diese Enum ist entweder „Heavy“, „Meduim“, „Light“ oder „Unbekannt“. Das entspricht der Farbe, die Sie auf der Karten-UI für „ETA“ sehen (schwer = rot, mittel = gelb, hell = grün). Dies ist hilfreich, wenn Sie Ihre eigene ETA-Fußzeile erstellen müssen.

Zur Vermeidung von Speicherlecks müssen Sie Navigator.removeRemainingTimeOrDistanceChangedListener(listener) aufrufen, wenn Sie den Listener nicht mehr benötigen.

Im folgenden Beispiel wird ein Callback angefordert, wenn sich die verbleibende Zeit um mehr als 60 Sekunden oder die verbleibende Entfernung um mehr als 100 Meter ändert.

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

Die verbleibenden Zeit- und Entfernungsinformationen können Sie auf dem integrierten Display mit der Methode setEtaCardEnabled() aufrufen und einen Parameter mit dem Wert TRUE übergeben. Wenn Sie die Anzeige von Zeit/Entfernung unterdrücken möchten, setzen Sie diesen Wert auf FALSE.

Mit der Methode getTimeAndDistanceList() können Sie die ETA auch für mehrere Wegpunkte freigeben.

Aktuelle Routeninformationen erhalten

Rufen Sie Navigator.addRouteChangedListener() auf, um einen Callback zu registrieren, wenn sich die Route ändert.

Wenn sich die Route ändert, löst das Navigation SDK den onRouteChanged()-Callback aus. Sie können Navigator.getRouteSegments und Navigator.getCurrentRouteSegment() aufrufen, um die neue Route zu ermitteln.

Zur Vermeidung von Speicherlecks müssen Sie removeRouteChangedListener(listener) aufrufen, wenn Sie den Listener nicht mehr benötigen.

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

Erkennen, wenn sich der Nachtmodus ändert

Rufen Sie NavigationView.addOnNightModeChangedListener oder SupportNavigationFragment.addOnNightModeChangedListener auf, um sich für einen Callback bei einem Wechsel des Nachtmodus zu registrieren.

Das folgende Beispiel zeigt, wie Nachtmodusänderungen in einem Navigationsfragment überwacht werden.

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