GMSNavigator-Klassenreferenz


Übersicht

Dies ist die Hauptklasse des Google Navigation SDK für iOS. Sie bietet Methoden für die Steuerung der Navigation zu einem Ziel und den Zugriff auf Routen- und Fortschrittsinformationen.

Diese Klasse unterstützt keine abgeleiteten Klassen.

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

Funktionen für öffentliche Mitglieder

(nicht zutreffend)addListener:
 Fügt einen Listener hinzu.
(BOOL)removeListener:
 Entfernt einen Listener.
(nicht zutreffend)setDestinations:callback:
 Legt mehrere Ziele für die Navigation fest und überschreibt alle zuvor festgelegten Ziele
(nicht zutreffend)setDestinations:routingOptions:callback:
 Legt mehrere Ziele für die Navigation fest und überschreibt alle zuvor festgelegten Ziele
(nicht zutreffend)setDestinations:routeToken:callback:
 Legt mehrere Ziele für die Navigation fest, wobei ein Routentoken für die Navigation auf einer vorab berechneten Route verwendet wird.
(nicht zutreffend)getRouteInfoForDestination:withRoutingOptions:callback:
 Gibt Routeninformationen basierend auf der Routingstrategie zurück: beste oder kürzere Standardroute.
(Nullwerte zulässig: GMSNavigationWaypoint *)continueToNextDestination
 Verworfen.
(nicht zutreffend)- 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.
(nicht zutreffend)setTransactionIDs:errorHandler:
 Legt die laufenden Transaktions-IDs fest, die während der aktuellen Navigationssitzung für die Navigationsereignisse gelten, und protokolliert sie auf dem Server.

Eigenschaften

BOOLavoidsHighways
 Gibt an, ob bei der Erstellung von Routen zu Zielen Autobahnen vermieden werden sollen.
BOOLavoidsTolls
 Gibt an, ob bei der Erstellung von Routen zu Zielen Mautstraßen vermieden werden sollen.
BOOLavoidsFerries
 Gibt an, ob beim Generieren von Routen zu Zielen Fährverbindungen zu vermeiden sind.
GMSNavigationLicensePlateRestriction *licensePlateRestriction
 Geben Sie die letzte Ziffer des aktuellen Kfz-Kennzeichens und die Landesvorwahl an.
BOOLguidanceActive
 Gibt an, ob die detaillierte Routenführung derzeit aktiviert ist.
BOOLstopGuidanceAtArrival
 Gibt an, ob die Routenführung automatisch beendet werden soll, wenn -navigator:didArriveAtWaypoint: aufgerufen wird.
NSTimeIntervaltimeUpdateThreshold
 Die minimale Änderung der geschätzten Zeit bis zum nächsten Ziel, das den Aufruf der Methode navigator:didUpdateRemainingTime: auslöst.
CLLocationDistancedistanceUpdateThreshold
 Die minimale Änderung der geschätzten Entfernung zum nächsten Ziel, das den Aufruf der Methode navigator:didUpdateRemainingDistance: auslöst.
NSTimeIntervaltimeToNextDestination
 Gibt die geschätzte Zeit für das nächste 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.
GMSRouteLeg *currentRouteLeg
 Der aktuelle Abschnitt der Reise.
NSArray< GMSRouteLeg* > *routeLegs
 Ein Array mit Routenabschnitten, wobei jeder Abschnitt einem festgelegten Ziel entspricht.
GMSPath *traveledPath
 Der Pfad, den der Nutzer in der letzten Anleitungssitzung zurückgelegt hat. Dies wird definiert als der Zeitpunkt, als „manualActive“ auf „JA“ gesetzt wurde.
GMSNavigationVoiceGuidancevoiceGuidance
 Legt fest, ob die Sprachführung für Verkehrsmeldungen und detaillierte Routenführung aktiviert werden soll.
