Navigations-API

öffentliche finale Klasse NavigationApi erweitert Objekt

Einstiegspunkt zur Navigation API Verwenden Sie die statischen Methoden für diese Klasse, um einen Verweis auf die Navigator zu erhalten.

Zusammenfassung für geschachtelte Klassen

@Interface NavigationApi.ErrorCode ErrorCode ist ein Statuscode, der von getNavigator(Activity, NavigatorListener) und getNavigator(Application, NavigatorListener) zurückgegeben wird, wenn Navigator nicht abgerufen werden konnte. 
Oberfläche NavigationApi.NavigatorListener Registriere einen NavigatorListener bei getNavigator(Activity, NavigatorListener), um über den Status der Navigator informiert zu werden. 
Oberfläche NavigationApi.OnTermsResponseListener Registrieren Sie einen OnTermsResponseListener mit showTermsAndConditionsDialog(Activity, String, OnTermsResponseListener), damit Sie benachrichtigt werden, wenn der Nutzer die Nutzungsbedingungen akzeptiert oder ablehnt. 

Public Method Summary

Statischer boolescher Wert
areTermsAccepted(Bewerbung)
Gibt true zurück, wenn der Nutzer zuvor die Nutzungsbedingungen von Google für die Navigation akzeptiert hat.
Static void
cleanup()
Entfernt den internen Status der NavSDK-Komponenten.
synchronisiert statisch ForegroundServiceManager
getForegroundServiceManager(Anwendungsanwendung)
Ruft die Singleton-Instanz ForegroundServiceManager ab.
Statischer String
getNavSDKVersion()
Gibt die aktuelle NavSDK-Version zurück.
Static void
getNavigator(Anwendungs-App, NavigationApi.NavigatorListener-Rückruf)
Ruft die Instanz Navigator ab.
Static void
getNavigator(Activity activity, NavigationApi.NavigatorListener-Callback, TermsAndConditionsCheckOption termsCheck)
Ruft die Instanz Navigator ab.
Static void
getNavigator(Activity activity, NavigationApi.NavigatorListener-Callback)
Gleichbedeutend mit getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED}.
Static void
getNavigatorNoToS(Anwendungsanwendung, NavigationApi.NavigatorListener-Callback)
Ruft die Instanz Navigator ab.
Statischer RoadSnappedLocationProvider
getRoadSnappedLocationProvider(Anwendung)
Ruft eine RoadSnappedLocationProvider-Instanz ab, mit der Nutzerstandorte mit einer bestimmten Straße abonniert werden können.
Statischer NavigationTransactionRecorder
getTransactionRecorder(Anwendungsanwendung)
Ruft eine Instanz des NavigationTransactionRecorder ab, mit der Transaktionen im Zusammenhang mit der Navigation aufgezeichnet werden können.
synchronisiert statische void
initForegroundServiceManager(Anwendungsanwendung, Ganzzahlbenachrichtigungs-ID, String defaultMessage, NotificationContentProvider-Anbieter)
Initialisiert die ForegroundServiceManager-Instanz mit den bereitgestellten Argumenten.
Static void
resetTermsAccepted(Bewerbung)
Nutzungsbedingungen zurücksetzen (zum Testen)
Static void
showTermsAndConditionsDialog(Aktivitätsaktivität, String companyName, String-Titel, NavigationApi.OnTermsResponseListener-Listener)
Zeigt ein Dialogfeld an, in dem der Nutzer aufgefordert wird, die Nutzungsbedingungen für die Navigation im standardmäßigen Design zu akzeptieren.
Static void
showTermsAndConditionsDialog(Activity activity, String companyName, String title, TermsAndConditionsUIParams uiParams, NavigationApi.OnTermsResponseListener-Listener, TermsAndConditionsCheckOption termsAndConditionsCheckOption)
Zeigt ein Dialogfeld an, in dem der Nutzer aufgefordert wird, die Google-Nutzungsbedingungen für die Navigation zu akzeptieren.
Static void
showTermsAndConditionsDialog(Activity activity, String companyName, NavigationApi.OnTermsResponseListener-Listener)
Zeigt ein Dialogfeld an, in dem der Nutzer aufgefordert wird, die Google-Nutzungsbedingungen für die Navigation zu akzeptieren. Dabei werden der Standardtitel und das Standarddesign verwendet.

Inherited Method Summary

Public Methods

public static boolesch areTermsAccepted (Anwendungsanwendung)

Gibt true zurück, wenn der Nutzer zuvor die Nutzungsbedingungen von Google für die Navigation akzeptiert hat.

