Testar a versão de demonstração

Com a integração do SDK do Navigation para Android, seu app pode ir além da vinculação 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 aparência única de dados sobre a jornada de um usuário. Este guia explica como executar os apps de demonstração do SDK do Navigation, que estão disponíveis no GitHub.

Observação: no momento, o SDK do Navigation está disponível apenas para alguns clientes, e você precisa ter ativado o SDK para executar os apps de demonstração. Para mais informações, entre em contato com a equipe de vendas.

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. Esse agora é o método preferido para obter o SDK. Para mais informações, consulte Configurar seu projeto.

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

• Um representante da Plataforma Google Maps para ter acesso aos seguintes itens:

  • Uma chave de API provisionada para uso com o SDK do Navigation. É necessário fornecer o ID do projeto, 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 para o SDK do Navigation.
  • Para projetos que usam a v4.99.0 e versões 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 projetada para pessoas familiarizadas com o desenvolvimento do Android e conceitos de programação orientada a objetos. Você também deve estar familiarizado com o Google Maps do ponto de vista de um usuário.

Observação :se o app já usa o SDK do Maps, ele substitui o SDK do Maps tanto para a camada do mapa quanto para os recursos de navegação. Não é possível usar o SDK do Navigation e do Maps no mesmo app.

Instalar os apps de demonstração

O Google fornece dois apps para ajudar você a entender o que o SDK de navegação oferece além das APIs do Google Maps, dependendo do seu nível de experiência. Os desenvolvedores que conhecem as APIs Google Maps podem se concentrar na demonstração do GoogleNavigation. Os desenvolvedores iniciantes em ambos os projetos acharão os dois aplicativos úteis.

A partir do SDK do Navigation para Android v4.1, os apps de demonstração a seguir estão disponíveis no GitHub para download.

• Demonstração do GoogleNavigation: mostra a integração de comportamentos e visualizações da API relacionados à 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 experiência e a apresentação dos mapas.

Uma 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 AAR bruto no projeto, é possível adicioná-lo 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 no GitHub.

Edifício

1. No Android Studio, importe o app de demonstração e permita a execução do Gradle.

   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 de implementação do SDK.

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

   • No XML do layout, observe o design e o texto do layout.

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

Consulte a documentação do plug-in Secrets Gradle para mais informações sobre como a chave de API é adicionada ao manifesto.

Em execução

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 opções.

Opções de NavViewActivity e NavFragmentActivity

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

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

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

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

• a IU de navegação;
• um botão "Set Destination" no menu do aplicativo
• uma sobreposição 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 de 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 para ver.

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 forneça esse exemplo como exemplo de como usar os dois lado a lado.

O SwappingMapAndNavActivity mostra os seguintes padrões comuns:

• mostrando um MapView
• como trocar para um NavigationView quando a navegação começar
• retornar a um MapView quando a navegação terminar;

A 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 no GitHub.

Edifício

1. No Android Studio, importe o app de demonstração e permita a execução do Gradle.

   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 de implementação do SDK.

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

   • No XML do layout, observe o design e o texto do layout.

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

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

Em execução

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 dispositivo.
   • 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 já conhecem esse padrão de apresentação e a estrutura correspondente do código-fonte. Isso ocorre porque a demonstração do GoogleMap foi projetada para ser 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 em qual classe de visualização quer fazer uma demonstração: NavigationView ou MapView, quando aplicável.

O Google geralmente incentiva os usuários a usar o NavigationView. Esta demonstração oferece a flexibilidade de testar esses comportamentos em ambas as versões em nosso app de demonstração e escolher a que funcionar 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 aplicativo 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 muito desatualizado. Nesses casos, é necessário aguardar a extração automática de uma versão mais recente ou atualizar manualmente o Google Play Services pela Google Play Store.