GMSVoiceGuidanceAudioDeviceTypeaudioDeviceType
 Legt fest, über welche Audiogeräte die Sprachführung abgespielt werden kann.
BOOLvibrationEnabled
 Legt fest, ob das Gerät auch vibrieren soll, wenn Sprachwarnungen abgespielt werden.
BOOLsendsBackgroundNotifications
 Legt fest, ob UILocalBenachrichtigungen mit Anleitungsinformationen angezeigt werden, wenn die App im Hintergrund ausgeführt wird.
GMSNavigationLightingModesuggestedLightingMode
 Der vorgeschlagene Beleuchtungsmodus, der auf der Tageszeit und dem Gerätestandort basiert.
BOOLshouldDisplayPrompts
 Legt fest, ob Hinweise zur Verkehrslage, besseren Routen und Verkehrsbehinderungen angezeigt werden sollen.
GMSNavigationSpeedAlertOptions *speedAlertOptions
 GMSNavigationSpeedAlertOptions zum Anpassen der Auslösegrenzwerte für GMSNavigationSpeedAlertSeverity.

(Beachten Sie, dass dies keine Mitgliederfunktionen sind.)

typedef void(^)GMSRouteStatusCallback )(GMSRouteStatus routeStatus)
 Wird aufgerufen, wenn eine Route vom Standort des Geräts zu den angegebenen Zielen gefunden wird oder aus einem im RouteStatus angegebenen Grund nicht gefunden wurde.
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 der Transaktions-IDs über die setTransactionIDs fehlschlägt.

Dokumentation zu Mitgliederfunktionen

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

Fügt einen Listener hinzu.

Der Listener wird mit einer schwachen Referenz gehalten.

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 ist.
- (void) setDestinations: (NSArray< GMSNavigationWaypoint * > *) Ziele
Callback: (GMSRouteStatusCallback) Callback

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

Der angegebene Callback wird mit GMSRouteStatusOK aufgerufen, wenn eine Route vom Gerätestandort zum angegebenen Ziel gefunden wird. Wenn vor dem Finden einer Route ein neues Ziel festgelegt 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 immer asynchron in der Hauptwarteschlange abgefertigt.

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

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

Die zurückgegebenen Routen werden mithilfe von Routingoptionen berechnet.

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

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

Die Routen bleiben gleich. Der Modulo-Wert ändert sich am Ausgangsort des Fahrers und an den Straßen- und Verkehrsverhältnissen. Umleitungen erfolgen weiterhin basierend auf den im Token codierten Routingoptionen.

Wenn Sie das Routentoken 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, und im Callback wird ein GMSRouteStatusTravelModeUnsupported zurückgegeben.

Parameter:
ZieleEin Array von Wegpunkten als Ziel, das mit den Zielen übereinstimmt, die der RoutesPreferred API zum Abrufen des Routentokens zugewiesen wurden.
routeTokenEin von der RoutesPreferred API zurückgegebener Routentokenstring. Die in der RoutesPreferred API angegebenen Routingoptionen sind in diesem Routentoken codiert und werden verwendet, um bei Umleitung die vorab berechnete Route bzw. eine neue Route neu zu generieren.
callbackWird aufgerufen, wenn eine Route vom Standort des Nutzers zu den angegebenen Zielen gefunden wird oder aus einem im RouteStatus angegebenen Grund nicht gefunden wurde.
- (void) getRouteInfoForDestination: (GMSNavigationWaypoint *) Ziel
withRoutingOptions: (GMSNavigationRoutingOptions *) routingOptions
Callback: (GMSRouteInfoCallback) Callback

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

Diese Methode ist nur für Mobility Services-Kunden verfügbar, die von Google auf Transaktionsbasis abgerechnet werden. Gibt einen „nil“-Wert zurück, wenn das Projekt nicht über die Berechtigung zum Aufrufen dieser API verfügt.

