Perguntas frequentes

Detalhes do produto

Problemas

Rede

Dados

Personalização da interface

Roteamento

Simulador

Fluxos de trabalho

Serviços de mobilidade

Detalhes do produto

Seu app precisa implementar uma caixa de diálogo com o aviso dos Termos de Serviço do SDK do Navigation que cada motorista precisa aceitar. Essa caixa de diálogo dá ao motorista a oportunidade de concordar com os Termos de Serviço. Um arquivo de texto com os termos é fornecido com o SDK Navigation.
No Android, use o método NavigationApi.showTermsAndConditionsDialog para mostrar a caixa de diálogo com os termos.
No iOS, chame GMSNavigationServices.showTermsAndConditionsDialogIfNeededWithCompanyName.
Todos os idiomas compatíveis com o Google Maps para dispositivos móveis estão automaticamente disponíveis para o SDK Navigation. Um dispositivo tem um idioma padrão do sistema, e um app não pode mudar essa configuração. No entanto, o app tem acesso a mais de 70 idiomas.

Sim. No Android, depois de iniciada, a LocationListener continua sendo executada em segundo plano. O app continua ajustando a posição à via e mantém a direção.

No iOS, para continuar recebendo atualizações de localização de posição e orientação em segundo plano, implemente o ajuste de rota e defina allowsBackgroundLocationUpdates como YES.

Sim. Quando uma rota é criada ou alterada, o RouteChangeListener fornece polilinhas.

Não, o SDK de navegação não exige que o Google Maps para dispositivos móveis esteja instalado no dispositivo.
Não, o SDK Navigation não oferece essa funcionalidade no momento.
Sim. A direção do trânsito está disponível e é mostrada por padrão.

Problemas

No Xcode 12, os apps não são compilados corretamente para o simulador. Como faço para resolver isso?

Para corrigir esse problema, abra as configurações de criação do seu projeto do Xcode e adicione arm64 a Excluded Architectures somente para versões do "simulador de iOS".

Se quiser mais informações, consulte a seguinte conversa do StackOverflow (em inglês).

O GMSMapView não carrega.

Se o GMSMapView não carregar:

  • Verifique se o NavSDK está ativado no console do Cloud.
  • Se o SDK Navigation estiver instalado, mas seu projeto não usar as APIs dele, remova-o do seu binário.

Rede

Como o SDK do Navigation lida com conectividade ruim?
O SDK Navigation faz o pré-armazenamento em cache do trajeto para cada viagem. As informações pré-armazenadas em cache incluem informações de trajeto para 15 a 20 minutos e alternativas de trajeto caso o motorista se desvie do trajeto. O SDK de navegação aproxima a posição usando o GPS e os sensores do dispositivo.
Há um modo off-line disponível?
Não, o SDK Navigation não oferece um modo off-line no momento. No entanto, ele fornece informações pré-armazenadas em cache para uma viagem.

Dados

Posso recuperar todas as paradas/destinos de uma viagem antes de iniciar o trajeto?

Sim. No Android, para recuperar as rotas de um trajeto, chame Navigator.getRouteSegments().

No iOS, chame GMSNavigator.routeLegs(read).

A navegação guiada está disponível no início de um trajeto?
Sim. O SDK Navigation fornece uma lista de segmentos de rota. Além disso, o motorista pode deslizar pelo card de rotas no cabeçalho para conferir cada manobra.
Como a ETA é comunicada aos usuários do app?

No Android, siga estas etapas para informar a ETA aos usuários do app:

  1. Recupere o tempo e a distância de todos os waypoints usando Navigator.getTimeAndDistanceList().
  2. Encaminhe essas informações para o aplicativo cliente, assim como faz com a ETA do motorista.

No iOS, siga estas etapas para fornecer informações de HEC aos usuários do app:

  1. Recupere os trechos da jornada usando Navigator.getRouteSegments().
  2. Chame GMSNavigator.timeToNextDestination para cada trecho da viagem.
  3. Encaminhe as informações de tempo para o aplicativo cliente, assim como faz com a ETA do motorista.
O RoadSnappedLocationProvider pode ser usado para obter o local atual do motorista se a navegação não estiver em primeiro plano?

Sim. No Android, o RoadSnappedLocationProvider é executado em segundo plano por padrão.

No iOS, para manter a navegação em segundo plano, implemente o listener para GMSRoadSnappedLocationProviderListener e defina a propriedade allowsBackgroundLocationUpdates como TRUE.

O SDK do Navigation oferece suporte à fronteira geográfica virtual?

Não. No contexto da navegação, remainingTimeOrdistanceChangeListener tem uma vantagem sobre uma fronteira geográfica virtual. O perímetro virtual pode não considerar a geometria da via e não estar centralizado no ponto exato para onde o motorista está navegando.

