Das Navigation SDK ist derzeit nur für ausgewählte Kunden verfügbar. Weitere Informationen erhalten Sie vom Vertrieb.

Referenz zur GMSNavigator-Klasse

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Übersicht

Dies ist die Hauptklasse des Google Navigation SDK für iOS. Sie bietet Methoden, um die Navigation zu einem Ziel zu steuern und Routen- und Fortschrittsinformationen abzurufen.

Diese Klasse unterstützt keine Unterklassen.

Diese Klasse ist nicht threadsicher. Alle Methoden müssen aus dem Hauptthread aufgerufen werden.

Funktionen für öffentliche Mitglieder

(void)addListener:
 Fügt einen Listener hinzu.
(BOOL)removeListener:
 Entfernt einen Listener.
(void)setDestinations:callback:
 Legt mehrere Ziele für die Navigation fest, wobei alle zuvor festgelegten Ziele überschrieben werden.
(void)setDestinations:routingOptions:callback:
 Legt mehrere Ziele für die Navigation fest, wobei alle zuvor festgelegten Ziele überschrieben werden.
(void)setDestinations:routeToken:callback:
 Legt mehrere Ziele für die Navigation fest und verwendet ein Routentoken, um auf einer vorausberechneten Route zu navigieren.
(void)getRouteInfoForDestination:withRoutingOptions:callback:
 Gibt Routeninformationen basierend auf der Routingstrategie zurück: standardmäßig beste oder kürzere Route.
(nicht zulässig GMSNavigationWaypoint*)continueToNextDestination
 Fügt das erste Ziel aus der aktuellen Liste der Ziele hinzu.
(void)- clearDestinations
 Löscht alle zuvor festgelegten Ziele und entfernt alle berechneten Routen von der Karte.
(NSTimeInterval) timeToWaypoint:
 Gibt die geschätzte Zeit für den angegebenen Wegpunkt oder CLTimeIntervalMax zurück, 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, die für die Navigationsereignisse während der aktuellen Navigationssitzung gelten.

Eigenschaften

BOOLvermeidet Autobahnen
 Gibt an, ob Autobahnen beim Generieren von Routen zu Zielen vermieden werden sollen.
BOOLvermeidet Mautstraßen
 Gibt an, ob Mautstraßen beim Generieren von Routen zu Zielen vermieden werden sollen.
BOOLVermeiden von Fähren
 Gibt an, ob Fähren beim Generieren von Routen zu Zielen vermieden werden sollen.
GMSNavigationLicensePlateRestriction*licensePlateRestriction
 Sie legen die Beschränkung für das Kfz-Kennzeichen der letzten Ziffer des Kfz-Kennzeichens und des Ländercodes fest.
BOOLführung aktiv
 Gibt an, ob die detaillierte Routenführung momentan aktiviert ist.
BOOLstopGuidanceAtArrival
 Gibt an, ob die Anleitung automatisch beendet werden soll, wenn -navigator:didInboundAtWaypoint: aufgerufen wird.
NSTimeIntervaltimeUpdateThreshold (Zeitaktualisierung)
 Die minimale Änderung der geschätzten Zeit bis zum nächsten Ziel, die die Methode navigator:didUpdateRemainingTime: auslöst.
CLLocationDistanceEntfernungUpdateThreshold
 Die minimale Änderung der geschätzten Entfernung zum nächsten Ziel, die die Methode navigator:didUpdateRemainingDistance: auslöst.
NSTimeIntervaltimeToNextDestination
 Gibt die geschätzte Zeit bis zum nächsten Ziel zurück.
CLLocationDistanceEntfernungToNextDestination
 Gibt die geschätzte Entfernung zum nächsten Ziel zurück.
GMSNavigationDelayCategorydelayCategoryToNextDestination
 Gibt die Kategorie der Verspätung an das nächste Ziel zurück.
GMSRouteLeg*currentRouteLeg
 Der aktuelle Streckenabschnitt.
NSArray< GMSRouteLeg * > *routeLegs (Routenabschnitte)
 Ein Array von Routenabschnitten, wobei jeder Abschnitt einem festgelegten Ziel entspricht.
GMSPathtraveledPath
 Der Pfad, den der Nutzer in der letzten Anleitungssitzung zurückgelegt hat, z.B.
GMSNavigationVoiceGuidancesprachführung
 Legt fest, ob die Sprachführung für Verkehr und detaillierte Routenführung aktiviert werden soll.
