Referência rápida do SDK do Navigation para Android

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:

SDK do Navigation para Android: configuração

Pacotes oficiais do SDK do Navigation para Android:

  • maven: com.google.android.libraries.navigation:navigation

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-maps diretamente ou por uma dependência transitiva acabam com cópias duplicadas do SDK do Maps. Correção: exclua com.google.android.gms:play-services-maps de 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 NavigationView diretamente ao usar NavigationFragment ou chamá-los fora de ordem com NavigationView gera erros. Correção: use NavigationFragment, que gerencia callbacks do ciclo de vida. Se você usar NavigationView, 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

  • Waypoint fromLatLng() e fromPlaceId(): 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.
  • setLocationMarkerEnabled em NavigationView e SupportNavigationFragment: 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.
  • DisplayOptions showTrafficLights e showStopSigns: 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:navigation do repositório Maven google(). Sintoma: a versão 5.0 e as mais recentes são enviadas apenas como com.google.android.libraries.navigation:navigation no 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

SDK do Navigation para Android: anotações do Maps

SDK do Navigation para Android: estilização de mapas

SDK do Navigation para Android: navegação