Routen für einzelne Ziele

Folgen Sie dieser Anleitung, um mit dem Navigation SDK for Android eine Route in Ihrer App darzustellen. In diesem Leitfaden wird davon ausgegangen, dass Sie das Navigation SDK bereits in Ihre App integriert haben, wie unter Projekt einrichten beschrieben.

Zusammenfassung

  1. Fügen Sie Ihrer Anwendung ein UI-Element hinzu, entweder als Navigationsfragment oder als Navigationsansicht. Mit diesem UI-Element werden Ihrer Aktivität die interaktive Karte und die Benutzeroberfläche für die Schritt-für-Schritt-Navigation hinzugefügt.
  2. Berechtigung zur Standortermittlung anfordern. Um den Gerätestandort bestimmen zu können, muss deine App die Berechtigung zur Standortermittlung anfordern.
  3. Initialisieren Sie das SDK mit der Klasse NavigationApi.

  4. Legen Sie mithilfe der Klasse Navigator ein Ziel fest und steuern Sie die detaillierte Routenführung. Dies umfasst drei Schritte:

    • Legen Sie das Ziel mit setDestination() fest.
    • Starten Sie die Navigation mit startGuidance().
    • Mit getSimulator() kannst du den Fortschritt des Fahrzeugs auf der Route simulieren, um deine App zu testen, zu debuggen und vorzuführen.

  5. Erstellen Sie Ihre App und führen Sie sie aus.

Code

Einer App ein UI-Element hinzufügen

In diesem Abschnitt werden zwei Möglichkeiten beschrieben, wie Sie die interaktive Karte und die Benutzeroberfläche zum Anzeigen der detaillierten Routenführung hinzufügen können.

SupportNavigationFragment ist die UI-Komponente, die die visuelle Ausgabe der Navigation darstellt, einschließlich einer interaktiven Karte und detaillierter Routenführung. Du kannst das Fragment in deiner XML-Layoutdatei wie hier gezeigt deklarieren:

<?xml version="1.0" encoding="utf-8"?>
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    android:name="com.google.android.libraries.navigation.SupportNavigationFragment"
    android:id="@+id/navigation_fragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

Alternativ kannst du das Fragment programmatisch erstellen, wie in der Android-Dokumentation beschrieben, mithilfe von FragmentActivity.getSupportFragmentManager().

Als Alternative zu einem Fragment ist die UI-Komponente zum Anzeigen einer Karte für die Navigation auch als NavigationView verfügbar.

Berechtigung zur Standortermittlung anfordern

In diesem Abschnitt wird beschrieben, wie Sie eine detaillierte Berechtigung zur Standortermittlung anfordern. Weitere Informationen findest du im Leitfaden zu Android-Berechtigungen.

  1. Fügen Sie die Berechtigung in Ihrem Android-Manifest als untergeordnetes Element des Elements <manifest> hinzu:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.navsdksingledestination">
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
</manifest>

  2. Fordere in deiner App Laufzeitberechtigungen an und gib dem Nutzer die Möglichkeit, die Berechtigung zur Standortermittlung zu erteilen oder zu verweigern. Mit dem folgenden Code wird geprüft, ob der Nutzer eine gültige Berechtigung zur Standortermittlung erteilt hat. Falls nicht, wird die Berechtigung angefordert:

    if (ContextCompat.checkSelfPermission(this.getApplicationContext(),
        android.Manifest.permission.ACCESS_FINE_LOCATION)
            == PackageManager.PERMISSION_GRANTED) {
    mLocationPermissionGranted = true;
} else {
    ActivityCompat.requestPermissions(this,
            new String[] { android.Manifest.permission.ACCESS_FINE_LOCATION },
            PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION);
}

if (!mLocationPermissionGranted) {
    displayMessage("Error loading Navigation SDK: "
            + "The user has not granted location permission.");
    return;
}

  3. Überschreiben Sie den Callback onRequestPermissionsResult(), um das Ergebnis der Berechtigungsanfrage zu verarbeiten:

    @Override