GMSVoiceGuidanceAudioDeviceTypeaudioDeviceType
 Hier können Sie festlegen, welche Sprachführung für Audiogeräte abgespielt werden soll.
BOOLvibrationEnabled
 Legt fest, ob das Gerät auch vibrieren soll, wenn Sprachwarnungen abgespielt werden.
BOOLsendsBackgroundNotifications
 Legt fest, ob UILocalNotifications mit Richtlinieninformationen angezeigt wird, wenn die App im Hintergrund ausgeführt wird.
GMSNavigationLightingModesuggestedLightingMode
 Der empfohlene Beleuchtungsmodus, basierend auf der Tageszeit und dem Nutzerstandort.
BOOLshouldDisplayPrompts
 Legt fest, ob Aufforderungen für die Verkehrslage, bessere Routen und Vorfälle angezeigt werden sollen.
GMSNavigationSpeedAlertOptions*speedAlertOptions festlegen
 GMSNavigationSpeedAlertOptions zur Anpassung der Triggergrenzwerte für GMSNavigationSpeedAlertSeverity.

(Hinweis: Dies sind keine Mitgliederfunktionen.)

typedef void(^ GMSRouteStatusCallback ) (GMSRouteStatus RoutingStatus)
 Wird aufgerufen, wenn eine Route vom Standort des Nutzers zum angegebenen Ziel oder aus einem vom RouteStatus angegebenen Grund 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 *error)
 Wird aufgerufen, wenn das Festlegen von Transaktions-IDs über die setTransactionIDs fehlschlägt.

Dokumentation zu Mitgliederfunktionen

– (void) addListener: (ID < GMSNavigatorListener >) Listener

Fügt einen Listener hinzu.

Der Listener hat eine schwache Referenz.

Parameter:
ListenerEin Objekt, das dem GMSNavigatorListener-Protokoll entspricht.
- (BOOL) removeListener: (ID < GMSNavigatorListener >) Listener

Entfernt einen Listener.

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

Legt mehrere Ziele für die Navigation fest, wobei alle zuvor festgelegten Ziele überschrieben werden.

Der bereitgestellte Callback wird mit GMSRouteStatusOK aufgerufen, wenn eine Route vom Standort des Nutzers zum angegebenen Ziel gefunden wurde. 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 dem entsprechenden Fehlerstatus aufgerufen.

Der Callback wird immer asynchron in der Hauptwarteschlange gesendet.

- (void) setDestinations: (NSArray< GMSNavigationWaypoint * > *) Ziele
Routingoptionen: (GMSNavigationRoutingOptions*) routingOptions
Callback: (GMSRouteStatusCallback) Callback

Legt mehrere Ziele für die Navigation fest, wobei alle zuvor festgelegten Ziele überschrieben werden.

Die zurückgegebenen Routen werden mithilfe von Routingoptionen berechnet.

Parameter:
ZieleEin Array von Ziel-Wegpunkten.
RoutingoptionenDie Optionen, die die Routinglogik beeinflussen (Routingstrategie).
callbackWird aufgerufen, wenn eine Route vom Standort des Nutzers zum angegebenen Ziel oder aus einem vom RouteStatus angegebenen Grund gefunden wird.
- (void) setDestinations: (NSArray< GMSNavigationWaypoint * > *) Ziele
routeToken: (NSString *) routeToken festlegen
Callback: (GMSRouteStatusCallback) Callback

Legt mehrere Ziele für die Navigation fest und verwendet ein Routentoken, um auf einer vorausberechneten Route zu navigieren.

Die Routen sind identisch. Modulo ändert sich je nach Ausgangsort des Fahrers und Straßen-/Verkehrslage. Routen werden weiterhin basierend auf den im Token codierten Routingoptionen ausgeführt.

Wenn Sie das Navigationstoken zum Starten einer Navigationssitzung verwenden, 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. Im Callback wird ein GMSRouteStatusTravelModeUnsupported zurückgegeben.

