A solução de viagens e entregas sob demanda está disponível apenas para parceiros selecionados. Entre em contato com a equipe de vendas para saber mais.

Esta página foi traduzida pela API Cloud Translation.

Navegador

interface pública Navigator

Um singleton que oferece métodos para controlar a navegação.

Todos os métodos são seguros para linha de execução, exceto setAudioGuidance e setHeadsUpNotificationEnabled, que precisam ser chamados na linha de execução de IU.

Resumo de classes aninhadas

Interface	Navigator.ArrivalListener	Define assinaturas para métodos que são chamados quando o motorista chega a um waypoint.
@interface	Navigator.AudioGuidance	O AudioGuidance é um conjunto de sinalizações usadas para especificar os tipos de alertas e orientação de áudio usados durante a navegação.
Interface	Navigator.RemainingTimeOrDistanceChangedListener	Define assinaturas para métodos que são chamados quando o tempo ou a distância restante até o próximo destino muda.
Interface	Navigator.RouteChangedListener	Define assinaturas para métodos que são chamados quando a rota muda.
enum	Navigator.RouteStatus	Um RouteStatus é um código de status que representa o resultado de um cálculo de trajeto, acessado pelo Future retornado por `setDestination(Waypoint)`.

Resumo do método público

abstrato nulo	cleanup() Limpa o estado interno do Navigator.
abstrato nulo	clearDestinations() Limpa todos os destinos definidos anteriormente e remove os trajetos calculados do mapa.
abstrato nulo	clearLicensePlateRestrictionInfo() Limpa informações sobre a placa do motorista atual.
abstrato nulo	clearRemainingTimeOrDistanceChangedListener() Limpa o listener para mudanças no tempo ou distância restante.
Waypoint abstrato	continueToNextDestination() Remove o destino atual.
abstrato ListenableResultFuture<RouteInfo>	fetchRouteInfo(Ponto de referência de waypoint, RoutingOptions routesOptions) Retorna informações de trajetos com base em cada valor de `RoutingOptions.RoutingStrategy`.
abstrato RouteSegment	getCurrentRouteSegment() Retorna o trecho atual da jornada.
abstrato TimeAndDistance	getCurrentTimeAndDistance() Retorna o tempo e a distância estimados da posição atual até o destino atual.
abstrato List<RouteSegment>	getRouteSegments() Retorna uma lista de segmentos de rota.
abstrato Simulador	getSimulator() Retorna um objeto do Simulator para uso durante o teste.
abstrato List<TimeAndDistance>	getTimeAndDistanceList() Retorna uma lista de tempos e distâncias correspondentes a cada destino no trajeto atual, representando o tempo e a distância estimados da posição atual até cada destino.
abstrato List<LatLng>	getTraveledRoute() Retorna o trajeto percorrido até o momento durante essa sessão de orientação (desde a última chamada para `startGuidance()`).
booleano abstrato	isGuidanceRunning() Retorna `true` se a orientação estiver em execução no momento.
abstrato nulo	setArrivalListener(listener Navigator.ArrivalListener) Registra um listener para eventos de chegada.
abstrato nulo	setAudioGuidance(int statement) Define quais tipos de orientação por áudio (incluindo vibração) são ativados.
abstrato ListenableResultFuture<Navigator.RouteStatus>	setDestination(destino de Waypoint, RoutingOptions roteamentoOptions, DisplayOptions displayOptions) Define um único destino para a navegação, substituindo os destinos definidos anteriormente.
abstrato ListenableResultFuture<Navigator.RouteStatus>	setDestination(destino de Waypoint, opções de RoutingOptions) Define um único destino para a navegação, substituindo os destinos definidos anteriormente.
abstrato ListenableResultFuture<Navigator.RouteStatus>	setDestination(destino de Waypoint) Define um único destino para a navegação, substituindo os destinos definidos anteriormente.
abstrato ListenableResultFuture<Navigator.RouteStatus>	setDestinations(Destinos de List<Waypoint>, opções de RoutingOptions) Define vários destinos para a navegação, substituindo os destinos definidos anteriormente.
abstrato ListenableResultFuture<Navigator.RouteStatus>	setDestinations(List<Waypoint> destinos, RoutingOptions roteamentoOptions, DisplayOptions displayOptions) Define vários destinos para a navegação, substituindo os destinos definidos anteriormente.
abstrato ListenableResultFuture<Navigator.RouteStatus>	setDestinations(List<Waypoint>) Define vários destinos para a navegação, substituindo os destinos definidos anteriormente.
abstrato nulo	setHeadsUpNotificationEnabled(booleano ativado) Define se as notificações de alerta devem ser exibidas.
abstrato nulo	setLicensePlateRestrictionInfo(int brutoLicensePlateLastDigit, String LicensePlateCountryCode) Define as informações da placa do motorista atual.
abstrato nulo	setRemainingTimeOrDistanceChangedListener(int timeChangeThresholdSeconds, int distanceChangeThresholdMeters, listener Navigator.RemainingTimeOrDistanceChangedListener) Registra um listener para quando o tempo ou a distância restante até o destino mudam mais do que um limite especificado.
abstrato nulo	setRouteChangedListener(listener Navigator.RouteChangedListener) Registra um listener para eventos de alteração de rota.
abstrato nulo	setSpeedingListener(SpeedingListener speedingListener) Registra um `SpeedingListener` para a porcentagem acima do limite de velocidade que o motorista está dirigindo.
abstrato nulo	startGuidance(Intent resumeIntent) É igual a `startGuidance()`, mas especificando uma intent que possa ser usada para retomar o app a partir da notificação da barra de status do navegador.
abstrato nulo	startGuidance() Se um destino tiver sido definido e um trajeto tiver sido calculado para ele, vai ser iniciada a orientação de navegação guiada para o trajeto.
abstrato nulo	stopGuidance() Interrompe a orientação de navegação guiada.