public void onRequestPermissionsResult(int requestCode, @NonNull String permissions[],
                                       @NonNull int[] grantResults) {
    mLocationPermissionGranted = false;
    switch (requestCode) {
        case PERMISSIONS_REQUEST_ACCESS_FINE_LOCATION: {
            // If request is canceled, the result arrays are empty.
            if (grantResults.length > 0
                    && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                mLocationPermissionGranted = true;
            }
        }
    }
}

Navigation SDK initialisieren

Die Klasse NavigationApi enthält eine Initialisierungslogik, mit der Ihre App für die Verwendung der Google-Navigation autorisiert wird. In diesem Abschnitt erfahren Sie, wie Sie den Navigator initialisieren und welche weiteren Konfigurationen Sie für Ihre App aktivieren können:

  1. Initialisieren Sie das Navigation SDK und überschreiben Sie den Callback onNavigatorReady(), um die Navigation zu starten, wenn der Navigator bereit ist.

  2. Optional. Konfiguriere die App so, dass Anleitungsbenachrichtigungen und Hintergrunddienste heruntergefahren werden, wenn der Nutzer die App von seinem Gerät schließt. Das hängt von Ihrem Geschäftsmodell ab. Sie können die Standardfunktion des Navigators verwenden, bei der auch nach Schließen der App weiterhin Abbiegehinweise und Standortaktualisierungen angezeigt werden. Wenn Sie stattdessen die Navigations- und Standortupdates beenden möchten, nachdem der Endnutzer die App geschlossen hat, sollten Sie diese Konfiguration verwenden.

  3. Optional. Aktivieren Sie Straßeneinschränkungen in unterstützten Ländern. Lege die letzte Ziffer des Nummernschilds fest. Dieser Aufruf muss nur einmal ausgeführt werden. In nachfolgenden Routenanfragen wird er weiterhin verwendet. Dieser Anruf funktioniert nur in unterstützten Regionen. Weitere Informationen finden Sie unter Unterstützte Länder.

    NavigationApi.getNavigator(this, new NavigationApi.NavigatorListener() {
            /**
             * Sets up the navigation UI when the navigator is ready for use.
             */
            @Override
            public void onNavigatorReady(Navigator navigator) {
                displayMessage("Navigator ready.");
                mNavigator = navigator;
                mNavFragment = (NavigationFragment) getFragmentManager()
                        .findFragmentById(R.id.navigation_fragment);

                // Optional. Disable the guidance notifications and shut down the app
                // and background service when the user closes the app.
                // mNavigator.setTaskRemovedBehavior(Navigator.TaskRemovedBehavior.QUIT_SERVICE)

                // Optional. Set the last digit of the car's license plate to get
                // route restrictions for supported countries.
                // mNavigator.setLicensePlateRestrictionInfo(getLastDigit(), "BZ");

                // Set the camera to follow the device location with 'TILTED' driving view.
                mNavFragment.getCamera().followMyLocation(Camera.Perspective.TILTED);

                // Set the travel mode (DRIVING, WALKING, CYCLING, TWO_WHEELER, or TAXI).
                mRoutingOptions = new RoutingOptions();
                mRoutingOptions.travelMode(RoutingOptions.TravelMode.DRIVING);

                // Navigate to a place, specified by Place ID.
                navigateToPlace(SYDNEY_OPERA_HOUSE, mRoutingOptions);
            }

            /**
             * Handles errors from the Navigation SDK.
             * @param errorCode The error code returned by the navigator.
             */
            @Override
            public void onError(@NavigationApi.ErrorCode int errorCode) {
                switch (errorCode) {
                    case NavigationApi.ErrorCode.NOT_AUTHORIZED:
                        displayMessage("Error loading Navigation SDK: Your API key is "
                                + "invalid or not authorized to use the Navigation SDK.");
                        break;
                    case NavigationApi.ErrorCode.TERMS_NOT_ACCEPTED:
                        displayMessage("Error loading Navigation SDK: User did not accept "
                                + "the Navigation Terms of Use.");
                        break;
                    case NavigationApi.ErrorCode.NETWORK_ERROR:
                        displayMessage("Error loading Navigation SDK: Network error.");
                        break;
                    case NavigationApi.ErrorCode.LOCATION_PERMISSION_MISSING:
                        displayMessage("Error loading Navigation SDK: Location permission "
                                + "is missing.");
                        break;
                    default:
                        displayMessage("Error loading Navigation SDK: " + errorCode);
                }
            }
        });

