Ü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 | |
BOOL | vermeidet Autobahnen |
Gibt an, ob Autobahnen beim Generieren von Routen zu Zielen vermieden werden sollen. | |
BOOL | vermeidet Mautstraßen |
Gibt an, ob Mautstraßen beim Generieren von Routen zu Zielen vermieden werden sollen. | |
BOOL | Vermeiden 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. | |
BOOL | führung aktiv |
Gibt an, ob die detaillierte Routenführung momentan aktiviert ist. | |
BOOL | stopGuidanceAtArrival |
Gibt an, ob die Anleitung automatisch beendet werden soll, wenn -navigator :didInboundAtWaypoint: aufgerufen wird. | |
NSTimeInterval | timeUpdateThreshold (Zeitaktualisierung) |
Die minimale Änderung der geschätzten Zeit bis zum nächsten Ziel, die die Methode navigator:didUpdateRemainingTime: auslöst. | |
CLLocationDistance | EntfernungUpdateThreshold |
Die minimale Änderung der geschätzten Entfernung zum nächsten Ziel, die die Methode navigator:didUpdateRemainingDistance: auslöst. | |
NSTimeInterval | timeToNextDestination |
Gibt die geschätzte Zeit bis zum nächsten Ziel zurück. | |
CLLocationDistance | EntfernungToNextDestination |
Gibt die geschätzte Entfernung zum nächsten Ziel zurück. | |
GMSNavigationDelayCategory | delayCategoryToNextDestination |
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. | |
GMSPath * | traveledPath |
Der Pfad, den der Nutzer in der letzten Anleitungssitzung zurückgelegt hat, z.B. | |
GMSNavigationVoiceGuidance | sprachführung |
Legt fest, ob die Sprachführung für Verkehr und detaillierte Routenführung aktiviert werden soll. | |
GMSVoiceGuidanceAudioDeviceType | audioDeviceType |
Hier können Sie festlegen, welche Sprachführung für Audiogeräte abgespielt werden soll. | |
BOOL | vibrationEnabled |
Legt fest, ob das Gerät auch vibrieren soll, wenn Sprachwarnungen abgespielt werden. | |
BOOL | sendsBackgroundNotifications |
Legt fest, ob UILocalNotifications mit Richtlinieninformationen angezeigt wird, wenn die App im Hintergrund ausgeführt wird. | |
GMSNavigationLightingMode | suggestedLightingMode |
Der empfohlene Beleuchtungsmodus, basierend auf der Tageszeit und dem Nutzerstandort. | |
BOOL | shouldDisplayPrompts |
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. | |
Ähnliche Funktionen | |
(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:
-
Listener Ein Objekt, das dem GMSNavigatorListener
-Protokoll entspricht.
- (BOOL) removeListener: | (ID < GMSNavigatorListener >) | Listener |
Entfernt einen Listener.
- Parameter:
-
Listener Ein 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:
-
Ziele Ein Array von Ziel-Wegpunkten. Routingoptionen Die Optionen, die die Routinglogik beeinflussen (Routingstrategie). callback Wird 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:
-
Ziele Ein Array von Zielpunktpunkten sollte mit den Zielen übereinstimmen, die der RoutesPreferred API zum Abrufen des Routentokens zugewiesen wurden. routeToken Ein 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. callback Wird 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:
-
Ziel Der Wegpunkt des Ziels. Routingoptionen Die 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. callback Der Callback, der beim Empfang von Routeninformationen aufgerufen wird.
- (nicht zulässiger GMSNavigationWaypoint*) continueToNextDestination |
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-IDs Die 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-Handler Ein Block, der im Hauptthread asynchron aufgerufen wird, wenn ein Fehler auftritt, wenn die Transaktions-IDs ungültig sind.
Dokumentation zu Friends und verwandten Funktionen
- (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:
-
routeInfo Die 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.
- (GMSNavigationLicensePlateRestriction*) licensePlateRestriction [read, write, assign] |
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“.
- (GMSVoiceGuidanceAudioDeviceType) audioDeviceType [read, write, assign] . |
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.
- (GMSNavigationLightingMode) suggestedLightingMode [read, assign] |
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*) speedAlertOptions [read, write, assign]
|
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.