É possível aproximar essa funcionalidade usando remainingTimeOrdistanceChangeListener.

  1. Defina o limite para determinar a frequência dos callbacks.
  2. Confira a distância restante até o destino.

Por exemplo, se você definir o limite como 100 m, vai receber um callback quando a distância até o destino mudar em 100 m. À medida que a distância diminui, você pode atualizar esse limite para um valor menor e receber callbacks mais frequentes. Em seguida, verifique a distância restante para determinar se você está perto o suficiente do local de embarque/desembarque.

No iOS, implemente o listener GMSNavigatorListener.didUpdateRemainingDistance para gerenciar a distância entre as notificações.

Posso desativar as notificações quando o app de navegação estiver em segundo plano?

Sim. No Android, use Navigator.setHeadsUpNotificationEnabled para controlar as notificações. Esse método tem um argumento booleano. FALSE desativa as notificações; TRUE ativa as notificações.

No iOS, desative a notificação em segundo plano para locais ajustados à via definindo GMSRoadSnappedLocationProvider.allowsBackgroundLocationUpdates como NO.

Para desativar o processamento em segundo plano para outras notificações de localização, chame GMSNavigator.sendsBackgroundNotifications(NO).

Personalização da interface

Posso usar cores para indicar a melhor opção de trajeto?
Não. No momento, não é possível usar cores para destacar uma opção de trajeto específica.
O SDK Navigation pode mostrar a ETA do destino final?

Sim. No Android, use os seguintes métodos:

  1. Recupere o tempo e a distância para todos os pontos de parada usando Navigator.getTimeAndDistanceList().
  2. Oculte o HEC do ponto de passagem atual usando NavigationFragment.setEtaCardEnabled(false).
  3. Renderize a estimativa de chegada ao destino final.

No iOS, use o seguinte:

  1. Ligue para a GMSNavigator.routeLegs(read).
  2. Com o último trecho, chame GMSNavigator.timeToNextDestination.
  3. Oculte a ETA do ponto de parada atual usando MSMapView.settings.navigationFooterEnabled=NO como FALSE.
  4. Renderize a estimativa de chegada ao destino final.
Como faço para ocultar as atualizações de HEC?

É possível desativar os cards de ETA com os seguintes métodos:

  • No Android, use navigationView.setEtaCardEnabled(false).
  • No iOS, use GMSMapView.settings.navigationFooterEnabled=NO.
Quais personalizações de interface estão disponíveis para os cards de cabeçalho e rodapé?

No Android, use StylingOptions para definir o estilo da cor de plano de fundo. Para ocultar ou mostrar o cabeçalho e o rodapé, use as funções de membro setHeaderEnabled e setFooterEnabled de NavigationFragment.

No iOS, use GMSMapView.settings.navigationHeaderPrimaryBackgroundColor para definir o estilo da cor de fundo. Para ocultar ou mostrar o cabeçalho e o rodapé, use as propriedades navigationFooterEnabled e navigationHeaderEnabled de GMSUISettings.

Roteamento

Posso fornecer um trajeto específico a um motorista ou remover trajetos alternativos?
Não. Por padrão, várias rotas são fornecidas, e a mais rápida tem prioridade. Você pode afetar a rota padrão adicionando preferências, como "evitar rodovias e pedágios", à sua solicitação. Adicionar pontos de referência também afeta o trajeto.
Posso mostrar ao usuário do app um rótulo diferente para o destino do que o local de destino padrão?

Sim. No Android, crie um Marker com um título personalizado para o destino e a latitude/longitude. O SDK Navigation mostra o título personalizado e as coordenadas no NavigationMap.

No iOS, você cria e mostra um GMSMarker para o destino.

Posso usar o SDK do Navigation para rastrear desvios de um trajeto definido?

Sim. No Android, use Navigator.setRouteChangedListener para receber notificações quando um trajeto mudar ou um novo for recomendado:

  1. Registre um listener que verifique a posição do dispositivo ao longo do trajeto usando o método Navigator.setRouteChangedListener.
  2. Adicione código ao manipulador de eventos de callback, onRouteChanged:
    • Envie uma mensagem ao usuário do app com informações atualizadas sobre o HEC e a distância.
    • Rastrear a localização do dispositivo.
    • [opcional] Adicione outras funcionalidades necessárias para que o app lide com o motorista fora do trajeto prescrito.

No iOS, use o GMSNavigator e os listeners dele para receber notificações quando uma rota muda ou uma nova rota é recomendada:

  1. No controlador de visualizações do mapa, implemente os protocolos GMSNavigatorListener e GMSRoadSnappedLocationProviderListener.
  2. Implemente GMSNavigatorListener.navigatorDidChangeRoute.
  3. Acesse o novo trajeto usando as propriedades routeLegs e currentRouteLeg do GMSNavigator.