Damit können Sie prüfen, ob der Bildschirm mit den Begriffen früher in der App angezeigt werden soll und nicht, wenn der Nutzer gerade an eine andere Stelle geht. Es kann beispielsweise sinnvoll sein, diesen Wert zu überprüfen, wenn in Ihrer App andere Nutzungsbedingungen angezeigt werden, damit der Nutzer alle erforderlichen Nutzungsbedingungen für die App in einer Aufgabe akzeptieren kann.

Parameter
Anwendungen die aktuelle Anwendung
Rückgaben
  • true, wenn die Bedingungen vom Nutzer akzeptiert wurden, ansonsten false

public static void Cleanup ()

Entfernt den internen Status der NavSDK-Komponenten. Wenn bereits eine Navigation vorhanden ist, wird die Navigation beendet und deaktiviert. Von diesem Navigator aus können keine weiteren Anweisungen gegeben werden. Rufen Sie diese Methode auf, um Arbeitsspeicher wiederherzustellen, wenn Ihre App den Navigator nicht mehr benötigt und alle Verweise auf den Navigator gelöscht wurden. Wenn für Ihre App nach diesem Aufruf ein Navigator erforderlich ist, können Sie mit getNavigator() einen neuen erstellen. Hinweis: Das Erstellen eines neuen Navigators dauert einige Zeit. Überlegen Sie, wie sich eine Verzögerung auf die Leistung Ihrer Anwendung im Vergleich zu den Vorteilen des wiederhergestellten Arbeitsspeichers auswirken würde.

public static synchronisiert ForegroundServiceManager getForegroundServiceManager (Anwendungsanwendung)

Ruft die Singleton-Instanz ForegroundServiceManager ab. Wenn initForegroundServiceManager(Application, Integer, String, NotificationContentProvider) nicht vor getForegroundServiceManager(Application) aufgerufen wird, werden eine Standardbenachrichtigungs-ID, Standardnachricht und Benachrichtigungsanbieter verwendet.

Parameter
Anwendungen die aktuelle Application

public static String getNavSDKVersion ()

Gibt die aktuelle NavSDK-Version zurück.

public static void getNavigator (Anwendungs-App, NavigationApi.NavigatorListener-Callback)

Ruft die Instanz Navigator ab.

Wenn der Nutzer den Nutzungsbedingungen noch nicht zugestimmt hat, wird der Callback sofort mit dem Fehlercode TERMS_NOT_ACCEPTED ausgelöst.

Der Navigator ist ein Singleton. Wenn Sie diese Methode mehrmals aufrufen, wird bei jedem Aufruf derselbe Navigator zurückgegeben.

Parameter
Anwendungen die aktuelle Application
callback Ein Callback, der ausgelöst wird, wenn Navigator bereit ist, oder wenn ein Fehler auftritt

public static void getNavigator (Activity activity, NavigationApi.NavigatorListener-Callback, TermsAndConditionsCheckOption termsCheck)

Ruft die Instanz Navigator ab.

Wenn der Nutzer den Nutzungsbedingungen noch nicht zugestimmt hat, wird in diesem Aufruf ein Dialogfeld angezeigt, in dem er zur Einhaltung der lokalen Vorschriften aufgefordert wird.

Wenn termsCheck den Wert ENABLED hat, enthält das Dialogfeld auch einen Link zu den Nutzungsbedingungen für das Navigation SDK. callback wird mit dem Fehler TERMS_NOT_ACCEPTED aufgerufen, wenn der Nutzer diese Bedingungen nicht akzeptiert.

Der Navigator ist ein Singleton. Wenn Sie diese Methode mehrmals aufrufen, wird bei jedem Aufruf derselbe Navigator zurückgegeben.

Parameter
Aktivität Activity, in dem das Dialogfeld mit den Nutzungsbedingungen angezeigt werden soll, sofern sie noch nicht akzeptiert wurden
callback Ein Callback, der ausgelöst wird, wenn Navigator bereit ist, oder wenn ein Fehler auftritt
termsCheck gibt an, ob die Prüfung der Nutzungsbedingungen übersprungen werden soll.

public static void getNavigator (Activity activity, NavigationApi.NavigatorListener-Callback)

Gleichbedeutend mit getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED}.

Parameter
Aktivität
callback
Weitere Informationen

public static void getNavigatorNoToS (Application App, NavigationApi.NavigatorListener Callback)

Ruft die Instanz Navigator ab.

Umgeht die Nutzungsbedingungen.

Der Navigator ist ein Singleton. Wenn Sie diese Methode mehrmals aufrufen, wird bei jedem Aufruf derselbe Navigator zurückgegeben.

Parameter
Anwendungen den aktuellen Application.
callback Ein Callback, der ausgelöst wird, wenn Navigator bereit ist oder ein Fehler auftritt.

