GMSNavigator-Klassenreferenz


Überblick

Dies ist die Hauptklasse des Google Navigation SDK for iOS und bietet Methoden, um die Navigation zu einem Ziel zu steuern und auf Routen- und Fortschrittsinformationen zuzugreifen.

Diese Klasse unterstützt keine abgeleiteten Klassen.

Diese Klasse ist nicht Thread-sicher. Alle Methoden müssen vom Hauptthread aus aufgerufen werden.

Öffentliche Mitgliedsfunktionen

(void) addListener:
 Fügt einen Listener hinzu.
(BOOL) removeListener:
 Entfernt einen Listener.
(void) setDestinations:callback:
 Legt mehrere Ziele für die Navigation fest und überschreibt alle zuvor festgelegten Ziele.
(void) setDestinations:routingOptions:callback:
 Legt mehrere Ziele für die Navigation fest und überschreibt alle zuvor festgelegten Ziele.
(void) setDestinations:routeToken:callback:
 Legt mehrere Ziele für die Navigation fest, wobei ein Routentoken verwendet wird, um auf einer vorab berechneten Route zu navigieren.
(void) getRouteInfoForDestination:withRoutingOptions:callback:
 Gibt Routeninformationen auf Grundlage der Routingstrategie zurück: beste oder kürzere Standardroute.
(GMSNavigationWaypoint kann Nullwerte enthalten.*)continueToNextDestination
 Veraltet.
(void) clearDestinations
 Löscht alle zuvor festgelegten Ziele und entfernt alle berechneten Routen von der Karte.
(NSTimeInterval)timeToWaypoint:
 Gibt die geschätzte Zeit bis zum angegebenen Wegpunkt zurück oder CLTimeIntervalMax, wenn der Wegpunkt nicht Teil der aktuellen Route ist.
(CLLocationDistance)distanceToWaypoint:
 Gibt die geschätzte Entfernung zum angegebenen Wegpunkt oder CLLocationDistanceMax zurück, wenn der Wegpunkt nicht Teil der aktuellen Route ist.
(void) setTransactionIDs:errorHandler:
 Legt die laufenden Transaktions-IDs fest und protokolliert sie auf dem Server, die während der aktuellen Navigationssitzung für die Navigationsereignisse gelten.

Eigenschaften

BOOLavoidsHighways
 Gibt an, ob bei der Generierung von Routen Autobahnen gemieden werden sollen.
BOOLavoidsTolls
 Gibt an, ob beim Erstellen von Routen zu Zielen Mautstraßen vermieden werden sollen.
BOOLavoidsFerries
 Gibt an, ob bei der Generierung von Routen Fähren vermieden werden sollen.
GMSNavigationLicensePlateRestrictionlicensePlateRestriction
 Kennzeichen mit der letzten Ziffer des aktuellen Kfz-Kennzeichens und der Landesvorwahl einrichten
BOOLguidanceActive
 Gibt an, ob die detaillierte Routenführung derzeit aktiviert ist.
BOOLstopGuidanceAtArrival
 Legt fest, ob die Navigation automatisch beendet werden soll, wenn -navigator:didInboundAtWaypoint: aufgerufen wird.
NSTimeIntervaltimeUpdateThreshold
 Die minimale Änderung der geschätzten Zeit bis zum nächsten Ziel, die den Aufruf der Methode navigator:didUpdateRemainingTime: auslöst.
CLLocationDistancedistanceUpdateThreshold
 Die minimale Änderung der geschätzten Entfernung zum nächsten Ziel, die den Aufruf der Methode navigator:didUpdateRemainingDistance: auslöst.
NSTimeIntervaltimeToNextDestination
 Gibt die geschätzte Zeit bis zum nächsten Ziel zurück
CLLocationDistancedistanceToNextDestination
 Gibt die geschätzte Entfernung zum nächsten Ziel zurück.
GMSNavigationDelayCategorydelayCategoryToNextDestination
 Gibt die Verspätungskategorie an das nächste Ziel zurück.
