Siga este guia para traçar uma rota no seu app usando o SDK do Navigation para Android. Este guia pressupõe que você já integrou o SDK do Navigation ao seu app, conforme descrito em Configurar seu projeto.
Resumo
- Adicione um elemento da interface ao seu app como um fragmento ou uma visualização de navegação. Esse elemento da interface adiciona o mapa interativo e a interface de navegação guiada à sua atividade.
- Solicite permissões de localização. Seu app precisa solicitar a permissão de localização para determinar o local do dispositivo.
- Inicialize o SDK usando a
classe
NavigationApi
. Definir um destino e controlar a navegação guiada usando a classe
Navigator
. Isso envolve três etapas:- Defina o destino usando
setDestination()
. - Inicie a navegação com
startGuidance()
. - Use
getSimulator()
para simular o andamento do veículo ao longo do trajeto para testar, depurar e demonstrar seu app.
- Defina o destino usando
Compile e execute o app.
Confira o código
Adicionar um elemento de interface ao app
Esta seção aborda duas maneiras de adicionar o mapa interativo e a interface para exibir a navegação guiada.
Usar um fragmento de navegação
SupportNavigationFragment
é o componente de IU que mostra a saída visual da navegação, incluindo um
mapa interativo e rotas passo a passo. É possível declarar o fragmento no
arquivo de layout XML desta forma:
<?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"/>
Como alternativa, você pode construir o fragmento de forma programática, conforme descrito na
documentação do Android, usando
FragmentActivity.getSupportFragmentManager()
.
Usar uma visualização de navegação
Como alternativa a um fragmento, o componente de interface usado para mostrar um mapa para navegação também está disponível como um NavigationView
.
Solicitar permissão de localização
Esta seção mostra como solicitar a permissão de localização exata. Para ver mais detalhes, consulte o guia sobre permissões do Android.
Adicione a permissão como filha do elemento
<manifest>
no manifesto do Android:<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.navsdksingledestination"> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> </manifest>
Solicite permissões de execução no app, oferecendo ao usuário a oportunidade de conceder ou negar a permissão de localização. O código abaixo verifica se o usuário concedeu a permissão de localização exata. Se não, ele solicita a permissão:
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; }
Modifique o callback
onRequestPermissionsResult()
para processar o resultado da solicitação de permissão:@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; } } } }
Inicializar o SDK do Navigation
A classe
NavigationApi
fornece uma lógica de inicialização que autoriza o app a usar a navegação
do Google. Esta seção aborda como inicializar o navegador, além de algumas
outras configurações que podem ser ativadas no app:
Inicialize o SDK do Navigation e substitua o callback
onNavigatorReady()
para iniciar a navegação quando o navegador estiver pronto.Opcional. Configure o app para que as notificações de orientação e os serviços em segundo plano sejam encerrados quando o usuário dispensar o app do dispositivo. Essa escolha depende do seu modelo de negócios. Você pode usar o comportamento padrão do navegador, que continua mostrando a orientação de rota e atualizações de localização mesmo quando o app é dispensado. Se, em vez disso, você quiser encerrar as atualizações de navegação e localização quando o usuário final dispensou o app, use essa configuração.
Opcional. Ative as restrições de vias nos países em que o recurso está disponível. Defina o último dígito da placa do carro. Essa chamada só precisa ser feita uma vez: as solicitações de rotas subsequentes continuarão a usá-la. Esta chamada só funciona em regiões compatíveis. Consulte Países com suporte ao SDK Navigation.
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); } } });
Definir um destino
A classe
Navigator
fornece controle sobre a configuração, o início e a interrupção de uma jornada
de navegação.
Usando o
Navigator
recebido na seção anterior, defina um destino
Waypoint
para essa jornada. Depois de calcular as rotas, SupportNavigationFragment
exibe uma polilinha que representa o trajeto no mapa e um marcador no destino.
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));
}
}
});
}
Criar e executar o app
- Conecte um dispositivo Android ao computador. Siga as instruções do Android Studio sobre como Executar apps em um dispositivo de hardware. Outra opção é configurar um dispositivo virtual usando o AVD Manager. Ao escolher um emulador, selecione uma imagem que inclua as APIs do Google.
- No Android Studio, clique na opção de menu Run ou no ícone do botão de reprodução. Escolha um dispositivo quando solicitado.
Dicas para melhorar a experiência do usuário
- O usuário precisa aceitar os Termos de Serviço de navegação do Google antes
que a navegação fique disponível. Essa aceitação só é necessária uma vez. Por
padrão, o SDK solicita a aceitação na primeira vez que o navegador é
invocado. Se preferir, você pode acionar a caixa de diálogo dos Termos de Serviço de navegação
em um momento inicial do fluxo de UX do app, como durante uma inscrição ou login, usando
TermsAndConditionsCheckOption
. - Para melhorar significativamente a qualidade da navegação e a precisão do HEC, use IDs de lugar para inicializar um waypoint em vez de coordenadas de latitude/longitude.
- Este exemplo deriva o waypoint de destino a partir de um ID de lugar específico da Sydney Opera House. Você pode usar o localizador de IDs de lugares para encontrar IDs de outros locais específicos.