Segui questa guida per tracciare un percorso nella tua app verso più destinazioni, chiamate anche tappe, con l'SDK di navigazione per Android.
Panoramica
- Integra l'SDK di navigazione nella tua app, descritto in Configurare il progetto.
- Aggiungi una
SupportNavigationFragment
oNavigationView
alla tua app. Questo elemento UI aggiunge la mappa interattiva e l'interfaccia utente di navigazione passo passo alla tua attività. - Utilizza la classe
NavigationApi
per inizializzare l'SDK. Definisci una
Navigator
per controllare la navigazione passo passo:- Aggiungi destinazioni utilizzando
setDestinations()
. - Avvia la navigazione con
startGuidance()
. - Utilizza
getSimulator()
per simulare l'avanzamento del veicolo lungo il percorso, per eseguire test, debug e dimostrare la tua dell'app.
- Aggiungi destinazioni utilizzando
Crea ed esegui la tua app.
Visualizza il codice
Aggiungi un frammento di navigazione
SupportNavigationFragment
è il componente dell'interfaccia utente che mostra
l'output visivo della navigazione, tra cui una mappa interattiva e indicazioni passo passo
indicazioni stradali. Puoi dichiarare il frammento nel file di layout XML come mostrato di seguito:
<?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"/>
In alternativa, puoi costruire il frammento in modo programmatico, come descritto in
la documentazione Android, utilizzando
FragmentActivity.getSupportFragmentManager()
In alternativa al frammento, il componente UI è disponibile anche come
NavigationView
Tieni presente le informazioni nella parte superiore della
la descrizione della classe, in particolare sul requisito di inoltrare il ciclo di vita
di machine learning.
Richiedi autorizzazione di accesso alla posizione
Per poter stabilire il tipo di accesso, la tua app deve richiedere l'autorizzazione di accesso alla posizione posizione del dispositivo.
Questo tutorial fornisce il codice necessario per richiedere l'autorizzazione di accesso alla posizione precisa. Per maggiori dettagli, consulta la guida alle autorizzazioni Android.
Aggiungi l'autorizzazione come elemento secondario dell'elemento
<manifest>
nel tuo dispositivo Android manifest:<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.navsdkmultidestination"> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> </manifest>
Richiedi le autorizzazioni di runtime nella tua app, per offrire all'utente la possibilità per consentire o negare l'autorizzazione di accesso alla posizione. Il seguente codice verifica se l'utente ha concesso l'autorizzazione di accesso alla posizione precisa. In caso contrario, richiede l'autorizzazione:
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; }
Esegui l'override del callback
onRequestPermissionsResult()
per gestire il risultato la richiesta di autorizzazione:@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; } } } }
Inizializza l'SDK di navigazione e configura un percorso
La classe NavigationApi
fornisce logica di inizializzazione
che autorizza la tua app a utilizzare la navigazione Google. La Navigator
una classe fornisce il controllo su come configurare e avviare/interrompere una navigazione
viaggio.
Crea un metodo di supporto per visualizzare un messaggio sullo schermo e nel log.
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); } }
Inizializza l'SDK di navigazione e sostituisci il Callback
onNavigatorReady()
per avviare la navigazione quando il navigatore è pronto: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); } } });
Aggiungere un metodo per creare un oggetto
Waypoint
da un determinato luogo ID e titolo.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); } }
Aggiungi un metodo per visualizzare il tempo di percorrenza e la distanza calcolati per ciascuno tappa successiva.
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); }
Imposta tutte le tappe di questo percorso. Tieni presente che potresti ricevere un messaggio di errore se utilizzi ID località per cui il navigatore non può tracciare un percorso. L'esempio app di questo tutorial utilizza gli ID luogo per le tappe in Australia. Leggi le note di seguito su come trovare ID luogo diversi. Dopo il calcolo indicazioni stradali,
SupportNavigationFragment
mostra una polilinea che rappresenta il percorso sulla mappa, con un indicatore in corrispondenza di ogni tappa.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); } } }); }
Crea ed esegui la tua app
- Collega un dispositivo Android al computer. Segui le istruzioni per attivare le opzioni sviluppatore sul tuo dispositivo Android dispositivo e configurare il sistema per il rilevamento del dispositivo. (In alternativa, puoi utilizza la Gestione dispositivi virtuali (AVD) Android per configurare una dispositivo. Quando scegli un emulatore, assicurati di scegliere un'immagine che includa le API di Google).
- In Android Studio, fai clic sull'opzione di menu Esegui (o sull'icona del pulsante di riproduzione). Scegli un dispositivo come richiesto.
Suggerimenti per migliorare l'esperienza utente
- L'utente deve accettare i Termini di servizio di Google Navigazione prima
la navigazione. Questa accettazione è richiesta una sola volta. Di
per impostazione predefinita, l'SDK richiede l'accettazione la prima volta che il navigatore
richiamato. Se preferisci, puoi attivare la finestra di dialogo Termini di servizio di navigazione
in una fase iniziale del flusso UX della tua app, ad esempio durante la registrazione o l'accesso, utilizzando
showTermsAndConditionsDialog()
- La qualità della navigazione e la precisione dell'orario di arrivo stimato vengono notevolmente migliorate se utilizzi ID località per inizializzare una tappa, anziché una latitudine/longitudine destinazione.
Questo campione ricava le tappe da un luogo specifico ID. Ecco altri modi per ottenere un ID luogo:
- Utilizza lo strumento di ricerca dei segnaposto per ottenere ID luogo per luoghi.
- Utilizza l'API Geocoding per trovare l'ID luogo per un determinato indirizzo. L'API Geocoding funziona bene se disponi di indirizzi completi e univoci per i waypoint. Consulta le guida alle best practice per la geocodifica.
- Utilizza la ricerca testuale dell'API Places per trovare ID luogo di un determinato indirizzo. L'API Places funziona bene se presentano indirizzi incompleti o ambigui per le tappe. Consulta le guida alle best practice per la geocodifica.