Routen für einzelne Ziele

In diesem Leitfaden erfahren Sie, wie Sie mit dem Navigation SDK for Android eine Route in Ihrer App planen. In diesem Leitfaden wird davon ausgegangen, dass Sie das Navigation SDK bereits in Ihre App eingebunden haben, wie unter Projekt einrichten beschrieben.

Zusammenfassung

  1. Fügen Sie Ihrer App ein UI-Element hinzu, entweder als Navigationsfragment oder als Navigationsansicht. Mit diesem UI-Element werden die interaktive Karte und die UI für die detaillierte Routenführung zu Ihrer Aktivität hinzugefügt.
  2. Berechtigungen zur Standortermittlung anfordern Ihre App muss eine Berechtigung zur Standortermittlung anfordern, um den Standort des Geräts zu bestimmen.
  3. Initialisieren Sie das SDK mit der Klasse NavigationApi.

  4. Mit der Klasse Navigator können Sie ein Ziel festlegen und die detaillierte Routenführung steuern. Dazu sind drei Schritte erforderlich:

    • Legen Sie das Ziel mit setDestination() fest.
    • Starten Sie die Navigation mit startGuidance().
    • Mit getSimulator() können Sie den Fortschritt des Fahrzeugs entlang der Route simulieren, um Ihre App zu testen, Fehler zu beheben und sie zu demonstrieren.

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

Code

Ihrer App ein UI-Element hinzufügen

In diesem Abschnitt werden zwei Möglichkeiten beschrieben, wie Sie die interaktive Karte und die Benutzeroberfläche für die detaillierte Routenführung hinzufügen können. In den meisten Fällen empfehlen wir die Verwendung von NavigationFragment, einem Wrapper für NavigationView, anstatt direkt mit NavigationView zu interagieren. Weitere Informationen finden Sie unter Best Practices für die Interaktion mit Navigationskarten .

NavigationFragment ist die UI-Komponente, die die visuelle Ausgabe der Navigation anzeigt, einschließlich einer interaktiven Karte und einer detaillierten Routenführung. Sie können das Fragment in Ihrer XML-Layoutdatei so 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.NavigationFragment"
    android:id="@+id/navigation_fragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

Alternativ können Sie das Fragment programmatisch erstellen, wie in der Android-Dokumentation beschrieben. Verwenden Sie dazu 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 die Berechtigung zur genauen Standortermittlung anfordern. Weitere Informationen finden Sie im Leitfaden zu Android-Berechtigungen.

  1. Fügen Sie die Berechtigung als untergeordnetes Element des Elements <manifest> in Ihrem Android-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. Fordern Sie in Ihrer App Laufzeitberechtigungen an und geben Sie dem Nutzer die Möglichkeit, die Berechtigung zur Standortermittlung zu erteilen oder abzulehnen. Mit dem folgenden Code wird überprü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 bietet Initialisierungslogik, mit der Ihre App für die Verwendung der Google-Navigation autorisiert wird. In diesem Abschnitt wird beschrieben, wie Sie den Navigator initialisieren und einige andere Konfigurationen 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: Konfigurieren Sie die App so, dass Navigationsbenachrichtigungen und Hintergrunddienste beendet werden, wenn der Nutzer die App auf seinem Gerät schließt. Diese Entscheidung hängt von Ihrem Geschäftsmodell ab. Sie können das Standardverhalten des Navigators verwenden, bei dem die Routenführung und Standortaktualisierungen auch dann angezeigt werden, wenn die App geschlossen wird. Wenn Sie stattdessen die Navigation und Standort-Updates beenden möchten, wenn der Endnutzer die App schließt, verwenden Sie diese Konfiguration.

  3. Optional: Aktivieren Sie Straßenbeschränkungen in unterstützten Ländern. Legen Sie die letzte Ziffer des Kfz-Kennzeichens fest. Dieser Aufruf muss nur einmal erfolgen. Er wird für nachfolgende Routenanfragen weiter verwendet. Dieser Aufruf funktioniert nur in unterstützten Regionen. Länder, in denen das Navigation SDK unterstützt wird

        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) getSupportFragmentManager()
                            .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 Navigationsfahrt konfigurieren, starten und beenden.

