Ao integrar o SDK do Navigation para Android, seu app pode ir além de 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 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.
Prepare-se
Para começar a usar o SDK do Navigation, você precisa ter os itens a seguir.
- Uma chave de API provisionada para uso com o SDK de navegação. Consulte Como usar chaves de API para mais informações sobre como criar e restringir chaves.
- O artefato do SDK. Verifique se o projeto está configurado para usar o Maven para o SDK do Navigation.
- 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. Também é preciso saber utilizar o Google Maps como usuário.
Instalar os apps de demonstração
O Google oferece dois apps para ajudar você a entender o que o SDK Navigation oferece além das APIs 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 que não conhecem os dois projetos vão achar os dois apps úteis.
A partir do SDK de navegação para Android v4.1, os seguintes apps de demonstração estão disponíveis para download no GitHub.
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 Google Maps: mostra comportamentos individuais da interface
GoogleMap
para personalizar a sensação e a apresentação dos mapas.
Demonstração do GoogleNavigation
A demonstração mais recente do GoogleNavigation está disponível no GitHub.
Construção
No Android Studio, importe o app de demonstração e permita a execução do Gradle.
Abra
local.defaults.properties
e atualize o valor da propriedadeMAPS_API_KEY
:MAPS_API_KEY=YOUR_API_KEY
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
Conecte um dispositivo Android ao computador ou use um emulador.
- Dispositivo Android: consulte as instruções para ativar as opções para desenvolvedores no seu dispositivo Android e configurar o sistema para detectar o aparelho.
- Emulator: use o AVD Manager do Android (AVD, na sigla em inglês) 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 e escolha um destino de implantação.
Quando criado e lançado, 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 o NavigationView
em conjunto com o
Navigator
.
Opção 2: a segunda opção, intitulada NavFragmentActivity
, mostra
comportamentos usando o
SupportNavigationFragment
com o
Navigator
.
Ao clicar em uma dessas opções, você verá o seguinte:
- a interface de navegação
- um botão "Set Destination" no menu do aplicativo
- uma sobreposição com a qual você pode interagir para invocar métodos dinamicamente 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
O SwappingMapAndNavActivity
mostra os seguintes padrões comuns:
- exibindo um
MapView
- Mudar para um
NavigationView
quando a navegação começar - retornar a um
MapView
quando a navegação terminar
Demonstração do Google Maps
A demonstração mais recente do GoogleNavigation está disponível no GitHub.
Construção
No Android Studio, importe o app de demonstração e permita a execução do Gradle.
Abra
local.defaults.properties
e atualize o valor da propriedadeMAPS_API_KEY
:MAPS_API_KEY=YOUR_API_KEY
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
Conecte um dispositivo Android ao computador ou use um emulador.
- Dispositivo Android: consulte as instruções se quiser ativar as opções para desenvolvedores no seu dispositivo Android e configurar o sistema de modo a 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.
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 lançado, o app apresenta ao usuário uma página de destino com uma lista de demonstrações.
Esse padrão de apresentação e a estrutura correspondente do código-fonte
devem ser familiares para os usuários das demonstrações do SDK do Google Maps. 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.