Parameter:
ZieleEin Array von Zielpunktpunkten sollte mit den Zielen übereinstimmen, die der RoutesPreferred API zum Abrufen des Routentokens zugewiesen wurden.
routeTokenEin Routentoken-String, der von der RoutesPreferred API zurückgegeben wird. In der RoutesPreferred API angegebene Routingoptionen sind in diesem Routentoken codiert und werden verwendet, um die vorab berechnete Route oder eine neue Route neu zu generieren, wenn eine Neuroute stattfindet.
callbackWird aufgerufen, wenn eine Route vom Standort des Nutzers zu den angegebenen Zielen gefunden wird oder aus einem vom RouteStatus angegebenen Grund nicht gefunden wird.
- (void) getRouteInfoForDestination: (GMSNavigationWaypoint*) Ziel
Mit RoutingOptionen: (GMSNavigationRoutingOptions*) routingOptions
Callback: (GMSRouteInfoCallback) Callback

Gibt Routeninformationen basierend auf der Routingstrategie zurück: standardmäßig beste oder kürzere Route.

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

Parameter:
ZielDer Wegpunkt des Ziels.
RoutingoptionenDie Optionen zum Abrufen der Routeninformationen. 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.

Fügt das erste Ziel aus der aktuellen Liste der Ziele hinzu.

Nach diesem Anruf wird die Wegbeschreibung zum nächsten Ziel (falls vorhanden) gesendet.

Gibt zurück:
Die Wegpunktführung ist jetzt auf dem Weg in Richtung oder null, wenn keine Wegpunkte mehr übrig sind.
– (void) clearDestinations

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 für den angegebenen Wegpunkt oder CLTimeIntervalMax zurück, wenn der Wegpunkt nicht Teil der aktuellen Route ist.

Solange die Anleitung aktiv ist, wird sie basierend auf der aktuellen Nutzerposition aktualisiert.

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.

Solange die Anleitung aktiv ist, wird sie basierend auf der aktuellen Nutzerposition aktualisiert.

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

- (void) setTransactionIDs: (NSArray< NSString * > *) transactionIDs
errorHandler: (ableNavigationTransactionIDErrorHandler) zulässig errorHandler

Legt die laufenden Transaktions-IDs fest, die für die Navigationsereignisse während der aktuellen Navigationssitzung gelten.

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

Parameter:
Transaktions-IDsDie Transaktions-IDs, die für die aktuelle Navigationssitzung gelten. Die Transaktions-ID muss für jede abrechenbare Transaktion eindeutig sein. Eine einzelne Transaktions-ID muss mindestens eins und höchstens 64 Zeichen enthalten. Die Liste kann leer sein, wenn eine Transaktion beendet ist, die Sitzung aber noch läuft.
Fehler-HandlerEin Block, der im Hauptthread asynchron aufgerufen wird, wenn ein Fehler auftritt, wenn die Transaktions-IDs ungültig sind.

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

Wird aufgerufen, wenn eine Route vom Standort des Nutzers zum angegebenen Ziel oder aus einem vom RouteStatus angegebenen Grund 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 das Festlegen von Transaktions-IDs über die setTransactionIDs fehlschlägt.

Weitere Informationen finden Sie in der API-Dokumentation.


Property-Dokumentation

- (BOOL) vermeidet Autobahnen [read, write, assign]

Gibt an, ob Autobahnen beim Generieren von Routen zu Zielen vermieden werden sollen.

Die Standardeinstellung ist NO.

- (BOOL) vermeidet Mautgebühren [read, write, assign]

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

Die Standardeinstellung ist NO.

- (BOOL) vermeidet Fähren [read, write, assign]

Gibt an, ob Fähren beim Generieren von Routen zu Zielen vermieden werden sollen.

Der Standardwert ist YES.

Sie legen die Beschränkung für das Kfz-Kennzeichen der letzten Ziffer des Kfz-Kennzeichens und des Ländercodes fest.

So können wir bestimmte Straßeneinschränkungen umgehen, die auf dem Nummernschild basieren. Dies gilt nur für setDestinations-Aufrufe, die nach dem Festlegen dieses Werts ausgeführt werden. Idealerweise sollten Sie dies direkt nach dem Abrufen des Navigators festlegen.

Wird auf „nil“ gesetzt, wenn keine Kfz-Kennzeichenbeschränkung gilt. Standardmäßig auf null gesetzt.

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

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

Wenn „leaderAktiv“ JA ist, aber derzeit keine Route verfügbar ist, wird die Routenführung gestartet, sobald eine Route verfügbar ist. Diese Eigenschaft wird auf NO gesetzt, wenn clearDestinations aufgerufen wird, oder wir kommen an einem Wegpunkt.

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

Gibt an, ob die Anleitung automatisch beendet werden soll, wenn -navigator:didInboundAtWaypoint: aufgerufen wird.