Parameter:
ZielDer Zielwegpunkt.
routingOptionsDie Optionen, die zum Abrufen der Routeninformationen verwendet werden. Die Strategie für die Routenplanung und für alternative Routen werden ignoriert, da diese Methode die Routeninformationen für alle Strategien zurückgibt.
callbackDer Callback, der beim Empfang von Routeninformationen aufgerufen wird.
- (GMSNavigationWaypoint mit Nullwert möglich *) continueToNextDestination

Verworfen.

Rufen Sie stattdessen eine der -setDestinations:...-Methoden mit der neuen Liste der Ziele auf.

Wählt das erste Ziel aus der aktuellen Liste der Ziele aus. Nach diesem Anruf werden Sie gegebenenfalls zum nächsten Ziel geleitet.

Gibt zurück:
Richtet sich die Wegpunktführung nun in Richtung bzw. auf null, wenn keine weiteren Wegpunkte mehr verfügbar sind.
Hinweis:
Diese Funktion 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 Routenführung 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.

Diese wird auf Grundlage der aktuellen Geräteposition aktualisiert, während die Navigation 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.

Diese wird auf Grundlage der aktuellen Geräteposition aktualisiert, während die Navigation aktiv ist.

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

– (void) setTransactionIDs: (NSArray< NSString * > *) transactionIDs
errorHandler: (Nullwerte zulässig GMSNavigationTransactionIDErrorHandler) errorHandler

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

Die Transaktions-IDs werden am Ende der Navigationssitzung gelöscht. Diese Methode ist nur für Mobility Services-Kunden verfügbar, die von Google auf Transaktionsbasis abgerechnet werden. Gibt einen „nil“-Wert zurück, wenn das Projekt nicht über die Berechtigung zum Aufrufen dieser API verfügt.

Parameter:
transactionIDsDie 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 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 gefunden wird oder aus einem im RouteStatus angegebenen Grund nicht gefunden wurde.

