Navigazione API

classe pubblica finale NavigationApi estendere Object

Punto di ingresso all'API Navigation. Utilizza i metodi statici in questa classe per ottenere un riferimento a Navigator.

Riepilogo dei corsi nidificati

@interface NavigationApi.ErrorCode Un ErrorCode è un codice di stato restituito da getNavigator(Activity, NavigatorListener) e getNavigator(Application, NavigatorListener) quando non è stato possibile ottenere correttamente un Navigator. 
interfaccia NavigationApi.NavigatorListener Registra un NavigatorListener con getNavigator(Activity, NavigatorListener) per ricevere notifica sullo stato di Navigator in questione. 
interfaccia NavigationApi.OnTermsResponseListener Registra un OnTermsResponseListener con showTermsAndConditionsDialog(Activity, String, OnTermsResponseListener) per ricevere una notifica quando l'utente accetta o rifiuta i Termini e condizioni. 

Riepilogo del metodo pubblico

statico booleano
areTermsAccepted(Richiesta di applicazione)
Restituisce true se l'utente ha precedentemente accettato i Termini e condizioni di navigazione di Google.
statico void
cleanup()
Pulisce lo stato interno dei componenti NavSDK.
sincronizzato statico ForegroundServiceManager
getForegroundServiceManager(applicazione dell'applicazione)
Consente di ottenere l'istanza singleton ForegroundServiceManager.
Stringa statica
getNavSDKVersion()
Restituisce la versione corrente di NavSDK.
statico void
getNavigator(Applicazione applicazione, callback NavigationApi.NavigatorListener)
Consente di ottenere l'istanza Navigator.
statico void
getNavigator(Attività di attività, callback NavigationApi.NavigatorListener, TermsAndConditionsCheckOption termsCheck)
Consente di ottenere l'istanza Navigator.
statico void
getNavigator(Attività di attività, callback NavigationApi.NavigatorListener)
Equivalente a getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED}.
statico void
getNavigatorNoToS(Applicazione applicazione, callback NavigationApi.NavigatorListener)
Consente di ottenere l'istanza Navigator.
statico RoadSnappedLocationProvider
getRoadSnappedLocationProvider(Applicazione di tipo applicazione)
Consente di ottenere un'istanza di RoadSnappedLocationProvider, che può essere utilizzata per abbonarsi alle posizioni degli utenti con blocchi su strada.
statico NavigationTransactionRecorder
getTransactionRecorder(Applicazione applicazione)
Consente di ottenere un'istanza di NavigationTransactionRecorder, che può essere utilizzata per registrare le transazioni relative alla navigazione.
sincronizzato statico void
initForegroundServiceManager(Applicazione applicazione, Integer notificationId, String defaultMessage, NotificationContentProvider provider)
Inizializza l'istanza ForegroundServiceManager con gli argomenti forniti.
statico void
resetTermsAccepted(Richiesta di applicazione)
Reimposta i termini e condizioni per i test.
statico void
showTermsAndConditionsDialog(Activity activity, String companyName, String title, NavigationApi.OnTermsResponseListener)
Mostra una finestra di dialogo che invita l'utente ad accettare i Termini e condizioni di navigazione di Google, utilizzando l'aspetto predefinito.
statico void
showTermsAndConditionsDialog(Activity activity, String companyName, String title, TermsAndConditionsUIParams uiParams, NavigationApi.OnTermsResponseListener, TermsAndConditionsCheckOption termsAndConditionsCheckOption)
Mostra una finestra di dialogo che invita l'utente ad accettare i Termini e condizioni di navigazione di Google.
statico void
showTermsAndConditionsDialog(Activity activity, String companyName, NavigationApi.OnTermsResponseListener)
Mostra una finestra di dialogo che invita l'utente ad accettare i Termini e condizioni di navigazione di Google, utilizzando il titolo e l'aspetto predefiniti.

Riepilogo del metodo ereditato

Metodi pubblici

pubblico statico booleano areTermsAccepted (Applicazione applicazione)

Restituisce true se l'utente ha precedentemente accettato i Termini e condizioni di navigazione di Google.