O motorista pode sair da navegação sem concluir o trajeto?

Sim. No Android, chame o método Navigator.stopGuidance() para parar a navegação.

No iOS, chame GMSNavigator.clearDestinations.

O SDK Navigation oferece suporte a rotas e navegação para caminhões e veículos grandes?

Sim. Com o LVR, é possível transmitir ao SDK Navigation tokens de rota específicos para caminhões gerados pelas APIs Routes ou Route Optimization. O SDK oferece navegação guiada com avisos de trajeto (altura, peso, materiais perigosos e restrições para caminhões) e mantém o perfil físico do veículo durante o traçado de novos trajetos dinâmicos. Para mais detalhes, consulte Navegar em rotas para veículos grandes.

Simulador

O simulador é compatível com mudanças de rota?

Sim. No Android, chame simulateLocationsAlongNewRoute para simular uma jornada que inclua uma mudança de rota. O método simulateLocationsAlongExistingRoute ignora as mudanças na rota atual.

No iOS, use GMSLocationSimulator.simulateAlongNewRouteToDestinations para simular uma viagem que inclua uma mudança de rota. Se você não prevê mudanças no percurso, use GMSLocationSimulator.simulateLocationsAlongExistingRoute ou GMSLocationSimulator.simulateAlongNewRouteToDestinations.

Fluxos de trabalho

Como dispensar a notificação depois de fechar uma atividade que contém um fragmento de navegação?

A notificação de navegação permanece visível durante a navegação, quando a atividade é fechada. Quando o veículo chega ao destino, a navegação é interrompida e a notificação desaparece.

Para processar cliques na notificação, use o Navigator.startGuidance(intent resumeIntent). O resume intent é acionado quando o usuário do app clica na notificação. Normalmente, o Navigator.startguidance(getIntent()) é chamado da atividade principal, que a recupera quando o usuário do app clica na notificação.

Serviços de mobilidade

Como o uso do SDK do Navigation é diferente para clientes dos Serviços de Mobilidade?

Os Serviços de mobilidade da Plataforma Google Maps oferecem uma coleção de APIs e SDKs para ajudar a atender às necessidades de transporte e logística das empresas. Para clientes dos Serviços de Mobilidade, o SDK do Navigation geralmente é usado em conjunto com serviços relacionados para otimização de rotas, despacho, planilha de controle de tarefas, análise de frotas e muito mais. O SDK do Navigation também é faturado de forma diferente para clientes dos Serviços de Mobilidade. Para mais informações, consulte a documentação dos Serviços de mobilidade.

Os produtos de mobilidade estão disponíveis apenas para alguns clientes. Entre em contato com seu representante de vendas para mais informações.

Como saber se sou um cliente dos Serviços de mobilidade?
Se você não tiver certeza se está implementando o SDK do Navigation como cliente dos Serviços de Mobilidade, procure uma chamada ReportBillableEvent no seu código. Somente os clientes dos Serviços de Mobilidade devem chamar o método ReportBillableEvent.

Como o SDK do Navigation é faturado para clientes de serviços de mobilidade?
Para clientes de serviços de mobilidade, o faturamento e os preços do SDK Navigation dependem do contrato de serviço que você tem com a Plataforma Google Maps. Para informações sobre como verificar se a implementação dos Serviços de mobilidade está sendo cobrada corretamente, consulte Validação de faturamento. Para mais informações sobre o faturamento dos Serviços de mobilidade, entre em contato com seu representante de vendas.

Quais APIs do SDK Navigation só podem ser usadas por clientes de serviços de mobilidade?

Há várias APIs no SDK Navigation destinadas apenas ao uso por clientes de Serviços de mobilidade, que são cobrados pelo Google por transação. Se você não for cliente dos Serviços de mobilidade, os seguintes métodos não farão nada:

Se eu for cliente dos Serviços de Mobilidade, também posso usar uma implementação do SDK de navegação que não seja dos Serviços de Mobilidade?

Sim, os clientes dos Serviços de Mobilidade podem usar as implementações do SDK de Navegação com e sem os Serviços de Mobilidade. No entanto, só é possível usar um tipo de implementação em um app por vez. Também é necessário criar um projeto do Google Cloud, uma conta de faturamento e uma chave de API novos, separados daqueles que você usa com a implementação dos Serviços de mobilidade. Para mais informações, consulte a visão geral da configuração do SDK do Navigation.

Para mais informações sobre como usar uma implementação do SDK Navigation que não seja dos Serviços de mobilidade, incluindo a migração de um app de um tipo de implementação para outro, entre em contato com o representante da sua Conta do Google.

Observação: se você não é cliente dos Serviços de Mobilidade e quer saber mais sobre o conjunto de APIs e SDKs, entre em contato com a equipe de vendas da Plataforma Google Maps.