Selecione a plataforma: Android iOS

Configurar interrupções em tempo real

Este produto ou recurso está em pré-lançamento (pré-GA). Os produtos e recursos em pré-GA têm suporte limitado, e é possível que as mudanças neles não sejam compatíveis com versões anteriores. Todos os itens em pré-GA são cobertos pelos Termos de Serviço da Plataforma Google Maps. Para mais detalhes, consulte as descrições da fase de lançamento.

As interrupções em tempo real são um conjunto de recursos que alertam os usuários sobre interrupções ao longo do trajeto e permitem que eles denunciem e verifiquem as interrupções encontradas. Exemplos de interrupções incluem acidentes de veículo, congestionamento, presença de polícia e radares de velocidade, obras, interdições de faixas e determinadas condições climáticas. Esta página explica os recursos de interrupção em tempo real e as opções de configuração deles, incluindo considerações para apps que usam interfaces de navegação personalizadas.

Observação:a disponibilidade de recursos de interrupção em tempo real e de tipos específicos de interrupção varia de acordo com a região. Para mais informações, consulte Cobertura de países e regiões do SDK Navigation. Além disso, as interrupções em tempo real não estão disponíveis no Android Auto.

Recursos de interrupção em tempo real

O SDK Navigation inclui os seguintes recursos de interrupção em tempo real como parte da experiência principal de navegação:

• Alertas interativos de interrupção ao longo das rotas.
• Alertas automáticos de interrupção com votação durante a navegação ativa.
• Denúncia de interrupções durante a navegação ativa.

Esses recursos são configuráveis e ativados por padrão. As seções a seguir fornecem mais informações sobre os recursos e as opções de configuração disponíveis.

Avisos interativos de interrupção ao longo das rotas

Quando um app mostra um trajeto, seja em uma visão geral ou durante a navegação ativa, as interrupções atuais aparecem como indicadores ao longo do trajeto. As frases de destaque incluem um ícone que indica o tipo de interrupção.

Você pode controlar a exibição de alertas de interrupção ao longo das rotas usando setTrafficPromptsEnabled, que também controla a exibição de alertas automáticos quando um usuário se aproxima de uma interrupção.

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

Observação:o setTrafficPromptsEnabled controla apenas a exibição de indicadores de problemas relatados pelos usuários. Alguns tipos de interrupções, como vias interditadas por autoridades de trânsito, ainda podem aparecer mesmo quando setTrafficPromptsEnabled está definido como false.

Mostrar detalhes da interrupção quando um usuário tocar em uma callout

Os usuários podem tocar em um destaque para mostrar um card de informações com mais detalhes sobre a interrupção, incluindo o tipo, a hora em que foi informada pela última vez e, em alguns casos, uma opção para votar se ela ainda está presente. Há dois tipos diferentes de cards de informações que podem aparecer, dependendo se o usuário está em navegação ativa. As opções de configuração variam para cada tipo.

Cards de informações de destaque nas visões gerais de rotas antes de iniciar a navegação ativa

Quando um usuário toca em uma indicação em uma visão geral da rota antes de iniciar a navegação ativa, um card de informações aparece com mais detalhes sobre a interrupção.

Você pode controlar a capacidade dos usuários de tocar em indicadores de interrupção nos resumos de rotas para mostrar mais informações usando setTrafficIncidentCardsEnabled.

// Using the SupportNavigationFragment
mNavFragment.setTrafficIncidentCardsEnabled(true);

// Using the NavigationView
navigationView.setTrafficIncidentCardsEnabled(true);

Cards de informações de destaque durante a navegação ativa

Quando um alerta de interrupção aparece em uma rota durante a navegação ativa, os usuários podem tocar nele para mostrar um card com mais informações sobre a interrupção, incluindo o tipo e a hora em que ela foi informada pela última vez, além de botões para votar se a interrupção ainda está presente. Os votos enviados pelos usuários são processados pelo Google e podem aparecer no mapa para outros usuários do Google Maps e do SDK Navigation, além de serem usados para determinar se a interrupção deve continuar sendo mostrada.

Você pode controlar a exibição e a capacidade de toque das indicações de interrupção durante a navegação ativa usando setTrafficPromptsEnabled , que também controla a exibição de indicações ao longo das rotas e a exibição de alertas automáticos quando um usuário se aproxima de uma interrupção.

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

Observação:o setTrafficPromptsEnabled controla apenas a exibição de indicadores de problemas relatados pelos usuários. Alguns tipos de interrupções, como vias interditadas por autoridades de trânsito, ainda podem aparecer mesmo quando setTrafficPromptsEnabled está definido como false.

Alertas automáticos de interrupção com votação durante a navegação ativa

Durante a navegação ativa, quando um usuário se aproxima de uma interrupção em um trajeto, uma solicitação aparece com informações sobre a interrupção e botões para votar se ela ainda está presente. Os votos enviados pelos usuários são processados pelo Google e podem aparecer no mapa para outros usuários do SDK do Google Maps e Navigation, além de serem usados para determinar se a interrupção deve continuar sendo mostrada.