GMSRouteLegcurrentRouteLeg
 Die aktuelle Etappe der Reise.
NSArray< GMSRouteLeg * > * routeLegs
 Ein Array von Routenabschnitten, bei denen jeder Abschnitt einem festgelegten Ziel entspricht.
GMSPathtraveledPath
 Der Pfad, den das Gerät seit der letzten Einstellung von „guideActive“ auf „JA“ zurückgelegt hat.
GMSNavigationVoiceGuidancevoiceGuidance
 Legt fest, ob die Sprachführung für Verkehrsmeldungen und detaillierte Routenführungen aktiviert werden soll.
GMSVoiceGuidanceAudioDeviceTypeaudioDeviceType
 Legt fest, über welche Audiogeräte die Sprachführung wiedergegeben werden kann.
BOOLvibrationEnabled
 Legt fest, ob das Gerät auch vibrieren soll, wenn Sprachwarnungen abgespielt werden.
BOOLsendsBackgroundNotifications
 Legt fest, ob UILocalNotifications mit Hilfeinformationen angezeigt wird, wenn die App im Hintergrund ausgeführt wird.
GMSNavigationLightingModesuggestedLightingMode
 Der vorgeschlagene Beleuchtungsmodus, basierend auf der Tageszeit und dem Gerätestandort
BOOLshouldDisplayPrompts
 Legt fest, ob Aufforderungen zur Verkehrslage, zu besseren Routen und zu Verkehrsbehinderungen angezeigt werden sollen.
GMSNavigationSpeedAlertOptionsspeedAlertOptions
 GMSNavigationSpeedAlertOptions zum Anpassen der Auslösegrenzwerte für „GMSNavigationSpeedAlertSeverity“.

(Beachten Sie, dass dies keine Elementfunktionen sind.)