Bei „Nein“ werden nach der Ankunft weiterhin die Kopf- und Fußzeile der Navigation angezeigt. Im Navigationsheader wird weiterhin der letzte Anleitungsschritt angezeigt und die Navigationsfußzeile aktualisiert weiterhin die verbleibende Zeit und die Entfernung, bis eine Zeit/Entfernung von 0 erreicht ist. Außerdem werden die Aktualisierungen durch -navigator:didUpdateVerbleibende Zeit und -navigator:didUpdateVerbleibendeEntfernung fortgesetzt. Setzen Sie guidanceActive explizit auf „NEIN“, um die Navigation und die Aktualisierung von verbleibenden Zeit- und Entfernungen zu beenden.

Wenn JA, wird guidanceActive bei der Ankunft automatisch auf NEIN gesetzt.

Der Standardwert ist YES.

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

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

Wenn dies auf NSTimeIntervalMax gesetzt ist, werden Callbacks für Zeitaktualisierungen deaktiviert. Wenn dies ein negativer Wert ist, wird der Standardgrenzwert von einer Sekunde verwendet. Die Standardeinstellung ist eine Sekunde.

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

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

Ist dies auf CLLocationDistanceMax festgelegt, werden Callbacks für Entfernungsupdates deaktiviert. Wenn dies ein negativer Wert ist, wird der Standardgrenzwert von einem Meter verwendet. Die Standardeinstellung ist ein Meter.

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

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

Solange die Anleitung aktiv ist, wird sie basierend auf der aktuellen Nutzerposition aktualisiert.

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.

Solange die Anleitung aktiv ist, wird sie basierend auf der aktuellen Nutzerposition aktualisiert.

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

- (GMSNavigationDelayCategory) delayCategoryToNextDestination [read, assign]

Gibt die Kategorie der Verspätung an das nächste Ziel zurück.

Solange die Anleitung aktiv ist, wird sie basierend auf der aktuellen Nutzerposition aktualisiert.

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

– (GMSRouteLeg*) currentRouteLeg [read, assign]

Der aktuelle Streckenabschnitt.

Die Ausgangsposition dieses GMSRouteLeg ist die letzte bekannte Position (Straßenposition).

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

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

- (GMSPath*) traveledPath [read, assign]

Der Pfad, den der Nutzer in der letzten Anleitungssitzung zurückgelegt hat, d.h.

seit der letzten Anweisung von „active“ auf „YES“ gesetzt Der Pfad besteht aus den Straßenpositionen, die von GMSRoadSnappedLocationProvider zurückgegeben würden, vereinfachte redundante Punkte aber, z. B. die Umwandlung aufeinanderfolgender Punkte in ein einzelnes Liniensegment. Dieser Pfad ist leer, wenn die Anleitung noch nicht gestartet wurde.

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

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

Die Standardeinstellung ist „GMSNavigationVoiceGuidanceAlertsAndGuidance“.

Hier können Sie festlegen, welche Sprachführung für Audiogeräte abgespielt werden soll.

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 Richtlinieninformationen angezeigt wird, wenn die App im Hintergrund ausgeführt wird.

Der Standardwert ist YES.

Der empfohlene Beleuchtungsmodus, basierend auf der Tageszeit und dem Nutzerstandort.

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

Legt fest, ob Aufforderungen für die Verkehrslage, bessere Routen und Vorfälle angezeigt werden sollen.

Der Standardwert ist YES.

GMSNavigationSpeedAlertOptions zur Anpassung der Triggergrenzwerte für GMSNavigationSpeedAlertSeverity.

Sie können diese Eigenschaft verwenden, um die Grenzwerte für die Geschwindigkeitsauslösung in Prozent sowohl für kleinere als auch für große Warnungen anzupassen. Sie können diese Methode auch verwenden, um den zeitbasierten Triggergrenzwert für wichtige Geschwindigkeitswarnungen anzupassen.

Wenn Sie nil einstellen, erhalten Sie keine Geschwindigkeitsfeed-Daten und die Standardgeschwindigkeitswarnung des NavSDK wird angezeigt: Die Geschwindigkeitswarnung zeigt einen roten Text an, wenn die Geschwindigkeit mehr als 5 mph oder 10 km/h über der Höchstgeschwindigkeit liegt. Bei einer Geschwindigkeit von über 10 mph oder 20 km/h wird weißer und roter Hintergrund angezeigt.