Testar a demonstração

Ao integrar o SDK do Navigation para Android, seu app pode ir além de se vincular a uma visualização de mapa externa. Com a navegação do Google Maps, seu app pode oferecer recuperação dinâmica e relatórios de visualização única de dados sobre a jornada de um motorista.

Este guia apresenta um projeto do Android Studio, mostra como integrar o SDK do Navigation e, em seguida, mostra como executar os aplicativos de demonstração.

O SDK do Navigation é uma biblioteca estática que oferece controle sobre a aparência e o áudio da navegação no seu app. Para mais detalhes sobre a biblioteca, abra a referência do SDK do Navigation (Javadoc) em uma janela separada.

Faça a preparação.

Importante: a partir da v3.0 do SDK do Navigation para Android, você pode fazer o download da versão mais recente dele no nosso repositório Maven. Agora, esse é o método preferido para receber o SDK. Para mais informações, consulte Configurar seu projeto.

Observação: o acesso ao SDK do Navigation é controlado por um grupo de espaço de trabalho. Para mais informações, consulte Receber acesso.

Para começar a usar o SDK do Navigation, você precisa ter os itens a seguir.

• Um representante da Plataforma Google Maps para acessar:

  • Uma chave de API provisionada para uso com o SDK do Navigation. É necessário informar o projectID, que pode ser encontrado no painel principal do Console do Google Cloud, abaixo do nome do projeto.
  • O artefato do SDK. Verifique se o projeto está configurado para usar o Maven no SDK do Navigation.
  • Para projetos que usam a v4.99.0 e anteriores. Se não for possível usar o Maven, faça o download do artefato compactado no Google Drive compartilhado. O arquivo de biblioteca estática é o .aar no diretório libs/ que contém o SDK do Navigation como um pacote AAR.
  • Um ou mais dos apps de demonstração.

• Android Studio, o ambiente de desenvolvimento recomendado para criar um app com o SDK do Navigation.

Esta documentação foi elaborada para pessoas familiarizadas com o desenvolvimento do Android e com conceitos de programação orientada a objetos. Você também deve estar familiarizado com o Google Maps como usuário.

Instale os apps de demonstração

Dependendo do seu nível de experiência, o Google oferece dois apps para ajudar você a entender o que o SDK do Navigation oferece, além das APIs Google Maps. Os desenvolvedores familiarizados com as APIs Google Maps podem focar na demonstração da Navegação GPS. Os desenvolvedores iniciantes nos dois projetos vão achar ambos os apps úteis.

A partir do SDK do Navigation para Android v4.1, os seguintes apps de demonstração estão disponíveis no Google Drive compartilhado para download.

• Demonstração do GoogleNavigation: mostra a integração de comportamentos e visualizações da API conforme pertencem à experiência do usuário em uma sessão de navegação guiada.

• Demonstração do GoogleMap: mostra comportamentos individuais da interface GoogleMap para personalizar a aparência e a apresentação de mapas.

Observação sobre o uso do Maven

Os apps de demonstração são configurados para fazer o download do artefato do SDK do repositório Maven remoto usando o plug-in do Artifact Registry no Gradle. Siga as instruções de configuração do projeto para ter acesso ao SDK.

Observação: para as versões 4.99.0 e anteriores, se você ainda quiser usar o pacote de AAR bruto no seu projeto, adicione-o ao projeto no diretório libs. Em seguida, é necessário remover todas as referências ao plug-in artifactregistry e ao respectivo repositório remoto e declarar a seguinte dependência de AAR no build.gradle no nível do app: api(name: 'google_navigation', ext: 'aar')

Demonstração do GoogleNavigation

A demonstração mais recente do GoogleNavigation está disponível na raiz do Google Drive compartilhado. Há versões anteriores do app no "Arquivo". Para versões anteriores à 4.1, o app é empacotado com o AAR no mesmo arquivo ZIP.

Edifício

1. No Android Studio, importe o app de demonstração e permita que o Gradle seja executado.

   Observação :o app não carrega o mapa até que você atualize local.defaults.properties com a chave de API provisionada.

2. Abra local.defaults.properties e atualize o valor da propriedade MAPS_API_KEY:

     MAPS_API_KEY=YOUR_API_KEY
   

3. Clique em build e examine os detalhes da implementação do SDK.

   • Na classe Java, observe o código de implementação.

   • Observe o texto e o design do layout no XML.

   • No arquivo build.gradle, anote o SDK nas dependências.

Consulte a documentação do plug-in Secrets Gradle (link em inglês) para mais informações sobre como a chave de API é adicionada ao manifesto.

Correndo