Puoi utilizzarlo per verificare se la schermata dei termini deve essere visualizzata prima nell'applicazione, anziché quando l'utente sta per navigare. Ad esempio, potrebbe essere appropriato controllare questo valore quando la tua app mostra altri termini e condizioni, in modo che l'utente possa accettare tutti i termini e le condizioni richiesti per l'app in un'unica attività.

Parametri
applicazioni ML l'applicazione corrente
Ritorni
  • true se i termini sono stati accettati dall'utente e false in caso contrario

pubblica statica void cleanup ()

Pulisce lo stato interno dei componenti NavSDK. Se esiste già una barra di navigazione, la guida viene interrotta e disattivata. In futuro non sarà possibile effettuare chiamate di guida con questo navigatore. Richiama questo metodo per recuperare memoria quando l'app non richiede più il navigatore e l'app ha eliminato tutti i riferimenti al navigatore. Se dopo questa chiamata la tua app richiede un navigatore, utilizza getNavigator() per crearne uno nuovo. Nota: la creazione di un nuovo navigatore richiede tempo; considera l'impatto di un ritardo sulle prestazioni dell'app rispetto ai vantaggi della memoria recuperata.

pubblico statico sincronizzato ForegroundServiceManager getForegroundServiceManager (applicazione applicazione)

Consente di ottenere l'istanza singleton ForegroundServiceManager. Se initForegroundServiceManager(Application, Integer, String, NotificationContentProvider) non viene chiamato prima del giorno getForegroundServiceManager(Application), verranno utilizzati un ID notifica predefinito, un messaggio e un provider di notifiche.

Parametri
applicazioni ML l'attuale Application

Public static Stringa getNavSDKVersion ()

Restituisce la versione corrente di NavSDK.

Public static void getNavigator (Applicazione applicazione, callback NavigationApi.NavigatorListener)

Consente di ottenere l'istanza Navigator.

Se l'utente non ha ancora accettato i termini e le condizioni, il callback viene attivato immediatamente con il codice di errore TERMS_NOT_ACCEPTED.

Tieni presente che il navigatore è un singleton; se chiami questo metodo più volte, ogni chiamata restituirà lo stesso navigatore.

Parametri
applicazioni ML l'attuale Application
callback un callback che verrà attivato quando Navigator è pronto oppure si verifica un errore

Public static void getNavigator (Attività attività, callback NavigationApi.NavigatorListener, TermsAndConditionsCheckOption termsCheck)

Consente di ottenere l'istanza Navigator.

Se l'utente non ha ancora accettato Termini e condizioni, in questa chiamata verrà mostrata una finestra di dialogo che esorta l'utente a rispettare le normative locali.

Se termsCheck è ENABLED, la finestra di dialogo conterrà anche un link ai Termini e condizioni dell'SDK di navigazione. callback verrà chiamato con un errore TERMS_NOT_ACCEPTED se l'utente non accetta questi termini.

Tieni presente che il navigatore è un singleton; se chiami questo metodo più volte, ogni chiamata restituirà lo stesso navigatore.

Parametri
attività Activity su cui mostrare la finestra di dialogo dei Termini e condizioni, se non sono ancora stati accettati
callback un callback che verrà attivato quando Navigator è pronto oppure si verifica un errore
termsCheck che indica se saltare il controllo dei Termini e condizioni

pubblici static void getNavigator (Attività attività, callback NavigationApi.NavigatorListener)

Equivalente a getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED}.

Parametri
attività
callback
Vedi anche

pubblici statico void getNavigatorNoToS (Applicazione applicazione, callback NavigationApi.NavigatorListener)

Consente di ottenere l'istanza Navigator.

Ignora i termini e le condizioni.

Tieni presente che il navigatore è un singleton; se chiami questo metodo più volte, ogni chiamata restituirà lo stesso navigatore.

Parametri
applicazioni ML l'attuale Application.
callback un callback che verrà attivato quando Navigator è pronto oppure si verifica un errore.

pubblico statico RoadSnappedLocationProvider getRoadSnappedLocationProvider (Applicazione applicazione)

