Routen mit mehreren Zielen

Folgen Sie dieser Anleitung, um in Ihrer App eine Route zu mehreren Zielen, auch Wegpunkte genannt, unter Verwendung des Navigation SDK for Android.

Übersicht

  1. Integrieren Sie das Navigation SDK in Ihre App, wie unter Projekt einrichten beschrieben.
  2. Fügen Sie ein SupportNavigationFragment- oder NavigationView zu deiner App. Dieses UI-Element werden Ihrer Aktivität die interaktive Karte und die Benutzeroberfläche für die detaillierte Routenführung hinzugefügt.
  3. Verwenden Sie die Klasse NavigationApi, um das SDK zu initialisieren.
  4. Definieren Sie eine Navigator, um die detaillierte Routenführung zu steuern:

    • Fügen Sie Ziele mit setDestinations() hinzu.
    • Starten Sie die Navigation mit startGuidance().
    • Mit getSimulator() können Sie den Fortschritt des Fahrzeugs entlang der Route simulieren, um Ihre App zu testen, zu debuggen und zu demonstrieren.
  5. Erstellen Sie Ihre App und führen Sie sie aus.

Code

Navigationsfragment hinzufügen

SupportNavigationFragment ist die UI-Komponente, mit der die visuelle Ausgabe der Navigation, einschließlich einer interaktiven Karte und detaillierter Routenführung Wegbeschreibungen. Sie können das Fragment in Ihrer XML-Layoutdatei wie folgt 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 können Sie das Fragment wie in der Android-Dokumentation beschrieben mit FragmentActivity.getSupportFragmentManager() programmatisch erstellen.

Als Alternative zu einem Fragment ist die UI-Komponente auch als NavigationView verfügbar. In den meisten Fällen empfehlen wir, SupportNavigationFragment, Das ist ein Wrapper für NavigationView, anstatt direkt mit NavigationView zu interagieren. Weitere Informationen finden Sie unter Best Practices für die Interaktion mit Navigationskarten.

Berechtigung zur Standortermittlung anfordern

Deine App muss die Berechtigung zur Standortermittlung anfordern, um das Standort des Geräts.

Dieses Tutorial enthält den Code, den Sie zum Anfordern einer detaillierten Berechtigung zur Standortermittlung benötigen. 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.navsdkmultidestination">
        <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, Nutzer hat eine gültige Berechtigung zur Standortermittlung erteilt. 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.", DISPLAY_BOTH);
        return;
    }
    
  3. Überschreiben Sie den Rückruf 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 und eine Fahrt konfigurieren

