NavigationView

classe pública NavigationView estende RelativeLayout

Uma visualização que exibe um mapa para navegação.

Os usuários dessa classe precisam encaminhar todos os métodos de ciclo de vida do Activity ou do Fragment que contêm essa visualização para os correspondentes na classe. Especificamente, você precisa encaminhar os seguintes métodos:

Se o NavView for adicionado depois que o Activity ou Fragment pai tiver passado pelo ciclo de vida de criação, você precisará chamar onCreate(Bundle), onStart() e onResume() manualmente para inicializá-lo corretamente. Da mesma forma, se uma NavView é removida da Activity ou Fragment mãe, é necessário chamar onPause(), onStop() e onDestroy() manualmente para evitar vazamentos.

Observação: recomendamos que você não adicione crianças a essa visualização.

Todas as chamadas para NavView precisam ser realizadas na linha de execução de IU.

Resumo de classes aninhadas

Interface NavigationView.OnNightModeChangedListener Interface para um listener que será notificado quando a interface entrar ou sair do "modo noturno". 
Interface NavigationView.OnRecenterButtonClickedListener Interface para um listener que será notificado quando o botão "Recentralizar" for clicado. 

Resumo da constante herdada

Resumo do campo herdado

Resumo do construtor público

NavigationView(contexto do contexto)
NavigationView(contexto de contexto, atributos do AttributeSet)
NavigationView(contexto de contexto, atributos AttributeSet, int defStyleAttr)

Resumo do método público

Câmera
getCamera()
Retorna um objeto camera que pode ser usado para alterar a janela de visualização do mapa.
NavigationMap
getMap()
Retorna um objeto que pode ser usado para adicionar conteúdo ao mapa.
void
onConfigurationChanged(configuração)
void
onCreate(pacote savedInstanceState)
void
onDestroy()
void
onPause()
void
onResume()
void
onSaveInstanceState(pacote outState)
void
onStart()
void
onStop()
void
onTrimMemory(int nível)
void
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)
Modifica o modo de exibição padrão para frases de destaque de ETA durante a navegação.
void
setCalloutInfoFormatOverride(RouteCalloutInfoFormat calloutInfoFormatOverride)
Define o modo de formato das informações da frase de destaque para frases de destaque de rota.
void
setCompassEnabled(booleano ativado)
Define se a bússola fica visível.
void
setCustomControl(controle de visualização, posição CustomControlPosition)
Define uma visualização de controle personalizada que aparece na posição especificada na interface de navegação.
void
setEtaCardEnabled(booleano ativado)
Define se o cartão HEC ficará visível durante a navegação.
void
setForceNightMode(int nightMode)
Define o ForceNightMode atual.
void
setHeaderEnabled(booleano ativado)
Define se o cabeçalho da navegação guiada ficará visível durante a navegação.
void
setOnNightModeChangedListener(listener NavigationView.OnNightModeChangedListener)
Define um listener que será notificado imediatamente sobre o estado atual do "modo noturno" e sempre que a interface entrar ou sair desse modo.
void
setOnRecenterButtonClickedListener(listener NavigationView.OnRecenterButtonClickedListener)
Define um listener que será notificado quando o botão "Recentralizar" for clicado.
void
setRecenterButtonEnabled(booleano ativado)
Define se o botão recentralizar deve ser exibido.
void
setSpeedAlertOptions(SpeedAlertOptions SpeedAlertOptions)
Define SpeedAlertOptions para personalizar os limites de acionamento para SpeedAlertSeveritys.
void
setSpeedLimitIconEnabled(booleano ativado)
Especifica se o ícone de limite de velocidade é mostrado.
void
setSpeedometerIconEnabled(booleano ativado)
Especifica se o ícone do velocímetro é mostrado.
void
setSpeedometerUiOptions(SpeedometerUiOptions speedometerUiOptions)
Define a configuração SpeedometerUiOptions da interface do velocímetro com base em SpeedAlertSeverity.
void
setStylingOptions(StylingOptions stylingOptions)
Define algumas opções de estilo para a interface de navegação.
void
setTrafficIncidentCardsEnabled(booleano ativado)
Define se os cartões de incidente de trânsito precisam ser mostrados quando o usuário clica em um ícone de incidente de trânsito.
void
setTrafficPromptsEnabled(booleano ativado)
Define se as solicitações de tráfego precisam ser mostradas.

Resumo do método herdado

Construtores públicos

public NavigationView (contexto do contexto)

