Navigatore

dell'interfaccia pubblica Navigator

Un singleton che fornisce metodi per controllare la navigazione.

Tutti i metodi sono sicuri per i thread, ad eccezione di setAudioGuidance e setHeadsUpNotificationEnabled che devono essere richiamati nel thread dell'interfaccia utente.

Riepilogo dei corsi nidificati

interfaccia	Navigator.ArrivalListener		Definisce le firme per i metodi che vengono richiamati quando il conducente arriva a una tappa.
@interface	Navigator.AudioGuidance		AudioGuidance è un insieme di flag utilizzati per specificare i tipi di avvisi audio e indicazioni da utilizzare durante la navigazione.
interfaccia	Navigator.RemainingTimeOrDistanceChangedListener		Definisce le firme per i metodi che vengono chiamati quando cambiano il tempo o la distanza rimanenti per la destinazione successiva.
interfaccia	Navigator.RouteChangedListener		Definisce le firme per i metodi che vengono richiamati quando cambia il percorso.
enum	Navigator.RouteStatus		Un RouteStatus è un codice di stato che rappresenta il risultato di un calcolo di percorso, a cui si accede tramite il futuro restituito da setDestination(Waypoint).

Riepilogo del metodo pubblico

astratto void	cleanup() Pulisce lo stato interno del navigatore.
astratto void	clearDestinations() Cancella tutte le destinazioni impostate in precedenza e rimuove dalla mappa i percorsi calcolati.
astratto void	clearLicensePlateRestrictionInfo() Vengono cancellate le informazioni sulla targa del conducente corrente.
astratto void	clearRemainingTimeOrDistanceChangedListener() Consente di cancellare il listener di modifiche al tempo o alla distanza rimanenti.
astratto Waypoint	continueToNextDestination() Rimuove la destinazione corrente.
astratto ListenableResultFuture<RouteInfo>	fetchRouteInfo(waypoint Waypoint, RoutingOptions routingOptions) Restituisce informazioni sul percorso in base a ciascun valore di RoutingOptions.RoutingStrategy.
astratto RouteSegment	getCurrentRouteSegment() Restituisce la tratta corrente del viaggio.
astratto TimeAndDistance	getCurrentTimeAndDistance() Restituisce il tempo e la distanza stimati dalla posizione corrente alla destinazione corrente.
astratto Elenco<RouteSegment>	getRouteSegments() Restituisce un elenco di tratti di percorso.
astratto Simulatore	getSimulator() Restituisce un oggetto Simulatore, da utilizzare durante il test.
abstract Elenco<TimeAndDistance>	getTimeAndDistanceList() Restituisce un elenco di orari e distanze corrispondenti a ciascuna destinazione nel percorso corrente, che rappresentano il tempo e la distanza stimati dalla posizione corrente a ogni destinazione.
astratto Elenco<LatLng>	getTraveledRoute() Restituisce il percorso percorso finora durante questa sessione di guida (dall'ultima chiamata a startGuidance()).
astratto booleano	isGuidanceRunning() Restituisce true se le indicazioni sono attualmente in esecuzione.
astratto void	setArrivalListener(Listener Navigator.ArrivalListener) Registra un listener per gli eventi di arrivo.
astratto void	setAudioGuidance(guida interna) Consente di impostare i tipi di guida audio (compresa la vibrazione) che vengono attivati.
astratto ListenableResultFuture<Navigator.RouteStatus>	setDestination(destinazione Waypoint, RoutingOptions routingOptions, DisplayOptions displayOptions) Imposta un'unica destinazione per la navigazione, sostituendo le destinazioni impostate in precedenza.
astratto ListenableResultFuture<Navigator.RouteStatus>	setDestination(destinazione Waypoint, opzioni RoutingOptions) Imposta un'unica destinazione per la navigazione, sostituendo le destinazioni impostate in precedenza.
astratto ListenableResultFuture<Navigator.RouteStatus>	setDestination(destinazione Waypoint) Imposta un'unica destinazione per la navigazione, sostituendo le destinazioni impostate in precedenza.
astratto ListenableResultFuture<Navigator.RouteStatus>	setDestinations(Elenco<Waypoint> destinazioni, RoutingOptions) Consente di impostare più destinazioni per la navigazione, sostituendo le destinazioni impostate in precedenza.
astratto ListenableResultFuture<Navigator.RouteStatus>	setDestinations(Elenco<Waypoint> destinazioni, RoutingOptions routingOptions, DisplayOptions displayOptions) Consente di impostare più destinazioni per la navigazione, sostituendo le destinazioni impostate in precedenza.
astratto ListenableResultFuture<Navigator.RouteStatus>	setDestinations(Elenco<Waypoint> destinazioni) Consente di impostare più destinazioni per la navigazione, sostituendo le destinazioni impostate in precedenza.
astratto void	setHeadsUpNotificationEnabled(booleano abilitato) Consente di impostare se mostrare o meno le notifiche in evidenza.
astratto void	setLicensePlateRestrictionInfo(int rawLicensePlateLastDigit, String LicensePlateCountryCode) Imposta le informazioni della targa del conducente corrente.
astratto void	setRemainingTimeOrDistanceChangedListener(int timeChangeThresholdSecond, int lengthChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener) Registra un listener per quando il tempo o la distanza rimanenti fino alla destinazione cambiano di una percentuale superiore a una soglia specificata.
astratto void	setRouteChangedListener(Listener Navigator.RouteChangedListener) Registra un listener per gli eventi di modifica della route.
astratto void	setSpeedingListener(SpeedingListener SpeedingListener) Registra un SpeedingListener per la percentuale oltre il limite di velocità raggiunto dal conducente.
astratto void	startGuidance(Intent resumeIntent) Uguale a startGuidance(), ma specifica un intent che può essere utilizzato per riprendere l'applicazione dalla notifica nella barra di stato del navigatore.
astratto void	startGuidance() Se è stata impostata una destinazione e ne è stato calcolato un percorso, avvia le indicazioni di navigazione passo passo per il percorso.
astratto void	stopGuidance() Interrompe le indicazioni di navigazione passo passo.

Metodi pubblici

Public abstract void cleanup ()

Pulisce lo stato interno del navigatore.

Nota: la chiamata a questo metodo annullerà tutte le richieste in attesa a setDestinations(List).

Public abstract void clearDestinations ()

Cancella tutte le destinazioni impostate in precedenza e rimuove dalla mappa i percorsi calcolati. Se la navigazione è in esecuzione, verrà interrotta automaticamente.

Public abstract void clearLicensePlateRestrictionInfo ()

Vengono cancellate le informazioni sulla targa del conducente corrente. Questo vale solo per le chiamate setDestination effettuate dopo l'impostazione di questo valore.

Public astratto void clearRemainingTimeOrDistanceChangedListener ()

Consente di cancellare il listener di modifiche al tempo o alla distanza rimanenti.

pubblico abstract Waypoint continueToNextDestination ()

Rimuove la destinazione corrente. Dopo questa chiamata, le indicazioni verranno indirizzate alla destinazione successiva e le informazioni sulla destinazione precedente non sono disponibili.

Ritorni

• la guida dei tappe sta ora dirigendo verso o è nulla se non sono rimasti altri tappe

Public abstract ListenableResultFuture<RouteInfo> fetchRouteInfo (waypoint e RoutingOptions routingOptions)

Restituisce informazioni sul percorso in base a ciascun valore di RoutingOptions.RoutingStrategy. RoutingOptions.RoutingStrategy viene ignorato poiché questo metodo restituisce le informazioni di routing per tutte le strategie di routing.

Nota: questo valore viene ricalcolato a ogni chiamata e potrebbe non corrispondere ai percorsi attualmente utilizzati dalla navigazione, poiché nel frattempo il traffico e altri fattori potrebbero essere stati aggiornati.

Parametri

waypoint	il Waypoint di destinazione per il percorso
routingOptions	le opzioni utilizzate per recuperare le informazioni sul percorso

Ritorni

• il futuro restituito

pubblico abstract RouteSegment getCurrentRouteSegment ()

Restituisce la tratta corrente del viaggio. La posizione di partenza di questo RouteSegment sarà la posizione nota più recente (battuta su strada) del dispositivo.

Ritorni

• un oggetto del segmento di percorso o null in assenza di un percorso attuale

pubblici abstract TimeAndDistance getCurrentTimeAndDistance ()

Restituisce il tempo e la distanza stimati dalla posizione corrente alla destinazione corrente.

Ritorni

• un oggetto di tempo e distanza, o null in assenza di un percorso attuale

Public abstract List<RouteSegment> getRouteSegments ()

Restituisce un elenco di tratti di percorso. La destinazione di ogni segmento restituito corrisponderà a una destinazione impostata dai setDestination(s).

Public abstract Simulator getSimulator ()

Restituisce un oggetto Simulatore, da utilizzare durante il test.

Public abstract List<TimeAndDistance> getTimeAndDistanceList ()

Restituisce un elenco di orari e distanze corrispondenti a ciascuna destinazione nel percorso corrente, che rappresentano il tempo e la distanza stimati dalla posizione corrente a ogni destinazione.

Public abstract List<LatLng> getTraveledRoute ()

Restituisce il percorso percorso finora durante questa sessione di guida (dall'ultima chiamata a startGuidance()). Il percorso registrato comprende le posizioni bloccate da una strada, così come verrebbero restituite da RoadSnappedLocationProvider, e semplifica la rimozione di punti ridondanti, ad esempio la conversione di punti colineari consecutivi in un unico segmento di linea.

pubblici astratto booleano isGuidanceRunning ()

Restituisce true se le indicazioni sono attualmente in esecuzione. Tieni presente che le indicazioni verranno eseguite solo dopo che è stata calcolata una route verso una destinazione e che startGuidance() è stato chiamato.

Public abstract void setArrivalListener (Navigator.ArrivalListener)

Registra un listener per gli eventi di arrivo. Esegue l'override di qualsiasi listener registrato in precedenza.

Nota: per evitare perdite di memoria, è necessario chiamare setNavArrivalListener(null) quando il listener non è più richiesto.

Parametri

listener	al listener di registrarsi. Può essere impostato su null per cancellare un listener registrato in precedenza.

pubblici abstract void setAudioGuidance (guida interna)

Consente di impostare i tipi di guida audio (compresa la vibrazione) che vengono attivati. Per impostazione predefinita, sono attive la vibrazione, le funzioni vocali e la voce tramite Bluetooth (se disponibile).

Questo metodo deve essere richiamato nel thread dell'interfaccia utente.

Parametri

guida	una combinazione di flag Navigator.AudioGuidance che specificano i tipi di indicazioni audio da attivare

Public abstract ListenableResultFuture<Navigator.RouteStatus> setDestination (destinazioneWaypoint, RoutingOptions routingOptions, DisplayOptions displayOptions)

Imposta un'unica destinazione per la navigazione, sostituendo le destinazioni impostate in precedenza. Il futuro restituito verrà impostato su OK se viene trovata una route dalla località dell'utente alla destinazione specificata.

Parametri

destinazione	la nuova destinazione da impostare
routingOptions	le opzioni che verranno utilizzate per generare il percorso
displayOptions	le opzioni che saranno utilizzate per visualizzare il percorso

Ritorni

• il futuro restituito

Tiri

NullPointerException	se la destinazione specificata è nulla

pubblici abstract ListenableResultFuture<Navigator.RouteStatus> setDestination (Destinazione Waypoint, opzioni RoutingOptions)

Imposta un'unica destinazione per la navigazione, sostituendo le destinazioni impostate in precedenza. Il futuro restituito verrà impostato su OK se viene trovata una route dalla località dell'utente alla destinazione specificata. Per visualizzare la route verrà utilizzato il valore DisplayOptions predefinito.

Parametri

destinazione	la nuova destinazione da impostare
opzioni	le opzioni che verranno utilizzate per generare il percorso

Ritorni

• il futuro restituito

Tiri

NullPointerException	se la destinazione specificata è nulla

Public abstract ListenableResultFuture<Navigator.RouteStatus> setDestination (Destinazione del percorso)

Imposta un'unica destinazione per la navigazione, sostituendo le destinazioni impostate in precedenza. Il futuro restituito verrà impostato su OK se viene trovata una route dalla località dell'utente alla destinazione specificata. Per trovare la route verrà usato il valore RoutingOptions predefinito, mentre per visualizzarlo verrà usato il valore DisplayOptions predefinito.

Parametri

destinazione	la nuova destinazione da impostare

Ritorni

• il futuro restituito

Tiri

NullPointerException	se la destinazione specificata è nulla

Public abstract ListenableResultFuture<Navigator.RouteStatus> setDestinations (Lista<Waypoint> destinazioni, RoutingOptions opzioni)

Consente di impostare più destinazioni per la navigazione, sostituendo le destinazioni impostate in precedenza. Il futuro restituito verrà impostato su OK se viene trovata una route dalla località dell'utente alla destinazione specificata. Per visualizzare la route verrà utilizzato il valore DisplayOptions predefinito.

Parametri

destinazioni	il nuovo elenco di destinazioni da impostare
opzioni	le opzioni che verranno utilizzate per generare il percorso

Ritorni

• il futuro restituito

Public abstract ListenableResultFuture<Navigator.RouteStatus> setDestinations (List<Waypoint> destinazioni, RoutingOptions routingOptions, DisplayOptions displayOptions)

Consente di impostare più destinazioni per la navigazione, sostituendo le destinazioni impostate in precedenza. Il futuro restituito verrà impostato su OK se viene trovata una route dalla località dell'utente alla destinazione specificata.

Parametri

destinazioni	il nuovo elenco di destinazioni da impostare
routingOptions	le opzioni che verranno utilizzate per generare il percorso
displayOptions	le opzioni che saranno utilizzate per visualizzare il percorso

Ritorni

• il futuro restituito

Public abstract ListenableResultFuture<Navigator.RouteStatus> setDestinations (Lista<Waypoint> destinazioni)

Consente di impostare più destinazioni per la navigazione, sostituendo le destinazioni impostate in precedenza. Il futuro restituito verrà impostato su OK se viene trovata una route dalla località dell'utente alla destinazione specificata. Per trovare la route verrà usato il valore RoutingOptions predefinito, mentre per visualizzarlo verrà usato il valore DisplayOptions predefinito.

Parametri

destinazioni	il nuovo elenco di destinazioni da impostare

Ritorni

• il futuro restituito

pubblici abstract void setHeadsUpNotificationEnabled (boolean enabled)

Consente di impostare se mostrare o meno le notifiche in evidenza. Per impostazione predefinita, la notifica è abilitata. Gli eventi di avviso sono eventi indicativi, come svolte e così via, che vengono visualizzati quando non è visibile una mappa.

Questo metodo deve essere richiamato nel thread dell'interfaccia utente.

Parametri

abilitata	un flag che indica se è necessario attivare le notifiche in evidenza

Public abstract void setLicensePlateRestrictionInfo (int rawLicensePlateLastDigit, String LicensePlateCountryCode)

Imposta le informazioni della targa del conducente corrente. Ciò ci consente di aggirare alcuni tipi di limitazioni stradali basate sul numero di targa. Questo vale solo per le chiamate setDestination effettuate dopo l'impostazione di questo valore. Idealmente, dovresti chiamarlo subito dopo aver ottenuto il navigatore.

Parametri

rawLicensePlateLastDigit	L'ultima cifra della targa (deve essere compresa tra 0 e 9).
licensePlateCountryCode	Al momento supportiamo l'Indonesia (ID) e il Brasile (BZ). Altri paesi potrebbero essere supportati in futuro. Sei libero di fornire in modo proattivo queste informazioni.

Public abstract void setRemainingTimeOrDistanceChangedListener (int timeChangeThresholdSECONDS, intthChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener)

Registra un listener per quando il tempo o la distanza rimanenti fino alla destinazione cambiano di una percentuale superiore a una soglia specificata. Esegue l'override di qualsiasi listener registrato in precedenza.

Il listener può essere richiamato in seguito, ad esempio, a un movimento dell'utente, a un cambiamento delle condizioni del traffico, a un cambiamento di percorso, a un cambio di destinazione o a quando il tempo e la distanza rimanenti diventano noti per la prima volta.

Nota: per evitare perdite di memoria, è necessario chiamare clearNavProgressionListener() quando il listener non è più richiesto.

Parametri

timeChangeThresholdSeconds	Se la variazione assoluta del tempo rimanente in secondi è maggiore o uguale a questo valore, viene chiamato il listener. Questa soglia non deve essere negativa.
distanceChangeThresholdMeters	Se la variazione assoluta della distanza rimanente in metri è maggiore o uguale a questo valore, viene chiamato il listener. Questa soglia non deve essere negativa.
listener	al listener di registrarsi. Non deve essere null.

pubblici abstract void setRouteChangedListener (Navigator.RouteChangedListener)

Registra un listener per gli eventi di modifica della route. Esegue l'override di qualsiasi listener registrato in precedenza.

Nota: per evitare perdite di memoria, è necessario chiamare setNavRouteChangeListener(null) quando il listener non è più richiesto.

Parametri

listener	al listener di registrarsi. Può essere impostato su null per cancellare un listener registrato in precedenza.

Public astratto void setSpeedingListener (SpeedingListener velocitàingListener)

Registra un SpeedingListener per la percentuale oltre il limite di velocità raggiunto dal conducente.

Se imposti un SpeedingListener null o non ne imposti uno, non riceverai alcun dato del feed per eccesso di velocità.

Parametri

speedingListener

pubblici abstract void startGuidance (Intent resumeIntent)

Uguale a startGuidance(), ma specifica un intent che può essere utilizzato per riprendere l'applicazione dalla notifica nella barra di stato del navigatore. Senza questo intent non è possibile riprendere l'applicazione dalla barra di stato.

Parametri

resumeIntent	l'intento di ripristinare l'applicazione. Nella maggior parte dei casi, il valore restituito da android.app.Activity#getIntent() sarà adatto.

Public abstract void startGuidance ()

Se è stata impostata una destinazione e ne è stato calcolato un percorso, avvia le indicazioni di navigazione passo passo per il percorso. Se una route non è stata ancora calcolata, le indicazioni passo passo verranno avviate.

Devi chiamare esplicitamente stopGuidance() per arrestare il servizio di navigazione. Il servizio di navigazione non si interromperà automaticamente all'arrivo. Se desideri interrompere il servizio di navigazione all'arrivo, devi chiamare stopGuidance() in NavArrivalListener.

Nota: questo metodo non modifica la posizione di Camera.

Public abstract void stopGuidance ()

Interrompe le indicazioni di navigazione passo passo.