Legen Sie mit dem im vorherigen Abschnitt abgerufenen Navigator ein Ziel-Waypoint für diese Fahrt fest. Nach der Berechnung der Wegbeschreibung wird auf der Karte eine Polylinie für die Route und eine Markierung am Ziel angezeigt.NavigationFragment

```none
    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).
                                AudioGuidanceSettings audioSettings =
                                        AudioGuidanceSettings.builder()
                                                .setGuidanceMode(
                                                        AudioGuidanceSettings.GuidanceMode
                                                                .VOICE_ALERTS_AND_GUIDANCE)
                                                .build();
                                mNavigator.setAudioGuidanceSettings(audioSettings);

                                // 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;
                            case ROUTING_TIMEOUT:
                                displayMessage("Error starting navigation: Routing timed out.");
                                break;
                            default:
                                displayMessage("Error starting navigation: "
                                        + String.valueOf(code));
                        }
                    }
                });
    }
```

Sprachführung konfigurieren

Wenn Sie die Einstellungen für die Sprachführung anpassen möchten (einschließlich des Führungsmodus und der Lautstärke), übergeben Sie ein AudioGuidanceSettings-Objekt an den Navigator.

Der Navigator verwendet die zuletzt gespeicherten Einstellungen oder standardmäßig die normale Lautstärke und Sprachbenachrichtigungen mit Routenführung.

Im folgenden Beispiel wird gezeigt, wie Sie den Navigator so konfigurieren, dass er eine niedrige Lautstärke verwendet und sowohl Sprachmeldungen als auch die detaillierte Routenführung aktiviert:

// Configure audio guidance settings.
AudioGuidanceSettings audioSettings = AudioGuidanceSettings.builder()
        .setGuidanceMode(AudioGuidanceSettings.GuidanceMode.VOICE_ALERTS_AND_GUIDANCE)
        .setVolumeLevel(AudioGuidanceSettings.VolumeLevel.LOW)
        .build();

mNavigator.setAudioGuidanceSettings(audioSettings);

App erstellen und ausführen

  1. Verbinden Sie ein Android-Gerät mit Ihrem Computer. Folgen Sie der Anleitung in Android Studio zum Ausführen von Apps auf einem Hardwaregerät. Alternativ können Sie mit dem Android Virtual Device (AVD) Manager ein virtuelles Gerät 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 auf Run. Wählen Sie ein Gerät aus, wenn Sie dazu aufgefordert werden.

Hinweise für eine bessere Nutzererfahrung

  • Der Nutzer muss die Nutzungsbedingungen für die Google-Navigation akzeptieren, bevor die Navigation verfügbar ist. Diese Zustimmung ist nur einmal erforderlich. Standardmäßig fordert das SDK die Zustimmung an, wenn der Navigator zum ersten Mal aufgerufen wird. Wenn Sie möchten, können Sie das Dialogfeld mit den Nutzungsbedingungen für die Navigation auch zu einem früheren Zeitpunkt im UX-Ablauf Ihrer App auslösen, z. B. bei der Registrierung oder Anmeldung, indem Sie TermsAndConditionsCheckOption verwenden.
  • Wenn Sie die Qualität der Navigation und die Genauigkeit der voraussichtlichen Ankunftszeit deutlich verbessern möchten, sollten Sie Wegpunkte mit Orts-IDs statt mit Breiten- und Längengraden initialisieren.
  • In diesem Beispiel wird der Zielwegpunkt von einer bestimmten Orts-ID für das Opernhaus in Sydney abgeleitet. Mit der Orts-ID-Suche können Sie Orts-IDs für andere bestimmte Orte abrufen.