Parâmetros
contexto

public NavigationView (contexto de contexto, atributos AttributeSet)

Parâmetros
contexto
attrs

public NavigationView (contexto de contexto, atributos AttributeSet, int defStyleAttr)

Parâmetros
contexto
attrs
defStyleAttr

Métodos públicos

public Câmera getCamera ()

Retorna um objeto camera que pode ser usado para alterar a janela de visualização do mapa. Esse método só precisa ser chamado na linha de execução de IU.

Retorna
  • o objeto Camera associado a essa visualização

public NavigationMap getMap ()

Retorna um objeto que pode ser usado para adicionar conteúdo ao mapa. Esse método só precisa ser chamado na linha de execução de IU.

public void onConfigurationChanged (Configuração de configuração)

Parâmetros
config

public void onCreate (Bundle savedInstanceState)

Parâmetros
savedInstanceState

public void onDestroy ()

public void onPause ()

public void onResume ()

public void onSaveInstanceState (Bundle outState)

Parâmetros
outState

public void onStart ()

public void onStop ()

public void onTrimMemory (int level)

Parâmetros
level

public void setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)

Modifica o modo de exibição padrão para frases de destaque de ETA durante a navegação. Transmitir nulo redefine o modo de exibição padrão.

Parâmetros
calloutInfoDisplayModeOverride para o novo modo de exibição desejado.

public void setCalloutInfoFormatOverride (RouteCalloutInfoFormat calloutInfoFormatOverride)

Define o modo de formato das informações da frase de destaque para frases de destaque de rota. Se esse método não for chamado, as frases de destaque vão seguir o comportamento definido por Route calloutInfoFormat.DEFAULT.

Parâmetros
calloutInfoFormatOverride para o novo formato desejado.

public void setCompassEnabled (boolean enabled)

Define se a bússola fica visível. Esse método só deve ser chamado na linha de execução de IU.

Parâmetros
ativado

public void setCustomControl (Controle de visualização, posição CustomControlPosition)

Define uma visualização de controle personalizada que aparece na posição especificada na interface de navegação. Se já houver algum controle personalizado na posição especificada, ele será substituído. Chamar esse método com um valor de controle nulo removerá o controle personalizado na posição especificada. Se o controle já tiver sido adicionado em uma posição diferente ou já tiver um pai, será ignorado. Esse método só deve ser chamado na linha de execução de IU.

Parâmetros
controle uma visualização que será posicionada na interface de navegação
posição determina onde o controle personalizado será colocado na interface em relação aos controles integrados.

public void setEtaCardEnabled (boolean enabled)

Define se o cartão HEC ficará visível durante a navegação. Esse método só precisa ser chamado na linha de execução de IU.

Parâmetros
ativado

public void setForceNightMode (int nightMode)

Define o ForceNightMode atual.

Parâmetros
nightMode

public void setHeaderEnabled (boolean enabled)

Define se o cabeçalho da navegação guiada ficará visível durante a navegação. Esse método só precisa ser chamado na linha de execução de IU.

Parâmetros
ativado

public void setOnNightModeChangedListener (NavigationView.OnNightModeChangedListener listener)

Define um listener que será notificado imediatamente sobre o estado atual do "modo noturno" e sempre que a interface entrar ou sair desse modo. Esse método só precisa ser chamado na linha de execução de IU.

Observação: para evitar vazamentos de memória, setOnNightModeChangedListener(null) precisa ser chamado quando o listener não for mais necessário.

Parâmetros
listener um listener que será notificado quando a interface entrar ou sair do modo noturno

public void setOnRecenterButtonClickedListener (NavigationView.OnRecenterButtonClickedListener listener)

Define um listener que será notificado quando o botão "Recentralizar" for clicado. Esse método só precisa ser chamado na linha de execução de IU.

Observação: para evitar vazamentos de memória, setOnRecenterButtonClickedListener(null) precisa ser chamado quando o listener não for mais necessário.

Parâmetros
listener um listener que será notificado quando o botão "Centralizar" for clicado.

public void setRecenterButtonEnabled (boolean enabled)

Define se o botão recentralizar deve ser exibido. Esse método só precisa ser chamado na linha de execução de IU.

Parâmetros
ativado

public void setSpeedAlertOptions (SpeedAlertOptions SpeedAlertOptions)

Define SpeedAlertOptions para personalizar os limites de acionamento para SpeedAlertSeveritys.