É possível configurar a exibição de solicitações de alerta durante a navegação ativa usando setTrafficPromptsEnabled , que também controla a exibição de balões de texto ao longo das rotas.

// Using the SupportNavigationFragment
mNavFragment.setTrafficPromptsEnabled(true);

// Using the NavigationView
navigationView.setTrafficPromptsEnabled(true);

Observação:quando um usuário se aproxima de uma interrupção em um trajeto durante a navegação ativa, ela é anunciada com um alerta de áudio. Os alertas de áudio não são afetados pela configuração de exibição da solicitação. No entanto, é possível configurar todos os comandos de voz durante a navegação ativa usando AudioGuidance .

Relatório de interrupções durante a navegação ativa

Durante o modo de navegação ativa, um botão aparece na interface de navegação para que os usuários possam informar novas interrupções ao longo do trajeto. Quando um usuário toca no botão, um menu com os tipos de interrupção disponíveis para denúncia aparece. Os alertas enviados pelos usuários são processados pelo Google e podem aparecer no mapa para outros usuários do SDK Navigation e do Google Maps.

Observação:quando um usuário inicia a navegação ativa pela primeira vez, o botão de denúncia aparece em um estado expandido com o rótulo "Denunciar". O botão é recolhido para mostrar apenas o ícone.

Mostrar ou ocultar o botão de relatórios padrão

É possível configurar a visibilidade do botão de relatórios padrão durante a navegação ativa usando setReportIncidentButtonEnabled .

// Enables the incident reporting button to show in situations where incident
// reporting is possible.

// Using the SupportNavigationFragment
mNavFragment.setReportIncidentButtonEnabled(true);

// Using the NavigationView
navigationView.setReportIncidentButtonEnabled(true);

Adicionar um botão de geração de relatórios personalizados

Em vez do botão padrão de relatórios de interrupção, você pode adicionar um botão personalizado à interface de navegação. Quando o usuário clica no botão personalizado, você pode acionar a exibição do menu de relatórios chamando o método showReportIncidentsPanel. Antes de adicionar um botão de denúncia personalizada, verifique se o app está em navegação ativa e se o usuário está em um país onde a denúncia está ativada chamando isIncidentReportingAvailable. Se uma delas não for verdadeira, o menu de denúncia não vai aparecer.

Observação:se você estiver implementando um botão de denúncia personalizada, defina setReportIncidentButtonEnabled como false para ocultar o botão de denúncia padrão.

  Button customReportIncidentButton = findViewById(R.id.custom_reporting_button);
  
  // Check if reporting is available before displaying your button
  customReportIncidentButton.setVisibility(
      navigationView.isReportingAvailable ? View.VISIBLE : View.GONE);
  
  // Trigger the reporting flow if the button is clicked
  customReportIncidentButton.setOnClickListener(v ->
      navigationView.showReportIncidentsPanel());
  

Trabalhar com interfaces de navegação personalizadas

Se a implementação do SDK Navigation incluir elementos de interface personalizados, considere os elementos de interrupção em tempo real para evitar conflitos.

Observação:para mais informações sobre como trabalhar com elementos personalizados da interface, consulte Modificar a interface de navegação.

Posicionamento do botão de denúncia

Por padrão, o botão de denúncia de interrupção fica na parte de baixo/canto final do mapa, à direita para idiomas da esquerda para a direita e à esquerda para idiomas da direita para a esquerda. Se você precisar mover o botão de denúncia para abrir espaço para elementos de interface personalizados, adicione um controle personalizado BOTTOM_END_BELOW ou FOOTER, que vai mover a posição do botão para cima na tela. Colocar suas próprias UIs personalizadas nos controles personalizados também garante que todos os comandos mostrados pelo SDK Navigation sejam sobrepostos corretamente aos seus elementos de UI personalizados enquanto são exibidos. Se não for possível usar controles personalizados, use a API Prompt Visibility para gerenciar possíveis conflitos de interface.

Observação:o controle personalizado FOOTER afeta apenas a posição do botão de denúncia na orientação retrato.

API Prompt Visibility (experimental)

A API Prompt Visibility ajuda a evitar conflitos entre elementos de interface gerados pelo SDK Navigation e seus próprios elementos de interface personalizados. Para isso, ela adiciona um listener para receber um callback antes que um elemento de interface do SDK Navigation apareça e assim que ele for removido. Você pode receber callbacks para elementos de interrupção em tempo real, incluindo cards de informações, solicitações e o menu de denúncia de interrupções, além de outras notificações geradas pelo SDK Navigation.

// Sample listener
val listener: PromptVisibilityChangedListener = { isVisible ->
	if (isVisible) {
		customFab.visibility = false
		customFooter.visibility = false
		moveSomeOtherThingsAround()
	} else {
		customFab.visibility = true
		customFooter.visibility = true
		moveSomeThingsBackToWhereTheyWereBefore()
	}
}

// Inside onCreate()
navigationView.addPromptVisibilityChangedListener(listener)

// Inside onDestroy()
navigationView.removePromptVisibilityChangedListener(listener)