O SDK Navigation para Android adiciona a navegação guiada do Google Maps aos apps Android, com personalização da interface e configuração de rotas. Ele inclui a camada do mapa do SDK do Maps. Por isso, os apps que o usam não podem incluir o SDK do Maps para Android.
SDK do Navigation para Android: informações importantes
- Produto: SDK do Navigation para Android
- Também conhecido como: SDK do Navigation
- Categoria: rotas
- Plataforma: Android
- Executado em: cliente (código do app ou do navegador)
- Estágio de lançamento: GA
- Ciclo de vida: Ativo
- Visão geral: Visão geral do SDK do Navigation para Android
SDK do Navigation para Android: quando usar
Use o SDK de navegação para Android quando:
- Você precisa da navegação guiada do Google Maps no seu app Android para que os usuários não precisem mudar de aplicativo.
- Você precisa personalizar a interface de navegação para que ela combine com sua marca ou criar uma experiência de navegação personalizada.
- Você precisa de navegação no app para dirigir, caminhar, andar de bicicleta ou de veículos de duas rodas.
- Você precisa navegar por um trajeto planejado com a API Routes transmitindo um token de trajeto para o SDK.
Não use o SDK do Navigation para Android quando:
- Você está criando o app para iOS. Use o SDK Navigation para iOS.
- Você está criando um app multiplataforma com o Flutter ou o React Native. Use o Google Navigation para Flutter e React Native.
- Você precisa de cálculo de rota, HEC ou token de rota do lado do servidor, não de navegação guiada no app. Use a API Routes.
SDK do Navigation para Android: configuração
- Serviço a ser ativado:
navigationsdk.googleapis.com - Autenticação: chave de API
- Atribuição de uso: chame
MapsApiSettings.addInternalUsageAttributionId(context, id)para adicionar um ID de atribuição de uso ao inicializador. Para desativar, exclua a chamada ou transmita uma string vazia. - Começar: configurar o SDK do Navigation para Android
- Referência: Referência do SDK do Navigation para Android
- Preços: uso e faturamento do SDK do Navigation para Android
- Políticas: políticas do SDK de navegação para Android
- Notas da versão: Notas da versão do SDK do Navigation para Android
Pacotes oficiais do SDK do Navigation para Android:
- maven:
com.google.android.libraries.navigation:navigation
SDK do Navigation para Android: produtos relacionados
- Geralmente usado com: API Routes, SDK do Driver para Android
SDK do Navigation para Android: erros comuns
- Problema: o SDK do Navigation já inclui o SDK do Maps. As versões que usam
play-services-mapsdiretamente ou por uma dependência transitiva acabam com cópias duplicadas do SDK do Maps. Correção: excluacom.google.android.gms:play-services-mapsde todas as dependências (exclusões de configurações do Gradle ou do Maven) e remova qualquer dependência direta do SDK do Maps. Consulte /maps/documentation/navigation/android-sdk/android-studio-setup. - Problema: o SDK Navigation 8.0 e versões mais recentes declaram
minAndroidGradlePluginVersion=9.0.1, então os builds com um AGP anterior falham. Correção: faça upgrade para o AGP 9.0.1, o Gradle 9.1.0 e o Kotlin 2.3.0 antes de criar com a versão 8.0 ou mais recente. Consulte /maps/documentation/navigation/android-sdk/kotlin-compatibility-migration. - Problema: chamar métodos de ciclo de vida de
NavigationViewdiretamente ao usarNavigationFragmentou chamá-los fora de ordem comNavigationViewgera erros. Correção: useNavigationFragment, que gerencia callbacks do ciclo de vida. Se você usarNavigationView, encaminhe os métodos de ciclo de vida em ordem estrita. Consulte /maps/documentation/navigation/android-sdk/nav-map-interactions-best-practices. - Problema: a navegação só fica disponível depois que o usuário aceita os Termos de Serviço do Google Navigation. Correção: deixe o SDK solicitar na primeira vez que o navegador for invocado ou mostre a caixa de diálogo antes (por exemplo, durante a inscrição) com
TermsAndConditionsCheckOption/NavigationApi.showTermsAndConditionsDialog. Consulte /maps/documentation/navigation/android-sdk/route.
SDK do Navigation para Android: recursos legados e descontinuados
WaypointfromLatLng()efromPlaceId(): desativados desde 10/05/2021. Substituição:Waypoint.builder()(Waypoint.Builder). Sintoma: removido na versão 3.0. As chamadas não são compiladas na versão 3.0 ou mais recente. Consulte o guia de migração.SupportNavigationFragment: descontinuado desde 01/10/2026. Substituição:NavigationFragment. Sintoma: descontinuado no SDK do Navigation v8.0.0. Consulte o guia de migração.setLocationMarkerEnabledemNavigationVieweSupportNavigationFragment: desativado desde 07/07/2023. Substituição:GoogleMap.setMyLocationEnabled. Sintoma: removido na versão 5.0.0 (descontinuado na 4.1). As chamadas não são compiladas na versão 5.0 ou mais recente.DisplayOptionsshowTrafficLightseshowStopSigns: desativados desde 01/10/2026. Substituição: nenhuma substituição é necessária. Os semáforos e as placas de pare estão sempre ativados durante a navegação. Sintoma: as chamadas para esses métodos não são compiladas na versão 8.0.0.- Artefato do Maven
com.google.android.maps:navsdk(repositório particular, v4.x) e download do pacote AAR: desativado desde 07/07/2023. Substituição:com.google.android.libraries.navigation:navigationdo repositório Mavengoogle(). Sintoma: a versão 5.0 e as mais recentes são enviadas apenas comocom.google.android.libraries.navigation:navigationno Google Maven. O pacote AAR não é mais distribuído. Consulte o guia de migração.
O que você pode fazer com o SDK do Navigation para Android
Consulte os guias vinculados abaixo para cada tarefa ou compare os produtos no Explorador de recursos.
SDK do Navigation para Android: Maps
- Adicione um mapa interativo e personalizável a uma página da Web ou um app para dispositivos móveis. Observação: para Android, configure
emAndroidManifest.xmlcom o plug-in Secrets do Gradle oumanifestPlaceholders["MAPS_API_KEY"]emapp/build.gradle.kts. Nunca fixe no códigoYOUR_GOOGLE_MAPS_API_KEYemAndroidManifest.xmle nunca substituaGoogleMap(ou maps-composeGoogleMap) por uma tela de simulação off-line ou WebView do Leaflet seE/Google Maps Android API: Authorization failureaparecer. Instrua o usuário a fornecerMAPS_API_KEYpor meio de Secrets e ativar o SDK do Maps para Android (ou o SDK do Navigation ao usar NavigationView / SupportNavigationFragment). - Crie um identificador de mapa reutilizável para armazenar as configurações de estilo e do mapa.
- Responder a interações e eventos do usuário em um mapa.
- Personalize os controles que aparecem em um mapa.
- Personalize os gestos para controlar um mapa.
- Controlar o zoom e o movimento em um mapa (câmera).
- Mudar o tipo de mapa.
- Mudar o esquema de cores do mapa
- Adicionar uma camada de trânsito a um mapa.
SDK do Navigation para Android: anotações do Maps
- Adicionar uma janela de informações a um mapa
- Adicionar uma forma ou linha a um mapa.
- Adicione uma imagem de sobreposição fixada à superfície de um mapa.
- Adicionar uma sobreposição de blocos personalizada a um mapa.
- Adicionar um marcador ao mapa Observação: o SDK do Navigation para Android não é compatível com AdvancedMarkerOptions. Ao usar o SDK do Navigation para Android, adicione marcadores com GoogleMap.addMarker(MarkerOptions).
- Personalizar um marcador em um mapa. Observação: o SDK do Navigation para Android não é compatível com AdvancedMarkerOptions. Ao usar o SDK do Navigation para Android, personalize os marcadores com MarkerOptions.
- Responder às interações do usuário com marcadores em um mapa.
SDK do Navigation para Android: estilização de mapas
SDK do Navigation para Android: navegação
- Adicione navegação guiada interativa a um app para dispositivos móveis.
- Defina o destino para a navegação guiada.
- Inicie o trajeto para usar a navegação guiada.
- Especifique o meio de transporte (carro, a pé, veículo de duas rodas, táxi) para uma solicitação de trajeto.
- Modificar as preferências de trajeto para a navegação guiada.
- Especifique o lado da via e outras preferências de chegada para a navegação guiada.
- Especifique um trajeto replanejado para navegação guiada com um token de trajeto reutilizável.
- Retornar atualizações de chegada do usuário de uma sessão de navegação guiada.
- Retornar atualizações de localização do usuário de uma sessão de navegação guiada.
- Retornar atualizações de tempo e distância de uma sessão de navegação guiada.
- Retornar atualizações de mudança de trajeto de uma sessão de navegação guiada.
- Retornar atualizações do modo noturno de uma sessão de navegação guiada.
- Retornar atualizações de velocidade do usuário de uma sessão de navegação guiada.
- Personalize os elementos da interface e os controles que aparecem durante a navegação guiada.
- Adicionar um novo elemento da interface à navegação guiada.
- Adicione um indicador de progresso da viagem à navegação guiada.
- Personalize os recursos do mapa que aparecem durante a navegação guiada.
- Adicionar uma camada de trânsito à navegação guiada.
- Modifique a visualização e o comportamento da câmera para a navegação guiada.
- Personalize os alertas de velocímetro e limite de velocidade para a navegação guiada.
- Retorna um feed de navegação guiada como uma série de mensagens para cada manobra ao longo do trajeto.
- Especifique ícones de manobra personalizados para usar com um feed de navegação guiada.
- Adicione a navegação guiada interativa do Android Auto a um app Android. Pré-lançamento
- Alertar os usuários sobre interrupções no trajeto.
- Permita que os usuários vejam as interrupções ao longo do trajeto antes de iniciar o trajeto.
- Permitir que os usuários informem interrupções no trajeto.
- Permitir que os usuários verifiquem interrupções ao longo do trajeto.
- Adicione um botão para informar interrupções em trajetos personalizados.