typedef void(^ GMSRouteStatusCallback (routeStatus GMSRouteStatus)
 Wird aufgerufen, wenn eine Route vom Standort des Geräts zu den angegebenen Zielen oder aus einem unter „RouteStatus“ angegebenen Grund nicht gefunden wird.
typedef void(^ GMSRouteInfoCallback )(GMSNavigationRouteInfo *_Nullable routeInfo)
 Wird aufgerufen, wenn die Routeninformationen (voraussichtliche Ankunftszeit und Entfernung) zum angegebenen Wegpunkt berechnet werden
typedef void(^ GMSNavigationTransactionIDErrorHandler)(NSError *Fehler)
 Wird aufgerufen, wenn beim Festlegen der Transaktions-IDs über die „setTransactionIDs“ ein Fehler auftritt.

Dokumentation zu Mitgliederfunktionen

– (void) addListener: (id< GMSNavigatorListener >) Zuhörer

Fügt einen Listener hinzu.

Der Hörer wird mit einer schwachen Referenz gehalten.

Parameter:
ListenerEin Objekt, das dem GMSNavigatorListener-Protokoll entspricht.
– (BOOL) removeListener: (id< GMSNavigatorListener >) Zuhörer

Entfernt einen Listener.

Parameter:
ListenerEin Objekt, das dem GMSNavigatorListener-Protokoll entspricht.
Gibt zurück:
Gibt JA zurück, wenn der Listener entfernt wurde. Gibt NO zurück, wenn das Objekt kein Listener war.
- (void) setDestinations: (NSArray< GMSNavigationWaypoint * > *) Ziele
Callback: (GMSRouteStatusCallback) Rückruf

Legt mehrere Ziele für die Navigation fest und überschreibt alle zuvor festgelegten Ziele.

Der bereitgestellte Callback wird mit GMSRouteStatusOK aufgerufen, wenn eine Route vom Standort des Geräts zum angegebenen Ziel gefunden wird. Wenn ein neues Ziel festgelegt wird, bevor eine Route gefunden wird, wird die Anfrage abgebrochen und der Callback mit „GMSRouteStatusCanceled“ aufgerufen. Wenn eine Route aus einem anderen Grund nicht gefunden werden kann, wird der Callback mit einem entsprechenden Fehlerstatus aufgerufen.

Der Callback wird in der Hauptwarteschlange immer asynchron weitergeleitet.

- (void) setDestinations: (NSArray< GMSNavigationWaypoint * > *) Ziele
RoutingOptions: (GMSNavigationRoutingOptions *) routingOptions
Callback: (GMSRouteStatusCallback) Rückruf

Legt mehrere Ziele für die Navigation fest und überschreibt alle zuvor festgelegten Ziele.

Die zurückgegebenen Routen werden mithilfe von Routingoptionen berechnet.

Parameter:
ZieleArray mit Ziel-Wegpunkten
routingOptionsDie Optionen, die die Routinglogik (Routingstrategie) beeinflussen.
callbackWird aufgerufen, wenn eine Route vom Standort des Nutzers zu den angegebenen Zielen oder aus einem unter „RouteStatus“ angegebenen Grund nicht gefunden wird.
- (void) setDestinations: (NSArray< GMSNavigationWaypoint * > *) Ziele
RouteToken: (NSString *) routeToken
Callback: (GMSRouteStatusCallback) Rückruf

Legt mehrere Ziele für die Navigation fest, wobei ein Routentoken verwendet wird, um auf einer vorab berechneten Route zu navigieren.

Die Routen sind die gleichen Modulo-Änderungen für den Startort des Fahrers und die Straßen-/Verkehrslage. Es werden weiterhin Routen auf Grundlage der Routingoptionen ausgeführt, die im Token codiert sind.

Wenn Sie mit dem Routentoken eine Navigationssitzung starten, werden nur GMSNavigationTravelModeDriving und GMSNavigationTravelModeTwoWheeler unterstützt. Konfigurieren Sie die Mobilitätsform, indem Sie travelMode festlegen. Der Aufruf schlägt fehl, wenn die aktuelle Mobilitätsform nicht unterstützt wird, und im Callback wird ein GMSRouteStatusTravelModeUnsupported zurückgegeben.

Parameter:
ZieleEin Array von Ziel-Wegpunkten, sollte mit den Zielen übereinstimmen, die der RoutesPreferred API zum Abrufen des Routentokens übergeben wurden.
routeTokenEin Routentokenstring, der von der RoutesPreferred API zurückgegeben wird. Die in der RoutesPreferred API angegebenen Routingoptionen sind in diesem Routentoken codiert und werden verwendet, um die vorausberechnete Route oder eine neue Route bei einer Umleitung neu zu generieren.
callbackWird aufgerufen, wenn eine Route vom Standort des Nutzers zu den angegebenen Zielen oder aus einem unter „RouteStatus“ angegebenen Grund nicht gefunden wird.
– (void) getRouteInfoForDestination: (GMSNavigationWaypoint *) Ziel
withRoutingOptions: (GMSNavigationRoutingOptions *) routingOptions
Callback: (GMSRouteInfoCallback) Rückruf

Gibt Routeninformationen auf Grundlage der Routingstrategie zurück: beste oder kürzere Standardroute.

Gibt einen nil-Wert zurück, wenn das Projekt keine Berechtigung zum Aufrufen dieser API hat.

Parameter:
ZielDer Ziel-Wegpunkt
routingOptionsDie zum Abrufen der Routeninformationen verwendeten Optionen. Die Routingstrategie und die Strategie für alternative Routen werden ignoriert, da diese Methode die Routeninformationen für alle Routingstrategien zurückgibt.
callbackDer Callback, der beim Empfang von Routeninformationen aufgerufen wird.
– (GMSNavigationWaypoint* kann Nullwerte enthalten) continueToNextDestination

Veraltet.

Rufen Sie eine der -setDestinations:...-Methoden mit der neuen Liste der Ziele auf, anstatt diese Methode aufzurufen.

Löscht das erste Ziel aus der aktuellen Liste der Ziele. Im Anschluss an diesen Anruf wirst du dich zum nächsten Ziel leiten, falls vorhanden.

Gibt zurück:
Die Wegpunktführung bewegt sich nun in Richtung oder null, wenn keine Wegpunkte mehr übrig sind.
Hinweis:
Diese Option wurde eingestellt. Verwenden Sie stattdessen eine der Methoden „-setDestinations:...“.

Löscht alle zuvor festgelegten Ziele und entfernt alle berechneten Routen von der Karte.

Wenn die Anleitung aktiv ist, wird sie automatisch beendet.

– (NSTimeInterval) timeToWaypoint: (GMSNavigationWaypoint *) Wegpunkt

Gibt die geschätzte Zeit bis zum angegebenen Wegpunkt zurück oder CLTimeIntervalMax, wenn der Wegpunkt nicht Teil der aktuellen Route ist.

Wird auf Grundlage der aktuellen Geräteposition aktualisiert, wenn die Anleitung aktiv ist.

Gibt CLTimeIntervalMax zurück, wenn der angegebene Wegpunkt kein Ziel in der aktuellen Route ist.

– (CLLocationDistance) distanceToWaypoint: (GMSNavigationWaypoint *) Wegpunkt

Gibt die geschätzte Entfernung zum angegebenen Wegpunkt oder CLLocationDistanceMax zurück, wenn der Wegpunkt nicht Teil der aktuellen Route ist.

Wird auf Grundlage der aktuellen Geräteposition aktualisiert, wenn die Anleitung aktiv ist.

Gibt CLLocationDistanceMax zurück, wenn der angegebene Wegpunkt kein Ziel in der aktuellen Route ist.

– (void) setTransactionIDs: (NSArray< NSString * > *) transactionIDs
errorHandler: (nullable GMSNavigationTransactionIDErrorHandler) errorHandler

Legt die laufenden Transaktions-IDs fest und protokolliert sie auf dem Server, die während der aktuellen Navigationssitzung für die Navigationsereignisse gelten.

Die Transaktions-IDs werden am Ende der Navigationssitzung gelöscht.

Parameter:
transactionIDsDie Transaktions-IDs, die für die aktuelle Navigationssitzung gelten. Die Transaktions-ID muss für jede abrechnungsfähige Transaktion eindeutig sein. Eine einzelne Transaktions-ID muss mindestens ein und darf höchstens 64 Zeichen enthalten. Die Liste kann leer sein, wenn eine Transaktion beendet wurde, die Sitzung aber noch läuft.
errorHandlerBlock, der asynchron im Hauptthread aufgerufen wird, wenn bei ungültigen Transaktions-IDs ein Fehler auftritt.

- (typedef void(^ GMSRouteStatusCallback)(GMSRouteStatus routeStatus)) [related]

Wird aufgerufen, wenn eine Route vom Standort des Geräts zu den angegebenen Zielen oder aus einem unter „RouteStatus“ angegebenen Grund nicht gefunden wird.

- (typedef void(^ GMSRouteInfoCallback)(GMSNavigationRouteInfo *_Nullable routeInfo)) [related]

Wird aufgerufen, wenn die Routeninformationen (voraussichtliche Ankunftszeit und Entfernung) zum angegebenen Wegpunkt berechnet werden

Parameter:
routeInfoDie Routeninformationen zum angegebenen Ziel. Ist null, wenn die Berechnung fehlschlägt.
– (typedef void(^ GMSNavigationTransactionIDErrorHandler)(NSError *error)) [related]

Wird aufgerufen, wenn beim Festlegen der Transaktions-IDs über die „setTransactionIDs“ ein Fehler auftritt.

Weitere Informationen finden Sie in der Dokumentation zur API.


Property-Dokumentation

- (BOOL) avoidsHighways [read, write, assign]

Gibt an, ob bei der Generierung von Routen Autobahnen gemieden werden sollen.

Die Standardeinstellung ist „Nein“.

- (BOOL) avoidsTolls [read, write, assign]

Gibt an, ob beim Erstellen von Routen zu Zielen Mautstraßen vermieden werden sollen.

Die Standardeinstellung ist „Nein“.

- (BOOL) avoidsFerries [read, write, assign]

Gibt an, ob bei der Generierung von Routen Fähren vermieden werden sollen.

Die Standardeinstellung ist YES (JA).

Kennzeichen mit der letzten Ziffer des aktuellen Kfz-Kennzeichens und der Landesvorwahl einrichten

Dadurch können wir bestimmte Arten von Straßeneinschränkungen berücksichtigen, die auf Kfz-Kennzeichen basieren. Dies gilt nur für „setDestinations“-Aufrufe, nachdem dieser Wert festgelegt wurde. Idealerweise legen Sie dies direkt nach dem Aufrufen des Navigators fest.

Legen Sie „nil“ fest, wenn keine Kennzeichenbeschränkung besteht. Der Standardwert ist „nil“.

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

Gibt an, ob die detaillierte Routenführung derzeit aktiviert ist.

Wenn „guideActive“ auf JA gesetzt ist, aber derzeit keine Route verfügbar ist, beginnt die Navigation, sobald eine neue Route verfügbar wird. Diese Eigenschaft wird auf NO gesetzt, wenn „clearDestinations“ aufgerufen wird oder wir einen Wegpunkt erreichen.

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

Legt fest, ob die Navigation automatisch beendet werden soll, wenn -navigator:didInboundAtWaypoint: aufgerufen wird.

Wenn NEIN, werden die Kopf- und Fußzeile der Navigation auch nach der Ankunft angezeigt. In der Navigationsüberschrift wird weiterhin der letzte Schritt der Anleitung angezeigt und in der Fußzeile werden die verbleibende Zeit und die verbleibende Entfernung so lange aktualisiert, bis eine Zeit/Strecke von 0 erreicht wird. Außerdem werden die Aktualisierungen -navigator:didUpdateRemainingTime und -navigator:didUpdateRemainingDistance weiterhin durchgeführt. Setzen Sie guidanceActive explizit auf NO, um die Navigation und die Aktualisierung der verbleibenden Zeit/Strecke zu beenden.

Wenn JA, wird guidanceActive bei Ankunft automatisch auf NEIN gestellt.

Die Standardeinstellung ist YES (JA).

– (NSTimeInterval) timeUpdateThreshold [read, write, assign]

Die minimale Änderung der geschätzten Zeit bis zum nächsten Ziel, die den Aufruf der Methode navigator:didUpdateRemainingTime: auslöst.

Wenn dies auf NSTimeIntervalMax festgelegt ist, werden zeitaktualisierungsbezogene Callbacks deaktiviert. Wenn dieser Wert negativ ist, wird der Standardschwellenwert von einer Sekunde verwendet. Die Standardeinstellung ist eine Sekunde.

Hinweis:
Dieser Wert wird ignoriert, wenn navigator:didUpdateRemainingTime: von keinem Listener implementiert wird.
– (CLLocationDistance) distanceUpdateThreshold [read, write, assign]

Die minimale Änderung der geschätzten Entfernung zum nächsten Ziel, die den Aufruf der Methode navigator:didUpdateRemainingDistance: auslöst.

Wenn dieser Wert auf „CLLocationDistanceMax“ gesetzt ist, werden Callbacks für die Entfernungsaktualisierung deaktiviert. Wenn dieser Wert negativ ist, wird der Standardgrenzwert von einem Meter verwendet. Die Standardeinstellung ist ein Meter.

Hinweis:
Dieser Wert wird ignoriert, wenn navigator:didUpdateRemainingDistance: von keinem Listener implementiert wird.
– (NSTimeInterval) timeToNextDestination [read, assign]

Gibt die geschätzte Zeit bis zum nächsten Ziel zurück

Wird auf Grundlage der aktuellen Geräteposition aktualisiert, wenn die Anleitung aktiv ist.

Gibt CLTimeIntervalMax zurück, wenn keine Route verfügbar ist.

– (CLLocationDistance) distanceToNextDestination [read, assign]

Gibt die geschätzte Entfernung zum nächsten Ziel zurück.

Wird auf Grundlage der aktuellen Geräteposition aktualisiert, wenn die Anleitung aktiv ist.

Gibt CLLocationDistanceMax zurück, wenn keine Route verfügbar ist.

– (GMSNavigationDelayCategory) delayCategoryToNextDestination [read, assign]

Gibt die Verspätungskategorie an das nächste Ziel zurück.

Wird auf Grundlage der aktuellen Geräteposition aktualisiert, wenn die Anleitung aktiv ist.

Gibt GMSNavigationDelayCategoryNoData zurück, wenn keine Route verfügbar oder keine Verkehrsdaten verfügbar sind.

– (GMSRouteLeg*) currentRouteLeg [read, assign]

Die aktuelle Etappe der Reise.

Die Startposition dieses GMSRouteLeg ist die letzte bekannte (an einer Straße eingerastete) Position des Geräts.

- (NSArray<GMSRouteLeg *>*) routeLegs [read, assign]

Ein Array von Routenabschnitten, bei denen jeder Abschnitt einem festgelegten Ziel entspricht.

– (GMSPath*) traveledPath [read, assign]

Der Pfad, den das Gerät seit der letzten Einstellung von „guideActive“ auf „JA“ zurückgelegt hat.

Dieser Pfad ist leer, wenn die Anleitung noch nie begonnen hat. Der Pfad besteht aus der von GMSRoadSnappedLocationProvider zurückgegebenen an der Straße ausgerichteten Position. Er wird vereinfacht, um redundante Punkte zu entfernen. Zum Beispiel aufeinanderfolgende kollineare Punkte in ein einzelnes Liniensegment umwandeln.

– (GMSNavigationVoiceGuidance) voiceGuidance [read, write, assign]

Legt fest, ob die Sprachführung für Verkehrsmeldungen und detaillierte Routenführungen aktiviert werden soll.

Die Standardeinstellung ist „GMSNavigationVoiceGuidanceAlertsAndGuidance“.

– (GMSVoiceGuidanceAudioDeviceType) audioDeviceType [read, write, assign]

Legt fest, über welche Audiogeräte die Sprachführung wiedergegeben werden kann.

Die Standardeinstellung ist „GMSVoiceGuidanceAudioDeviceTypeBluetooth“.

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

Legt fest, ob das Gerät auch vibrieren soll, wenn Sprachwarnungen abgespielt werden.

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

Legt fest, ob UILocalNotifications mit Hilfeinformationen angezeigt wird, wenn die App im Hintergrund ausgeführt wird.

Die Standardeinstellung ist YES (JA).

Der vorgeschlagene Beleuchtungsmodus, basierend auf der Tageszeit und dem Gerätestandort

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

Legt fest, ob Aufforderungen zur Verkehrslage, zu besseren Routen und zu Verkehrsbehinderungen angezeigt werden sollen.

Die Standardeinstellung ist YES (JA).

– (GMSNavigationSpeedAlertOptions*) speedAlertOptions [read, write, assign]

GMSNavigationSpeedAlertOptions zum Anpassen der Auslösegrenzwerte für „GMSNavigationSpeedAlertSeverity“.

Mit dieser Eigenschaft lassen sich die Grenzwerte für das Auslösen von Geschwindigkeitswarnungen in Prozent sowohl für kleinere als auch für wichtige Warnungen anpassen. Sie können diese Methode auch verwenden, um den zeitbasierten Schwellenwert für die Auslösung einer großen Geschwindigkeitswarnung anzupassen.

Wenn Sie den Wert „nil“ festlegen, erhalten Sie keine Feeddaten zu Geschwindigkeitsüberschreitungen und die standardmäßige Geschwindigkeitswarnung des NavSDK wird angezeigt: Bei einer Geschwindigkeit von mehr als 10 km/h wird roter Text angezeigt. Bei über 20 km/h werden weißer Text und roter Hintergrund angezeigt.