Consente di ottenere un'istanza di RoadSnappedLocationProvider, che può essere utilizzata per abbonarsi alle posizioni degli utenti con blocchi su strada. Tieni presente che l'abbonamento agli aggiornamenti della posizione sincronizzati con l'utente può comportare il consumo della batteria o la raccolta involontaria di dati sulla posizione dell'utente, se lasciato in esecuzione in background.

Prima di chiamare questo metodo, è necessario ottenere correttamente un Navigator, altrimenti restituirà null.

Parametri
applicazioni ML l'attuale Application

Public static NavigationTransactionRecorder getTransactionRecorder (Applicazione applicazione)

Consente di ottenere un'istanza di NavigationTransactionRecorder, che può essere utilizzata per registrare le transazioni relative alla navigazione.

Questa classe deve essere utilizzata solo se e solo se la tua società riceve la fatturazione da Google in base alle singole transazioni.

Prima di chiamare questo metodo, è necessario ottenere correttamente un Navigator, altrimenti restituirà null.

Parametri
applicazioni ML l'attuale Application

pubblici statico sincronizzato void initForegroundServiceManager (applicazione dell'applicazione, numero intero notificationId, stringa defaultMessage, provider NotificationContentProvider)

Inizializza l'istanza ForegroundServiceManager con gli argomenti forniti.

Questa funzione deve essere richiamata solo se vuoi modificare i parametri predefiniti. In caso contrario, chiama getForegroundServiceManager(Application) direttamente. Questo metodo può essere chiamato una sola volta e deve essere chiamato prima del giorno getForegroundServiceManager(Application).

Parametri
applicazioni ML l'attuale Application
notificationId l'ID notifica per la notifica persistente
defaultMessage il messaggio predefinito da mostrare se provider non è specificato
provider un'implementazione di NotificationContentProvider

Public static void resetTermsAccepted (Applicazione applicazione)

Reimposta i termini e condizioni per i test. Aggiungi una chiamata prima di qualsiasi chiamata a NavigationApi se vuoi testare la finestra di dialogo di Termini e condizioni.

Parametri
applicazioni ML l'applicazione corrente

pubblici static void showTermsAndConditionsDialog (Activity activity, String companyName, String title, NavigationApi.OnTermsResponseListener)

Mostra una finestra di dialogo che invita l'utente ad accettare i Termini e condizioni di navigazione di Google, utilizzando l'aspetto predefinito.

Parametri
attività
companyName
title
listener
Vedi anche

pubblici static void showTermsAndConditionsDialog (Activity activity, String companyName, String title, TermsAndConditionsUIParams uiParams, NavigationApi.OnTermsResponseListener, TermsAndConditionsCheckOption termsAndConditionsCheckOption)

Mostra una finestra di dialogo che invita l'utente ad accettare i Termini e condizioni di navigazione di Google. Se specificato, il listener verrà chiamato nel thread dell'interfaccia utente, a indicare se l'utente accetta termini e condizioni.

Tieni presente che la finestra di dialogo verrà visualizzata anche se l'utente l'ha precedentemente accettata. Questo valore dovrebbe essere chiamato solo se areTermsAccepted(Application) è false, perché un utente non può annullare l'accettazione dei termini e condizioni.

Parametri
attività l'elemento Activity su cui verrà visualizzata la finestra di dialogo
companyName il nome della tua azienda, che sarà visualizzato nella finestra di dialogo di Termini e condizioni
title il titolo della finestra di dialogo. Se il valore è null, nella finestra di dialogo verrà utilizzato il titolo predefinito.
uiParams i parametri utilizzati per personalizzare l'aspetto della finestra di dialogo. Se null, viene utilizzato l'aspetto e il design predefiniti.
listener un callback facoltativo che viene attivato quando l'utente accetta o rifiuta i Termini e condizioni.
termsAndConditionsCheckOption TermsAndConditionsCheckOption, che specifica le opzioni per la verifica di termini e condizioni

Public static void showTermsAndConditionsDialog (Activity activity, String companyName, NavigationApi.OnTermsResponseListener)

Mostra una finestra di dialogo che invita l'utente ad accettare i Termini e condizioni di navigazione di Google, utilizzando il titolo e l'aspetto predefiniti.

Parametri
attività
companyName
listener
Vedi anche