GMSNavigationServices-Klassenreferenz


Überblick

Dienste zur Steuerung des mobilen Zugriffs auf das Google Maps Navigation SDK for iOS.

Statische öffentliche Mitgliederfunktionen

(BOOL) + areTermsAndConditionsAccepted
 Gibt für Versionen ab 5.5.0 an, ob die Nutzungsbedingungen vom Nutzer anerkannt wurden.
(void) + showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback:
 Zeigt ein modales Dialogfeld an, wenn der App-Nutzer die Nutzungsbedingungen des Navigation SDK noch nicht akzeptiert hat.
(void) + showTermsAndConditionsDialogIfNeededWithTitle:companyName:callback:
 Das Dialogfeld mit den Nutzungsbedingungen wird im Standarddesign angezeigt.
(void) + showTermsAndConditionsDialogIf NeededWithCompanyName:Callback:
 Das Dialogfeld mit den Nutzungsbedingungen wird im Standardtitel und -design angezeigt.
(void) + resetTermsAndConditionsAccepted
 Setzt die Nutzungsbedingungen auf den Status „Nicht akzeptiert“ zurück.
(void) + setAbnormalTerminationReportingEnabled:
 Ermöglicht die Berichterstellung zu ungewöhnlichen SDK-Beendigungen, z. B. wenn die App abstürzt, während das SDK noch ausgeführt wird.
(GMSNavigationSession* kann Nullwerte enthalten)+ createNavigationSession
 Erstellt eine neue Navigationssitzung, die keiner Kartenansicht zugeordnet ist.
(NSString *)+ openSourceLicenseInfo
 Gibt die Open-Source-Softwarelizenzinformationen für das Google Navigation SDK for iOS zurück.
(NSString *)+ navSDKVersion
 Gibt die Version für diesen Release des Navigation SDK for iOS zurück.

Eigenschaften

BOOLshouldOnlyShowDriverAwarenesssDisclaimer
 Gibt an, ob in showTermsAndConditionsDialogIfNeededWithCompanyName:callback: nur der Haftungsausschluss für das Fahrerbewusstsein angezeigt werden soll.

(Beachten Sie, dass dies keine Elementfunktionen sind.)