Métodos públicos

public abstrato void cleanup ()

Limpa o estado interno do Navigator.

Observação: chamar esse método cancelará todas as solicitações pendentes para setDestinations(List).

public abstrato void clearDestinations ()

Limpa todos os destinos definidos anteriormente e remove os trajetos calculados do mapa. Se a navegação estiver em execução, ela será interrompida automaticamente.

public abstrato void clearLicensePlateRestrictionInfo ()

Limpa informações sobre a placa do motorista atual. Isso só se aplica a chamadas setDestination feitas depois que esse valor é definido.

public void clearRemainingTimeOrDistanceChangedListener ()

Limpa o listener para mudanças no tempo ou distância restante.

public abstrato Waypoint continueToNextDestination ()

Remove o destino atual. Após a chamada, a orientação será para o próximo destino, e as informações sobre o destino antigo não estarão disponíveis.

Retorna

a orientação do waypoint está indo para o qual está indo ou "null" se não houver mais waypoints restantes

public ListenableResultFuture<RouteInfo> fetchRouteInfo (waypoint waypoint, RoutingOptions routesOptions)

Retorna informações de trajetos com base em cada valor de RoutingOptions.RoutingStrategy. RoutingOptions.RoutingStrategy é ignorado, porque esse método retorna as informações de rota para todas as estratégias de roteamento.

Observação: esses dados são recalculados em cada chamada e podem não corresponder aos trajetos atualmente usados pela navegação, já que o trânsito e outros fatores podem ter sido atualizados.

Parâmetros

waypoint	o waypoint de destino do trajeto.
routingOptions	as opções usadas para buscar as informações da rota

Retorna

o futuro retornado

public abstrato RouteSegment getCurrentRouteSegment ()

Retorna o trecho atual da jornada. O RouteSegmento terá a posição inicial como a posição mais recente conhecida (rotacionada) do dispositivo.

Retorna

um objeto de trecho de trajeto ou null se não houver um trajeto

public abstrato TimeAndDistance getCurrentTimeAndDistance ()

Retorna o tempo e a distância estimados da posição atual até o destino atual.

Retorna

um objeto de tempo e distância ou null se não houver um trajeto atual

public abstrato List<RouteSegment> getRouteSegments ()