Die Klasse NavigationApi stellt eine Initialisierungslogik bereit. , der deine App zur Nutzung der Google-Navigation autorisiert. Die Navigator -Klasse ermöglicht die Steuerung des Konfigurierens und Startens/Stoppens einer Navigation Reise.

  1. Erstellen Sie eine Hilfsmethode, um eine Nachricht auf dem Bildschirm und im Protokoll anzuzeigen.

    private void displayMessage(String errorMessage, String displayMedium) {
        if (displayMedium.equals(DISPLAY_BOTH) || displayMedium.equals(DISPLAY_TOAST)) {
            Toast.makeText(this, errorMessage, Toast.LENGTH_LONG).show();
        }
    
        if (displayMedium.equals(DISPLAY_BOTH) || displayMedium.equals(DISPLAY_LOG)) {
            Log.d(TAG, errorMessage);
        }
    }
    
  2. Initialisieren Sie das Navigation SDK und überschreiben Sie onNavigatorReady()-Callback zum Starten der Navigation, wenn der Navigator ist bereit:

    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.", DISPLAY_BOTH);
                    mNavigator = navigator;
                    mNavFragment = (SupportNavigationFragment) getFragmentManager()
                            .findFragmentById(R.id.navigation_fragment);
    
                    // Set the camera to follow the device location with 'TILTED' driving view.
                    mNavFragment.getCamera().followMyLocation(Camera.Perspective.TILTED);
    
                    // Navigate to the specified places.
                    navigateToPlaces();
                }
    
                /**
                 * 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.",
                                    DISPLAY_BOTH);
                            break;
                        case NavigationApi.ErrorCode.TERMS_NOT_ACCEPTED:
                            displayMessage("Error loading Navigation SDK: User did not accept "
                                    + "the Navigation Terms of Use.", DISPLAY_BOTH);
                            break;
                        case NavigationApi.ErrorCode.NETWORK_ERROR:
                            displayMessage("Error loading Navigation SDK: Network error.",
                                    DISPLAY_BOTH);
                            break;
                        case NavigationApi.ErrorCode.LOCATION_PERMISSION_MISSING:
                            displayMessage("Error loading Navigation SDK: Location permission "
                                    + "is missing.", DISPLAY_BOTH);
                            break;
                        default:
                            displayMessage("Error loading Navigation SDK: " + errorCode,
                                    DISPLAY_BOTH);
                    }
                }
            });
    
  3. Fügen Sie eine Methode hinzu, um ein Waypoint-Objekt anhand einer bestimmten Orts-ID und eines Titels zu erstellen.

    private void createWaypoint(String placeId, String title) {
        try {
            mWaypoints.add(
              Waypoint.builder()
                     .setPlaceIdString(placeId)
                     .setTitle(title)
                     .build()
            );
        } catch (Waypoint.UnsupportedPlaceIdException e) {
            displayMessage("Error starting navigation: Place ID is not supported: " + placeId,
                    DISPLAY_BOTH);
        }
    }
    
  4. Fügen Sie eine Methode hinzu, um die berechnete Reisezeit und die Entfernung Wegpunkt.

    private void displayTimesAndDistances() {
        List<TimeAndDistance> timesAndDistances = mNavigator.getTimeAndDistanceList();
        int leg = 1;
        String message = "You're on your way!";
        for (TimeAndDistance timeAndDistance : timesAndDistances) {
            message = message + "\nRoute leg: " + leg++
                    + ": Travel time (seconds): " + timeAndDistance.getSeconds()
                    + ". Distance (meters): " + timeAndDistance.getMeters();
        }
        displayMessage(message, DISPLAY_BOTH);
    }
    
  5. Legen Sie alle Wegpunkte für diese Fahrt fest. Hinweis: Wenn Sie Orts-IDs verwenden, für die der Navigationsgerät keine Route planen kann, wird möglicherweise eine Fehlermeldung angezeigt. Das Beispiel In dieser Anleitung werden in der App Orts-IDs für Wegpunkte in Australien verwendet. Hinweise ansehen unten zum Abrufen verschiedener Orts-IDs) Nach der Berechnung zeigt der SupportNavigationFragment eine Polylinie an. die die Route auf der Karte darstellt, mit einer Markierung an jedem Wegpunkt.

    private void navigateToPlaces() {
    
        // Set up a waypoint for each place that we want to go to.
        createWaypoint("ChIJq6qq6jauEmsRJAf7FjrKnXI", "Sydney Star");
        createWaypoint("ChIJ3S-JXmauEmsRUcIaWtf4MzE", "Sydney Opera House");
        createWaypoint("ChIJLwgLFGmuEmsRzpDhHQuyyoU", "Sydney Conservatorium of Music");
    
        // If this journey is already in progress, no need to restart navigation.
        // This can happen when the user rotates the device, or sends the app to the background.
        if (mSavedInstanceState != null
                && mSavedInstanceState.containsKey(KEY_JOURNEY_IN_PROGRESS)
                && mSavedInstanceState.getInt(KEY_JOURNEY_IN_PROGRESS) == 1) {
            return;
        }
    
        // Create a future to await the result of the asynchronous navigator task.
        ListenableResultFuture<Navigator.RouteStatus> pendingRoute =
                mNavigator.setDestinations(mWaypoints);
    
        // 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:
                                mJourneyInProgress = true;
                                // Hide the toolbar to maximize the navigation UI.
                                if (getActionBar() != null) {
                                    getActionBar().hide();
                                }
    
                                // Register some listeners for navigation events.
                                registerNavigationListeners();
    
                                // Display the time and distance to each waypoint.
                                displayTimesAndDistances();
    
                                // 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.",
                                        DISPLAY_BOTH);
                                break;
                            case NETWORK_ERROR:
                                displayMessage("Error starting navigation: Network error.",
                                        DISPLAY_BOTH);
                                break;
                            case ROUTE_CANCELED:
                                displayMessage("Error starting navigation: Route canceled.",
                                        DISPLAY_BOTH);
                                break;
                            default:
                                displayMessage("Error starting navigation: "
                                        + String.valueOf(code), DISPLAY_BOTH);
                        }
                    }
                });
    }
    

App erstellen und ausführen

  1. Verbinden Sie ein Android-Gerät mit Ihrem Computer. Folgen Sie dieser Anleitung, um Entwickleroptionen auf Ihrem Android-Gerät zu aktivieren und Ihr System so zu konfigurieren, dass das Gerät erkannt wird. Alternativ können Sie mit Android Virtual Device (AVD) Manager ein virtuelles Gerät konfigurieren. Bei der Auswahl eines Emulators sollten Sie ein Image auswählen, das Folgendes enthält: der Google APIs.)
  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 bessere Nutzererfahrung

  • Der Nutzer muss die Nutzungsbedingungen von Google Navigation akzeptieren, bevor er Navigation verfügbar wird. Diese Zustimmung ist nur einmal erforderlich. Von Standardeinstellung ist, fordert das SDK die Annahme an, wenn der Navigator das erste Mal aufgerufen wird. Wenn Sie möchten, können Sie das Dialogfeld mit den Nutzungsbedingungen für die Navigation öffnen. zu einem frühen Zeitpunkt im UX-Ablauf Ihrer App, z. B. bei der Registrierung oder Anmeldung, mit showTermsAndConditionsDialog()
  • Die Navigationsqualität und die Genauigkeit der voraussichtlichen Ankunftszeit werden erheblich verbessert, wenn Sie Orts-IDs zum Initialisieren eines Wegpunkts anstelle eines Ziels mit Längen- und Breitengrad verwenden.
  • In diesem Beispiel werden die Wegpunkte aus bestimmten Orts-IDs abgeleitet. Andere Möglichkeiten zum Abrufen einer Orts-ID:

    • Verwenden Sie die Orts-ID-Suche, um Orts-IDs für bestimmte Standorte.
    • Verwenden Sie die Geocoding API, um die Orts-ID für eine bestimmte Adresse zu ermitteln. Die Geocoding API funktioniert gut, wenn Sie vollständige, eindeutige Adressen für die Wegpunkte haben. Weitere Informationen finden Sie im Leitfaden Best Practices für das Geocoding.
    • Verwenden Sie die Places API-Textsuche, um nach Orts-ID für eine bestimmte Adresse. Die Places API funktioniert gut, wenn Sie unvollständige oder mehrdeutige Adressen für die Wegpunkte haben. Weitere Informationen finden Sie im Leitfaden Best Practices für das Geocoding.