Siga este guia para traçar um trajeto no seu app para um único destino usando o SDK do Navigation para Android.
Visão geral
- Integre o SDK do Navigation ao seu app, conforme descrito no guia de configuração.
- Adicione um
NavigationFragment
ouNavigationView
ao app. Esse elemento da interface adiciona o mapa interativo e a interface de navegação guiada à sua atividade. - Use a classe
NavigationApi
para inicializar o SDK. Defina um
Navigator
para controlar a navegação guiada:- Adicione um destino usando
setDestination()
. - Inicie a navegação com
startGuidance()
. - Use
getSimulator()
para simular o progresso do veículo ao longo do trajeto para testar, depurar e demonstrar seu app.
- Adicione um destino usando
Compile e execute o app.
Confira o código
Adicionar um fragmento de navegação
O NavigationFragment
é o componente da interface que mostra
o resultado visual da navegação, incluindo um mapa interativo e rotas
guia de navegação. Você pode declarar o fragmento no arquivo de layout XML, conforme mostrado abaixo:
<?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"/>
Como alternativa, você pode construir o fragmento de forma programática, conforme descrito na documentação do Android.
Para apps que usam a versão de suporte de Fragment
,
o SDK do Navigation oferece compatibilidade usando a
SupportNavigationFragment
. Esse fragmento se comporta
de maneira idêntica a NavigationFragment
, e você pode gerenciá-lo
de maneira programática usando
FragmentActivity.getSupportFragmentManager()
.
Como alternativa a um fragmento, o componente de interface também está disponível como uma
NavigationView
. Observe as informações na parte de cima
da descrição da classe, principalmente sobre o requisito de encaminhar métodos do
ciclo de vida.
Solicitar permissão de localização
Seu app precisa solicitar permissão de localização para determinar onde o dispositivo está.
Neste tutorial, mostramos o código necessário para pedir a permissão de localização exata. Para 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 permitir ou negar a permissão de localização. O código a seguir 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 e configurar uma jornada
A classe NavigationApi
fornece a lógica de inicialização
que autoriza o app a usar a navegação do Google. A classe Navigator
fornece controle sobre a configuração e a inicialização/interrupção de uma jornada
de navegação.
Inicialize o SDK de navegação e substitua o callback
onNavigatorReady()
para iniciar a navegação quando o navegador estiver pronto.(Opcional) Defina o último dígito da placa do veículo para ativar restrições de via nos países com suporte (atualmente Brasil e Indonésia). Se essa chamada for usada para outros códigos de país, a API a ignorará. Essa chamada só precisa ser feita uma vez. As solicitações de rotas subsequentes continuarão a usá-la.
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); // Set the last digit of the car's license plate to get route restrictions // in supported countries. (optional) // 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); } } });
Usando o
Navigator
acima, defina um destinoWaypoint
para essa jornada. Depois de calcular as rotas, oNavigationFragment
mostra 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 instructions se quiser ativar as opções para desenvolvedores no seu dispositivo Android e configurar o sistema de modo a detectar o aparelho. Também é possível usar o AVD Manager para configurar um dispositivo virtual. 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 do Google Navigation para
que a navegação fique disponível. Essa aceitação é necessária apenas 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 a inscrição ou o login, usando
showTermsAndConditionsDialog()
. - A qualidade da navegação e a precisão do HEC são melhoradas significativamente se você usa IDs de lugar para inicializar um waypoint, em vez de um destino de latitude/longitude.
- Este exemplo deriva o waypoint de destino de um ID de lugar específico (para a Ópera de Sydney). Você pode usar o localizador de IDs de lugares para conferir IDs de outros locais específicos. Como alternativa, você pode oferecer ao usuário a oportunidade de escolher um destino adicionando um seletor de lugar ao app. Para testar uma amostra funcional do seletor de lugar com o SDK do Navigation, consulte o app de demonstração descrito na introdução.
Próxima etapa
Descubra como navegar para vários destinos em uma jornada. Caso seu contrato com o Google especifique o faturamento por transação, configure as transações faturáveis.