public static RoadSnappedLocationProvider getRoadSnappedLocationProvider (Anwendungsanwendung)

Ruft eine RoadSnappedLocationProvider-Instanz ab, mit der Nutzerstandorte mit einer bestimmten Straße abonniert werden können. Beachte, dass das Abonnieren von Updates für den Standort, an denen die Straße angedockt ist, zu einer schnellen Akkuentladung oder einer unbeabsichtigten Erfassung von Nutzerstandortdaten führen kann, wenn die Funktion im Hintergrund ausgeführt wird.

Vor dem Aufruf dieser Methode muss ein Navigator abgerufen werden. Andernfalls wird null zurückgegeben.

Parameter
Anwendungen die aktuelle Application

public static NavigationTransactionRecorder getTransactionRecorder (Anwendungsanwendung)

Ruft eine Instanz des NavigationTransactionRecorder ab, mit der Transaktionen im Zusammenhang mit der Navigation aufgezeichnet werden können.

Diese Klasse sollte nur dann verwendet werden, wenn Ihr Unternehmen von Google pro Transaktion abgerechnet wird.

Vor dem Aufruf dieser Methode muss ein Navigator abgerufen werden. Andernfalls wird null zurückgegeben.

Parameter
Anwendungen die aktuelle Application

public static sync void initForegroundServiceManager (Anwendungsanwendung, Integer-Benachrichtigungs-ID, String defaultMessage, NotificationContentProvider-Anbieter)

Initialisiert die ForegroundServiceManager-Instanz mit den bereitgestellten Argumenten.

Dieser Parameter sollte nur aufgerufen werden, wenn Sie einen der Standardparameter ändern möchten. Andernfalls rufen Sie getForegroundServiceManager(Application) direkt auf. Diese Methode kann nur einmal aufgerufen werden und muss vor getForegroundServiceManager(Application) aufgerufen werden.

Parameter
Anwendungen die aktuelle Application
notificationId Benachrichtigungs-ID für die dauerhafte Benachrichtigung
defaultMessage Standardmeldung, die angezeigt wird, wenn provider nicht angegeben ist
Anbieter eine Implementierung von NotificationContentProvider

public static void resetTermsAccepted (Anwendungsanwendung)

Nutzungsbedingungen zurücksetzen (zum Testen) Fügen Sie vor allen Aufrufen von NavigationApi einen Aufruf hinzu, wenn Sie das Dialogfeld mit den Nutzungsbedingungen testen möchten.

Parameter
Anwendungen die aktuelle Anwendung

public static void showTermsAndConditionsDialog (Activity activity, String companyName, String title, NavigationApi.OnTermsResponseListener-Listener)

Zeigt ein Dialogfeld an, in dem der Nutzer aufgefordert wird, die Nutzungsbedingungen für die Navigation im standardmäßigen Design zu akzeptieren.

Parameter
Aktivität
companyName
title
Listener
Weitere Informationen

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

Zeigt ein Dialogfeld an, in dem der Nutzer aufgefordert wird, die Google-Nutzungsbedingungen für die Navigation zu akzeptieren. Wenn angegeben, wird der Listener im UI-Thread aufgerufen und gibt an, ob der Nutzer die Nutzungsbedingungen akzeptiert.

Hinweis: Das Dialogfeld wird auch dann angezeigt, wenn der Nutzer bereits zugestimmt hat. Dieser sollte nur aufgerufen werden, wenn areTermsAccepted(Application) den Wert false hat, da Nutzer die Annahme der Nutzungsbedingungen nicht zurücknehmen können.

Parameter
Aktivität Activity, auf dem das Dialogfeld angezeigt wird
companyName den Namen Ihres Unternehmens, der im Dialogfeld mit den Nutzungsbedingungen angezeigt wird
title Titel des Dialogfelds. Wenn null angegeben ist, verwendet das Dialogfeld den Standardtitel.
uiParams Die Parameter, mit denen das Design des Dialogfelds angepasst wird. Wenn null, wird das Standarddesign verwendet.
Listener Ein optionaler Callback, der ausgelöst wird, wenn der Nutzer die Nutzungsbedingungen akzeptiert oder ablehnt.
termsAndConditionsCheckOption Den TermsAndConditionsCheckOption, der Optionen zum Prüfen der Nutzungsbedingungen angibt

public static void showTermsAndConditionsDialog (Activity activity, String companyName, NavigationApi.OnTermsResponseListener-Listener)

Zeigt ein Dialogfeld an, in dem der Nutzer aufgefordert wird, die Google-Nutzungsbedingungen für die Navigation zu akzeptieren. Dabei werden der Standardtitel und das Standarddesign verwendet.

Parameter
Aktivität
companyName
Listener
Weitere Informationen