Ziel festlegen

Mit der Klasse Navigator können Sie eine Navigation konfigurieren, starten und beenden.

Legen Sie mit der im vorherigen Abschnitt ermittelten Navigator ein Ziel Waypoint für diese Fahrt fest. Nachdem die Route berechnet wurde, werden in SupportNavigationFragment eine Polylinie für die Route auf der Karte und eine Markierung am Zielort angezeigt.

    private void navigateToPlace(String placeId, RoutingOptions travelMode) {
        Waypoint destination;
        try {
            destination = Waypoint.builder().setPlaceIdString(placeId).build();
        } catch (Waypoint.UnsupportedPlaceIdException e) {
            displayMessage("Error starting navigation: Place ID is not supported.");
            return;
        }

        // Create a future to await the result of the asynchronous navigator task.
        ListenableResultFuture<Navigator.RouteStatus> pendingRoute =
                mNavigator.setDestination(destination, travelMode);

        // Define the action to perform when the SDK has determined the route.
        pendingRoute.setOnResultListener(
                new ListenableResultFuture.OnResultListener<Navigator.RouteStatus>() {
                    @Override
                    public void onResult(Navigator.RouteStatus code) {
                        switch (code) {
                            case OK:
                                // Hide the toolbar to maximize the navigation UI.
                                if (getActionBar() != null) {
                                    getActionBar().hide();
                                }

                                // Enable voice audio guidance (through the device speaker).
                                mNavigator.setAudioGuidance(
                                        Navigator.AudioGuidance.VOICE_ALERTS_AND_GUIDANCE);

                                // Simulate vehicle progress along the route for demo/debug builds.
                                if (BuildConfig.DEBUG) {
                                    mNavigator.getSimulator().simulateLocationsAlongExistingRoute(
                                            new SimulationOptions().speedMultiplier(5));
                                }

                                // Start turn-by-turn guidance along the current route.
                                mNavigator.startGuidance();
                                break;
                            // Handle error conditions returned by the navigator.
                            case NO_ROUTE_FOUND:
                                displayMessage("Error starting navigation: No route found.");
                                break;
                            case NETWORK_ERROR:
                                displayMessage("Error starting navigation: Network error.");
                                break;
                            case ROUTE_CANCELED:
                                displayMessage("Error starting navigation: Route canceled.");
                                break;
                            default:
                                displayMessage("Error starting navigation: "
                                        + String.valueOf(code));
                        }
                    }
                });
    }

App erstellen und ausführen

  1. Verbinden Sie ein Android-Gerät mit Ihrem Computer. Folgen Sie der Anleitung in Android Studio unter Apps auf einem Hardwaregerät ausführen. Sie können auch ein virtuelles Gerät mit dem Android Virtual Device (AVD) Manager konfigurieren. Beim Auswählen eines Emulators sollten Sie ein Image angeben, das die Google-APIs enthält.
  2. Klicken Sie in Android Studio auf die Menüoption Run oder das Wiedergabesymbol. Wählen Sie ein Gerät aus, wenn Sie dazu aufgefordert werden.

Tipps für eine verbesserte Nutzererfahrung

  • Der Nutzer muss die Nutzungsbedingungen von Google Navigation akzeptieren, bevor die Navigation zur Verfügung steht. Diese Zustimmung ist nur einmal erforderlich. Standardmäßig fordert das SDK die Annahme an, wenn der Navigator zum ersten Mal aufgerufen wird. Sie können das Dialogfeld mit den Nutzungsbedingungen für die Navigation zu einem frühen Zeitpunkt im UX-Ablauf Ihrer App auslösen, z. B. bei der Registrierung oder Anmeldung mit TermsAndConditionsCheckOption.
  • Wenn Sie die Qualität der Navigation und die voraussichtliche Ankunftszeit erheblich verbessern möchten, sollten Sie statt der Breiten- und Längengradkoordinaten zur Initialisierung eines Wegpunkts Orts-IDs verwenden.
  • In diesem Beispiel wird der Zielwegpunkt von einer bestimmten Orts-ID für das Opernhaus Sydney abgeleitet. Mit der Orts-ID-Suche können Sie Orts-IDs für andere Standorte abrufen.