Ü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 | |
BOOL | avoidsHighways |
Gibt an, ob bei der Generierung von Routen Autobahnen gemieden werden sollen. | |
BOOL | avoidsTolls |
Gibt an, ob beim Erstellen von Routen zu Zielen Mautstraßen vermieden werden sollen. | |
BOOL | avoidsFerries |
Gibt an, ob bei der Generierung von Routen Fähren vermieden werden sollen. | |
GMSNavigationLicensePlateRestriction * | licensePlateRestriction |
Kennzeichen mit der letzten Ziffer des aktuellen Kfz-Kennzeichens und der Landesvorwahl einrichten | |
BOOL | guidanceActive |
Gibt an, ob die detaillierte Routenführung derzeit aktiviert ist. | |
BOOL | stopGuidanceAtArrival |
Legt fest, ob die Navigation automatisch beendet werden soll, wenn -navigator :didInboundAtWaypoint: aufgerufen wird. | |
NSTimeInterval | timeUpdateThreshold |
Die minimale Änderung der geschätzten Zeit bis zum nächsten Ziel, die den Aufruf der Methode navigator:didUpdateRemainingTime: auslöst. | |
CLLocationDistance | distanceUpdateThreshold |
Die minimale Änderung der geschätzten Entfernung zum nächsten Ziel, die den Aufruf der Methode navigator:didUpdateRemainingDistance: auslöst. | |
NSTimeInterval | timeToNextDestination |
Gibt die geschätzte Zeit bis zum nächsten Ziel zurück | |
CLLocationDistance | distanceToNextDestination |
Gibt die geschätzte Entfernung zum nächsten Ziel zurück. | |
GMSNavigationDelayCategory | delayCategoryToNextDestination |
Gibt die Verspätungskategorie an das nächste Ziel zurück. | |
GMSRouteLeg * | currentRouteLeg |
Die aktuelle Etappe der Reise. | |
NSArray< GMSRouteLeg * > * | routeLegs |
Ein Array von Routenabschnitten, bei denen jeder Abschnitt einem festgelegten Ziel entspricht. | |
GMSPath * | traveledPath |
Der Pfad, den das Gerät seit der letzten Einstellung von „guideActive“ auf „JA“ zurückgelegt hat. | |
GMSNavigationVoiceGuidance | voiceGuidance |
Legt fest, ob die Sprachführung für Verkehrsmeldungen und detaillierte Routenführungen aktiviert werden soll. | |
GMSVoiceGuidanceAudioDeviceType | audioDeviceType |
Legt fest, über welche Audiogeräte die Sprachführung wiedergegeben werden kann. | |
BOOL | vibrationEnabled |
Legt fest, ob das Gerät auch vibrieren soll, wenn Sprachwarnungen abgespielt werden. | |
BOOL | sendsBackgroundNotifications |
Legt fest, ob UILocalNotifications mit Hilfeinformationen angezeigt wird, wenn die App im Hintergrund ausgeführt wird. | |
GMSNavigationLightingMode | suggestedLightingMode |
Der vorgeschlagene Beleuchtungsmodus, basierend auf der Tageszeit und dem Gerätestandort | |
BOOL | shouldDisplayPrompts |
Legt fest, ob Aufforderungen zur Verkehrslage, zu besseren Routen und zu Verkehrsbehinderungen angezeigt werden sollen. | |
GMSNavigationSpeedAlertOptions * | speedAlertOptions |
GMSNavigationSpeedAlertOptions zum Anpassen der Auslösegrenzwerte für „GMSNavigationSpeedAlertSeverity“. | |
Weitere Funktionen | |
(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:
-
Listener Ein Objekt, das dem GMSNavigatorListener
-Protokoll entspricht.
– (BOOL) removeListener: | (id< GMSNavigatorListener >) | Zuhörer |
Entfernt einen Listener.
- Parameter:
-
Listener Ein 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:
-
Ziele Array mit Ziel-Wegpunkten routingOptions Die Optionen, die die Routinglogik (Routingstrategie) beeinflussen. callback Wird 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:
-
Ziele Ein Array von Ziel-Wegpunkten, sollte mit den Zielen übereinstimmen, die der RoutesPreferred API zum Abrufen des Routentokens übergeben wurden. routeToken Ein 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. callback Wird 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:
-
Ziel Der Ziel-Wegpunkt routingOptions Die 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. callback Der Callback, der beim Empfang von Routeninformationen aufgerufen wird.
– (GMSNavigationWaypoint* kann Nullwerte enthalten) continueToNextDestination |
Veraltet.
Rufen Sie stattdessen eine der -setDestinations
:...-Methoden mit der neuen Liste der Ziele auf.
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:...".
- (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 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:
-
transactionIDs Die 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. errorHandler Block, der asynchron im Hauptthread aufgerufen wird, wenn bei ungültigen Transaktions-IDs ein Fehler auftritt.
Dokumentation zu Funktionen für Freunde und verwandte Funktionen
- (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:
-
routeInfo Die 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).
– (GMSNavigationLicensePlateRestriction*) licensePlateRestriction [read, write, assign] |
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).
- (GMSNavigationLightingMode) suggestedLightingMode [read, assign] |
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.