Retorna uma lista de segmentos de rota. O destino de cada segmento retornado corresponderá a um destino definido por setDestination(s).

public abstrato Simulador getSimulator ()

Retorna um objeto do Simulator para uso durante o teste.

public abstrato List<TimeAndDistance> getTimeAndDistanceList ()

Retorna uma lista de tempos e distâncias correspondentes a cada destino no trajeto atual, representando o tempo e a distância estimados da posição atual até cada destino.

public abstrato List<LatLng> getTraveledRoute ()

Retorna o trajeto percorrido até o momento durante essa sessão de orientação (desde a última chamada para startGuidance()). O trajeto registrado consiste nos locais posicionados na via, como seriam retornados por RoadSnappedLocationProvider, e simplificado para remover pontos redundantes, por exemplo, transformando pontos colineares consecutivos em um único segmento de linha.

public abstrato booleano isGuidanceRunning ()

Retorna true se a orientação estiver em execução no momento. A orientação só será executada quando um trajeto até um destino for calculado e startGuidance() tiver sido chamado.

public abstrato void setArrivalListener (listener Navigator.ArrivalListener)

Registra um listener para eventos de chegada. Substitui qualquer listener registrado anteriormente.

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

Parâmetros

listener	que o listener seja registrado. Pode ser definido como `null` para limpar um listener registrado anteriormente.

public abstrato void setAudioGuidance (int Guidelines)

Define quais tipos de orientação por áudio (incluindo vibração) são ativados. Por padrão, a vibração, a voz e a voz sobre Bluetooth (se disponível) estão ativadas.

Esse método precisa ser chamado na linha de execução de interface.

Parâmetros

Orientação	Uma combinação de sinalizações `Navigator.AudioGuidance` especificando quais tipos de orientação por áudio precisam ser ativadas.

public Revism ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint destino, RoutingOptions routesOptions, DisplayOptions displayOptions)

Parâmetros

destination	o novo destino a ser definido
routingOptions	as opções que serão usadas para gerar o caminho
displayOptions	as opções que serão usadas para exibir o trajeto

Retorna

o futuro retornado

Gera

NullPointerException	se o destino especificado for nulo.

public ListenableResultFuture<Navigator.RouteStatus> setDestination (destino Waypoint, RoutingOptions opções)

Define um único destino para a navegação, substituindo os destinos definidos anteriormente. O futuro retornado vai ser definido como OK se um trajeto for encontrado do local do usuário até o destino especificado. O DisplayOptions padrão é usado para exibir a rota.

Parâmetros

destination	o novo destino a ser definido
opções	as opções que serão usadas para gerar o caminho

Retorna

o futuro retornado

Gera

NullPointerException	se o destino especificado for nulo.

public abstrato ListenableResultFuture<Navigator.RouteStatus> setDestination (destino do Waypoint)

Define um único destino para a navegação, substituindo os destinos definidos anteriormente. O futuro retornado vai ser definido como OK se um trajeto for encontrado do local do usuário até o destino especificado. O RoutingOptions padrão é usado para encontrar a rota, e o DisplayOptions padrão é usado para exibi-la.

Parâmetros

destination	o novo destino a ser definido

Retorna

o futuro retornado

Gera

NullPointerException	se o destino especificado for nulo.

public ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Waypoint> destinos, RoutingOptions opções)

Define vários destinos para a navegação, substituindo os destinos definidos anteriormente. O futuro retornado vai ser definido como OK se um trajeto for encontrado do local do usuário até o destino especificado. O DisplayOptions padrão é usado para exibir a rota.

Parâmetros

destinos	a nova lista de destino a ser definida
opções	as opções que serão usadas para gerar o caminho

Retorna

o futuro retornado

public mais mais mais ListenableResultFuture<Navigator.RouteStatus> ? ; setDestinations (List<Waypoint> destinos, RoutingOptions routesOptions, DisplayOptions displayOptions)

Parâmetros

destinos	a nova lista de destino a ser definida
routingOptions	as opções que serão usadas para gerar o caminho
displayOptions	as opções que serão usadas para exibir o trajeto

Retorna

o futuro retornado

public ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Waypoint> destinos)