typedef void(^ GMSTermsResponseCallback (BOOL-Bedingungen akzeptiert)
 Wird aufgerufen, wenn der Nutzer die Nutzungsbedingungen akzeptiert oder ablehnt

Dokumentation zu Mitgliederfunktionen

Gibt für Versionen ab 5.5.0 an, ob die Nutzungsbedingungen vom Nutzer anerkannt wurden.

Gibt bei früheren Versionen an, ob die Nutzungsbedingungen vom Nutzer akzeptiert wurden.

Bei „false“ deaktivieren die Dienste den Zugriff auf Navigationsoberflächen.

+ (void) showTermsAndConditionsDialogIfNeededWithTitle: (nullable NSString *)  title
Firmenname: (NSString *) companyName
UIParams: (GMSNavigationTermsDialogUIParams dürfen keine Nullwerte enthalten.*) UIParams
Callback: (GMSTermsResponseCallback) Rückruf

Zeigt ein modales Dialogfeld an, wenn der App-Nutzer die Nutzungsbedingungen des Navigation SDK noch nicht akzeptiert hat.

Der Callback wird mit der Antwort des Nutzers an die Hauptwarteschlange gesendet.

Wenn der Nutzer die Nutzungsbedingungen bereits akzeptiert hat, wird kein Dialogfeld angezeigt und der Callback enthält termsAccepted = YES.

Legen Sie den Parameter companyName auf Ihr Unternehmen fest. Der Name des Unternehmens erscheint im Text der Nutzungsbedingungen. In dem Text wird App-Nutzern erläutert, dass Standortdaten an dieses Unternehmen weitergegeben werden können, um die Abläufe zu verbessern.

Rufen Sie diese Methode aus dem Hauptthread auf. Mehrere Aufrufe, ohne auf eine Antwort zu warten, haben keine Auswirkungen.

Parameter:
TitelTitel des Dialogfelds. Wenn title „null“ ist, wird im Dialogfeld der Standardtitel verwendet.
Hinweis:
Bei benutzerdefinierten Titeln muss der Aufrufer dieser Methode diesen Parameter lokalisieren. Der Standardtitel wird von den Diensten automatisch lokalisiert.
Parameter:
companyNameName des Unternehmens, das die App veröffentlicht, und in der Vereinbarung mit Google über die Weitergabe von Standortdaten.
UIParamsParameter, die das Design des Dialogfelds definieren. Wenn „nil“ (null) festgelegt ist, verwendet das Dialogfeld das Standarddesign.
callbackAn der Hauptwarteschlange gesendete Blockierungen mit der Antwort des Nutzers
+ (void) showTermsAndConditionsDialogIfNeededWithTitle: (nullable NSString *)  title
Firmenname: (NSString *) companyName
Callback: (GMSTermsResponseCallback) Rückruf

Das Dialogfeld mit den Nutzungsbedingungen wird im Standarddesign angezeigt.

Weitere Informationen, einschließlich einer Beschreibung der Parameter companyName und callback , finden Sie unter +showTermsAndConditionsDialogIf NeededWithTitle:companyName:UIParams:callback:.

+ (void) showTermsAndConditionsDialogIfNeededWithCompanyName: (NSString *) companyName
Callback: (GMSTermsResponseCallback) Rückruf

Das Dialogfeld mit den Nutzungsbedingungen wird im Standardtitel und -design angezeigt.

Weitere Informationen, einschließlich einer Beschreibung der Parameter companyName und callback, finden Sie unter +showTermsAndConditionsDialogIf NeededWithTitle:companyName:UIParams:callback:.

Setzt die Nutzungsbedingungen auf den Status „Nicht akzeptiert“ zurück.

Nach dem Aufrufen dieser Methode gibt areTermsAndConditionsAccepted NO zurück und mit #if SDK_build_CONFIG(EnableNavSDKSkipToSOptions) showTermsAndConditionsDialogIfNeededWithOptions:callback: und #endif showTermsAndConditionsDialogIfNeededWithCompanyName:callback: wird das Dialogfeld mit den Nutzungsbedingungen angezeigt. Die Eigenschaft navigationEnabled vorhandener GMSMapView-Instanzen wird auf NEIN.

+ (void) setAbnormalTerminationReportingEnabled: (BOOL)  abnormalTerminationReportingEnabled

Ermöglicht die Berichterstellung zu ungewöhnlichen SDK-Beendigungen, z. B. wenn die App abstürzt, während das SDK noch ausgeführt wird.

So kann Google gegebenenfalls die Stabilität des SDK verbessern. Der Standardwert ist YES und der Wert muss aktualisiert werden, bevor die Dienstinstanz initialisiert wird.

Dieses Attribut muss über den Hauptthread festgelegt werden.

Erstellt eine neue Navigationssitzung, die keiner Kartenansicht zugeordnet ist.

Dadurch wird eine neue Navigationssitzung zugewiesen und zurückgegeben. Wegpunkte und Optionen können für die Sitzung festgelegt und Listener hinzugefügt werden.

Wenn die Nutzungsbedingungen noch nicht akzeptiert wurden, gibt diese Methode nil zurück. Dies ist der einzige Grund, warum von dieser Methode Null zurückgegeben wird.

Sie können diese Sitzung nach dem Erstellen mit der GMSMapView-Methode -enableNavigationWithSession: einer Karte zuordnen. Sitzungen sind ressourcenintensive Objekte, die Arbeitsspeicher, Daten und Akkuleistung verbrauchen. Sie sollten daher nur zugewiesen werden, wenn eine persistente Navigationssitzung eine Hauptfunktion der Anwendung ist. Wenn Ihre App eine Navigations-UI erstellt, nachdem sie eine Navigationssitzung eingerichtet hat, sollten Sie aus dem gleichen Grund die Navigations-UI mit der vorhandenen Navigationssitzung starten, anstatt eine neue zu erstellen.

Die Lebensdauer der Navigationssitzung richtet sich nach der normalen Objective-C-Semantik. Daher sollte der Aufrufer dieser Routine einen Verweis auf die Sitzung speichern.

+ (NSString *) openSourceLicenseInfo

Gibt die Open-Source-Softwarelizenzinformationen für das Google Navigation SDK for iOS zurück.

Diese Informationen müssen in Ihrer Anwendung verfügbar sein.

+ (NSString *) navSDKVersion

Gibt die Version für diesen Release des Navigation SDK for iOS zurück.


- (typedef void(^ GMSTermsResponseCallback)(BOOL termsAccepted)) [related]

Wird aufgerufen, wenn der Nutzer die Nutzungsbedingungen akzeptiert oder ablehnt

Ab Version 5.5.0 ist termsAccepted immer JA.


Property-Dokumentation

– (BOOL) shouldOnlyShowDriverAwarenesssDisclaimer [read, write, assign]

Gibt an, ob in showTermsAndConditionsDialogIfNeededWithCompanyName:callback: nur der Haftungsausschluss für das Fahrerbewusstsein angezeigt werden soll.

Der Standardwert ist NO und der Haftungsausschluss wird zusätzlich zu den standardmäßigen Nutzungsbedingungen und Diensten des Navigation SDK angezeigt. Legen Sie diese Option auf YES fest, um anzugeben, dass nur der Haftungsausschluss für das Fahrbewusstsein angezeigt werden soll.

Wenn für das Projekt das Dialogfeld „Nutzungsbedingungen“ angezeigt werden muss, hat das Festlegen dieser Variable auf YES keine Auswirkungen. Außerdem gibt die Getter-Methode immer NO zurück .

Dieses Attribut muss im Hauptthread festgelegt oder aus diesem gelesen werden.