- (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. Der Wert ist null, wenn die Berechnung fehlschlägt.
- (typedef void(^ GMSNavigationTransactionIDErrorHandler)(NSError *error)) [related]

Wird aufgerufen, wenn das Festlegen der Transaktions-IDs über die setTransactionIDs fehlschlägt.

Weitere Informationen finden Sie in der Dokumentation zur API.


Property-Dokumentation

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

Gibt an, ob bei der Erstellung von Routen zu Zielen Autobahnen vermieden werden sollen.

Die Standardeinstellung ist NO.

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

Gibt an, ob bei der Erstellung von Routen zu Zielen Mautstraßen vermieden werden sollen.

Die Standardeinstellung ist NO.

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

Gibt an, ob beim Generieren von Routen zu Zielen Fährverbindungen zu vermeiden sind.

Die Standardeinstellung ist YES.

Geben Sie die letzte Ziffer des aktuellen Kfz-Kennzeichens und die Landesvorwahl an.

So können wir bestimmte Arten von Straßeneinschränkungen umgehen, die auf Ihrem Kfz-Kennzeichen basieren. Dies gilt nur für setDestinations-Aufrufe, die ausgeführt werden, nachdem dieser Wert festgelegt wurde. Idealerweise sollten Sie diese Einstellung sofort nach Erhalt des Navigators vornehmen.

Setze diesen Wert auf „nil“, wenn es keine Kennzeichen gibt. Der Standardwert ist null.

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

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

Wenn guideActive auf JA eingestellt ist, aber derzeit keine Route verfügbar ist, beginnt die Routenführung, sobald eine Route verfügbar ist. Diese Eigenschaft wird auf NO gesetzt, wenn ClearDestinations aufgerufen wird oder wir an einem Wegpunkt ankommen.

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

Gibt an, ob die Routenführung automatisch beendet werden soll, wenn -navigator:didArriveAtWaypoint: aufgerufen wird.

Wenn NEIN, werden die Kopf- und Fußzeile der Navigation auch nach der Ankunft angezeigt. In der Navigationskopfzeile wird weiterhin der letzte Schritt der Anleitung angezeigt. In der Fußzeile werden die verbleibende Zeit und die Entfernung aktualisiert, bis eine Zeit/Entfernung von 0 erreicht ist. Außerdem werden die Aktualisierungen -navigator:didUpdateRemainingTime und -navigator:didUpdateRemainingDistance fortgesetzt. Setze guidanceActive explizit auf NEIN, um die Routenführung und Aktualisierung der verbleibenden Zeit/Entfernung zu beenden.

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

Die Standardeinstellung ist YES.

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

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

Wenn dieser Parameter auf NSTimeIntervalMax festgelegt ist, werden Zeitaktualisierungs-Callbacks deaktiviert. Wenn dieser Wert negativ 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, das den Aufruf der Methode navigator:didUpdateRemainingDistance: auslöst.

Wenn diese Option auf CLLocationDistanceMax gesetzt ist, werden Callbacks zur 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 kein Listener navigator:didUpdateRemainingDistance: implementiert.
– (NSTimeInterval) timeToNextDestination [read, assign]

Gibt die geschätzte Zeit für das nächste Ziel zurück.

Diese wird auf Grundlage der aktuellen Geräteposition aktualisiert, während die Navigation 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.

Diese wird auf Grundlage der aktuellen Geräteposition aktualisiert, während die Navigation 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.

Diese wird auf Grundlage der aktuellen Geräteposition aktualisiert, während die Navigation aktiv ist.

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

– (GMSRouteLeg*) currentRouteLeg [read, assign]

Der aktuelle Abschnitt der Reise.

Dieses GMSRouteLeg-Element hat seine Startposition an der letzten bekannten Position des Geräts (auf einer Straße abgehängt).

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

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

– (GMSPath*) traveledPath [read, assign]

Der Pfad, den der Nutzer in der letzten Anleitungssitzung zurückgelegt hat. Dies wird definiert als der Zeitpunkt, als „manualActive“ auf „JA“ gesetzt wurde.

Der Pfad besteht aus eingegrenzten Orten, die von der GMSRoadSnappedLocationProvider zurückgegeben und vereinfacht wurden, um Liniensegmente zu erstellen.

Hinweis:
Das System fragt den Client nach GPS-Signalen ab, um Standortdaten zu erhalten. Ein schlechtes GPS-Signal kann zu einer weiteren Interpolation führen, die möglicherweise weniger präzise Routen erzeugt. Dieser Pfad ist leer, wenn die Anleitung noch nie begonnen hat.
– (GMSNavigationVoiceGuidance) voiceGuidance [read, write, assign]

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

Die Standardeinstellung ist „GMSNavigationVoiceGuidanceAlertsAndGuidance“.

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

Legt fest, über welche Audiogeräte die Sprachführung abgespielt 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 UILocalBenachrichtigungen mit Anleitungsinformationen angezeigt werden, wenn die App im Hintergrund ausgeführt wird.

Die Standardeinstellung ist YES.

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

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

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

Die Standardeinstellung ist YES.

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

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

Mit dieser Eigenschaft können Sie die Schwellenwerte für die Auslösegrenzwerte von Geschwindigkeitswarnungen in Prozent sowohl für kleinere als auch für wichtige Warnungen festlegen. Sie können diese Methode auch verwenden, um den zeitbasierten Schwellenwert für den Auslöser einer wichtigen Geschwindigkeitswarnung anzupassen.

Wenn Sie „null“ festlegen, erhalten Sie keine Daten zu Geschwindigkeitsfeeds. Stattdessen sehen Sie den standardmäßigen Geschwindigkeitshinweis des NavSDK: Der Geschwindigkeitshinweis wird rot angezeigt, wenn die Geschwindigkeit mehr als 10 km/h über der Höchstgeschwindigkeit liegt, und weiß und mit rotem Hintergrund, wenn Sie mehr als 16 km/h fahren.