Experiência de navegação personalizada

O SDK Navigation oferece diferentes maneiras de integrar uma experiência de navegação ao seu app. Esta página explica o que é uma experiência de navegação personalizada e como ela difere de outras experiências de navegação disponíveis no SDK Navigation.

O que é uma experiência de navegação personalizada?

A principal maneira de implementar o SDK Navigation é usar a experiência de navegação do Google, que permite incorporar uma experiência de navegação detalhada que usa elementos e recursos visuais da interface fornecidos pelo Google, semelhante à experiência de navegação nos apps do Google Maps. Se você precisar de mais flexibilidade do que a experiência de navegação do Google oferece, implemente uma experiência de navegação personalizada. Uma experiência de navegação personalizada se refere a qualquer coisa, desde a eliminação completa da orientação detalhada e a execução da navegação apenas como um processo em segundo plano até a projeção de uma experiência de orientação altamente personalizada em uma tela separada do dispositivo que executa a navegação. Com uma experiência de navegação personalizada, seu app chama o SDK Navigation para solicitar um feed de navegação detalhada. Em seguida, você fornece e gerencia os elementos e recursos visuais da interface que o usuário vê na experiência de navegação. Embora o uso da experiência de navegação do Google seja geralmente mais fácil de implementar, a criação da sua própria experiência de navegação personalizada permite mais personalização.

Ao criar uma experiência de navegação personalizada, seu app chama o SDK Navigation para iniciar, executar e interromper a navegação, usando o seguinte fluxo:

  1. Iniciar a navegação. Para iniciar uma experiência de navegação personalizada, crie uma instância de navegação e defina o destino. Estabeleça uma sessão de navegação usando GMSNavigationService.createNavigationSession. Esse objeto não de interface com estado funciona com ou sem um controlador de visualização.

    Para mais informações, consulte Detalhes sobre o feed de dados de navegação guiada.

    Confira a demonstração:o download do SDK Navigation contém uma demonstração que você pode executar para conferir um exemplo de experiência de navegação que alterna entre a navegação guiada pela navegação padrão e uma experiência de navegação que mostra apenas a localização do dispositivo se movendo ao longo de uma polilinha de estrada.

  2. Navegação ativa. Esta é outra diferença fundamental entre uma experiência de navegação fornecida pelo Google e uma experiência de navegação personalizada. Em vez de entregar a orientação ao gerenciador de eventos integrado do SDK Navigation, você configura um listener para navegação guiada detalhada implementando o protocolo GMSNavigatorListener e, em seguida, implementa manipuladores de eventos. Isso permite que sua experiência responda aos eventos descritos em Ouvir eventos de navegação.

  3. Encerrar a navegação. Assim como na experiência de navegação do Google, a navegação personalizada também exige que você encerre a navegação da maneira mais adequada para a experiência do app.

Quando usar uma experiência de navegação personalizada?

A tabela a seguir descreve alguns cenários de navegação personalizados.

Cenário de exemplo

Etapas gerais

Você precisa fornecer orientação de texto para dispositivos pequenos, como veículos de duas rodas.

Crie seu navegador e configure a navegação guiada como um feed de dados para um dispositivo de tela pequena enquanto o navegador é executado no smartphone do motorista fora da visualização imediata.

Você quer disponibilizar seu app como um serviço de carro para motoristas que usam o Apple CarPlay.
  1. Configure o serviço de carro.
  2. Configure seu projeto do SDK Navigation.
  3. Estabeleça um navegador, se ainda não tiver feito isso.
  4. Configure um listener para navegação guiada.
  5. Desenhe o mapa na superfície do app automático e preencha os campos do feed de dados configurado.

Para mais informações, consulte Ativar a navegação para o CarPlay.

Os motoristas que usam seu app querem um Mapa de visão geral para a maior parte da viagem, com apenas navegação guiada mínima para ruas da cidade.

Seu app precisa permitir que os motoristas entrem e saiam da experiência de navegação do Google conforme necessário, sem alternar as configurações do navegador para o destino e o modo de viagem.