Define vários destinos para a navegação, substituindo os destinos definidos anteriormente. O futuro retornado vai ser definido como OK se um trajeto for encontrado do local do usuário até o destino especificado. O RoutingOptions padrão é usado para encontrar a rota, e o DisplayOptions padrão é usado para exibi-la.

Parâmetros

destinos	a nova lista de destino a ser definida

Retorna

o futuro retornado

public abstrato void setHeadsUpNotificationEnabled (boolean enabled)

Define se as notificações de alerta devem ser exibidas. A notificação fica ativada por padrão. Os eventos de alerta são eventos de orientação, como curvas etc., que aparecem quando não há um mapa visível.

Esse método precisa ser chamado na linha de execução de interface.

Parâmetros

ativado	uma sinalização para indicar se as notificações de alerta devem ser ativadas

public abstrato void setLicensePlateRestrictionInfo (int brutoLicensePlateLastDigit, String LicensePlateCountryCode)

Define as informações da placa do motorista atual. Isso nos permite contornar certos tipos de restrições nas vias que são baseadas no número da placa do veículo. Isso só se aplica a chamadas setDestination feitas depois que esse valor é definido. O ideal é chamar isso imediatamente depois de usar o navegador.

Parâmetros

rawLicensePlateLastDigit	O último dígito da placa do veículo (precisa estar entre 0 e 9).
licensePlateCountryCode	No momento, o recurso está disponível na Indonésia (ID) e no Brasil (BZ), e você pode enviar essas informações de maneira proativa.

public [[set dessasTimeOrDistanceChangedListener] (int timeChangeThresholdSeconds, int distanceChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener))

Registra um listener para quando o tempo ou a distância restante até o destino mudam mais do que um limite especificado. Substitui qualquer listener registrado anteriormente.

O listener pode ser chamado como resultado do movimento do usuário, mudança nas condições de trânsito, mudança no trajeto, no destino ou quando o tempo e a distância restantes são conhecidos pela primeira vez.

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

Parâmetros

timeChangeThresholdSeconds	Se a mudança absoluta no tempo restante em segundos for maior ou igual a esse valor, o listener será chamado. Esse limite não pode ser negativo.
distanceChangeThresholdMeters	Se a mudança absoluta na distância restante em metros for maior ou igual a esse valor, o listener será chamado. Esse limite não pode ser negativo.
listener	que o listener seja registrado. Não pode ser `null`.

public abstrato void setRouteChangedListener (listener Navigator.RouteChangedListener)

Registra um listener para eventos de alteração de rota. Substitui qualquer listener registrado anteriormente.

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

Parâmetros

listener	que o listener seja registrado. Pode ser definido como `null` para limpar um listener registrado anteriormente.

public void setSpeedingListener (SpeedingListener speedingListener)

Registra um SpeedingListener para a porcentagem acima do limite de velocidade que o motorista está dirigindo.

Se você definir um SpeedingListener de null ou não definir nenhuma, você não receberá dados do feed sobre velocidade.

Parâmetros

speedingListener

public abstrato void startGuidance (Intent resumeIntent)

É igual a startGuidance(), mas especificando uma intent que possa ser usada para retomar o app a partir da notificação da barra de status do navegador. Sem esse intent, não é possível retomar o aplicativo pela barra de status.

Parâmetros

resumeIntent	a intenção de retomar o aplicativo. Na maioria dos casos, o valor retornado por `android.app.Activity#getIntent()` será adequado.

public abstrato void startGuidance ()

Se um destino tiver sido definido e um trajeto tiver sido calculado para ele, vai ser iniciada a orientação de navegação guiada para o trajeto. Se um trajeto ainda não tiver sido calculado, a orientação guiada será iniciada.

Você precisa chamar stopGuidance() explicitamente para interromper o serviço de navegação. O serviço de navegação não será interrompido automaticamente na chegada. Se você quiser interromper o serviço de navegação na chegada, será necessário chamar stopGuidance() no NavArrivalListener.

Observação: esse método não muda a posição do Camera.

public abstrato void stopGuidance ()

Interrompe a orientação de navegação guiada.