1. Conecte um dispositivo Android ao computador ou use um emulador.

   • Dispositivo Android: consulte as instructions para ativar as opções para desenvolvedores no seu dispositivo Android e configurar o sistema para detectar o aparelho.
   • Emulator;Use o AVD Manager para configurar um dispositivo virtual. Ao escolher um emulador, selecione uma imagem que inclua as APIs do Google.

2. No Android Studio, clique na opção de menu Run ou no ícone do botão de reprodução e escolha um destino de implantação.

Quando criado e iniciado, o app apresenta ao usuário uma página de destino com uma lista de opções.

Opções de NavViewActivity e NavFragmentActivity

Os novos usuários do NavSDK provavelmente vão achar essas duas opções as mais úteis.

Opção 1: NavViewActivity mostra comportamentos usando a NavigationView com a Navigator.

Opção 2: a segunda opção, intitulada NavFragmentActivity, mostra comportamentos usando a SupportNavigationFragment com a Navigator.

Ao clicar em uma dessas opções, você verá o seguinte:

• a interface de navegação
• um botão "Definir destino" no menu do app
• uma sobreposição com que você pode interagir para invocar dinamicamente métodos na API
• um menu flutuante com mais opções

Para começar, clique em Definir destino e escolha um endereço. Em seguida, o app simula uma viagem do seu local atual até esse endereço. Use a sobreposição dos painéis de controle para ver o que acontece quando você chama uma API. Por exemplo, você pode clicar em View Methods para tentar forçar o SDK a entrar no modo noturno e conferir a aparência.

Opção SwappingMapAndNavActivity

Observação: essa opção ajuda na transição da v1 para a v4. Recomendamos usar NavigationView exclusivamente sempre que possível, mas fornecemos isso como um exemplo de como usar os dois lado a lado.

O SwappingMapAndNavActivity mostra os seguintes padrões comuns:

• mostrando um MapView
• trocando para um NavigationView quando a navegação começa
• retornar a um MapView quando a navegação termina

Demonstração do GoogleMap

Observação: esse app não está disponível para versões do SDK anteriores à v4.1.

A demonstração mais recente do GoogleNavigation está disponível na raiz do Google Drive compartilhado. Há versões anteriores do app no "Arquivo".

Edifício

1. No Android Studio, importe o app de demonstração e permita que o Gradle seja executado.

   Observação :o app não vai carregar o mapa até que você atualize local.defaults.properties com a chave de API provisionada.

2. Abra local.defaults.properties e atualize o valor da propriedade MAPS_API_KEY:

     MAPS_API_KEY=YOUR_API_KEY
   

3. Clique em build e examine os detalhes da implementação do SDK.

   • Na classe Java, observe o código de implementação.

   • Observe o texto e o design do layout no XML.

   • No arquivo build.gradle, anote o SDK nas dependências.

Consulte o plug-in secrets do Gradle (link em inglês) para mais informações sobre como a chave de API é adicionada ao manifesto.

Correndo

1. Conecte um dispositivo Android ao computador ou use um emulador.

   • Dispositivo Android: consulte as instructions para ativar as opções para desenvolvedores no seu dispositivo Android e configurar o sistema para detectar o aparelho.
   • Emulador: use o AVD Manager para configurar um dispositivo virtual. Ao escolher um emulador, selecione uma imagem que inclua as APIs do Google.

2. No Android Studio, clique na opção de menu Run ou no ícone do botão de reprodução e escolha um destino de implantação.

Quando criado e iniciado, o app apresenta ao usuário uma página de destino com uma lista de demonstrações.

Os usuários das demonstrações do SDK do Google Maps precisam conhecer esse padrão de apresentação e a estrutura correspondente do código-fonte. Isso ocorre porque a demonstração do GoogleMap é semelhante ao app de demonstração da API Maps. A principal diferença é que a demonstração do SDK do Navigation permite que o usuário escolha qual classe de visualização ele quer testar: NavigationView ou MapView, quando aplicável.

O Google geralmente incentiva os usuários a usar o NavigationView. Essa demonstração oferece a flexibilidade de testar esses comportamentos nas duas versões no nosso app de demonstração e escolher a que funcionar melhor para você. Por exemplo, ainda pode ser necessário usar um MapView em situações em que você está usando uma biblioteca de terceiros que espera interagir com essa classe.

Importante :as classes MapView, MapFragment e SupportMapFragment exigem que os dispositivos tenham o app Google Play Services instalado. Se você ativar um emulador novo ou redefinir um dispositivo muito antigo para a configuração original, a imagem do Android poderá vir com um Google Play Services pré-instalado muito desatualizado. Nesses casos, será necessário aguardar que ele faça o download automático de uma versão mais recente ou atualize o Play Services manualmente pela Google Play Store.