Você pode usar esse método para personalizar os limites de acionamento de alertas de velocidade em porcentagem para os alertas MINOR e MAJOR. Você também pode usar esse método para configurar o tempo em segundos necessário para fazer o upgrade dos alertas de velocidade de MINOR para MAJOR.

Quando um null SpeedAlertOptions é definido ou se nenhum valor é definido, o alerta de velocidade padrão do NavSDK é exibido. O alerta mostra texto vermelho em fundo branco/escuro para o modo dia/noite, respectivamente, quando a velocidade está abaixo de 5 mph ou 10 km/h acima do limite de velocidade, e mostra texto branco em fundo vermelho ao ultrapassar 8 km/h ou 10 km/h.

Parâmetros
speedAlertOptions

public void setSpeedLimitIconEnabled (boolean enabled)

Especifica se o ícone de limite de velocidade é mostrado. Chame esse método apenas na linha de execução de IU.

Quando ativado, um ícone de limite de velocidade que indica o limite de velocidade da via aparece no canto inicial de baixo durante a orientação. Ele só aparece em locais onde há dados confiáveis de limite de velocidade disponíveis. Quando o ícone do velocímetro está visível, ele é anexado.

Se o botão "Centralizar" estiver ativado, o ícone de limite de velocidade ficará temporariamente oculto quando o botão "Recentralizar" for exibido.

Observação: os motoristas precisam seguir todas as placas na via e usar o ícone de limite de velocidade apenas como referência. Não é possível garantir a precisão dos dados de limite de velocidade. Você pode informar imprecisões nos nossos dados de limite de velocidade registrando um caso no Google Cloud Support Portal.

Parâmetros
ativado
Ver também

public void setSpeedometerIconEnabled (boolean enabled)

Especifica se o ícone do velocímetro é mostrado. Chame esse método apenas na linha de execução de IU.

Quando ativado, um ícone de velocímetro que indica a velocidade do veículo aparece no canto inicial inferior durante a orientação. Quando o ícone de limite de velocidade está visível, ele é anexado. O velocímetro pode ter cores diferentes para o texto e o plano de fundo, dependendo da gravidade do limite.

Ativar o ícone de velocímetro também ativa o ícone de limite de velocidade. No entanto, você pode usar setSpeedLimitIconEnabled(boolean) para desativar/ativar o ícone de limite de velocidade separadamente.

Se o botão "Centralizar" estiver ativado, o ícone do velocímetro ficará temporariamente oculto quando o botão "Centralizar" for exibido.

Parâmetros
ativado
Ver também

public void setSpeedometerUiOptions (SpeedometerUiOptions SpeedometerUiOptions)

Define a configuração SpeedometerUiOptions da interface do velocímetro com base em SpeedAlertSeverity. Chame esse método apenas na linha de execução de IU.

Ao definir um null SpeedometerUiOptions, você limpa o anterior, se definido. Quando nenhum SpeedometerUiOptions está configurado, a interface do velocímetro usa as configurações padrão do NavSDK para alertas de velocidade de SpeedAlertSeverity diferentes:

  • Alerta de velocidade de MINOR no modo diurno: texto vermelho em fundo branco
  • Alerta de velocidade de MINOR no modo noturno: texto vermelho em fundo escuro
  • Alerta de velocidade de MAJOR no modo diurno: texto branco em fundo vermelho
  • Alerta de velocidade de MAJOR no modo noturno: texto branco em fundo vermelho

Parâmetros
speedometerUiOptions

public void setStylingOptions (StylingOptions stylingOptions)

Define algumas opções de estilo para a interface de navegação. Esse método só precisa ser chamado na linha de execução de IU.

Parâmetros
stylingOptions

public void setTrafficIncidentCardsEnabled (boolean enabled)

Define se os cartões de incidente de trânsito precisam ser mostrados quando o usuário clica em um ícone de incidente de trânsito. Esse método só deve ser chamado na linha de execução de IU.

Quando a navegação guiada está em execução, os detalhes dos incidentes de trânsito aparecem nos comandos. Para desativar os detalhes de incidentes de trânsito durante a navegação, use setTrafficPromptsEnabled(boolean).

Parâmetros
ativado
Ver também

public void setTrafficPromptsEnabled (boolean enabled)

Define se as solicitações de tráfego precisam ser mostradas. As solicitações de trânsito aparecem periodicamente para atualizar o usuário sobre as condições de trânsito durante a navegação. Esse método só precisa ser chamado na linha de execução de IU.

Parâmetros
ativado