Ein Datenfeed für die detaillierte Routenführung liefert Navigationsinformationen für Geräte, die nicht für die kartenbasierte Navigation ausgelegt sind. Sie liefert die anstehenden Manöver mit den von Ihnen bereitgestellten Elementen:
- Symbole (links, rechts, wenden)
- Abbiegenummern in Kreisverkehren
- Straßennamen
- Geschätzte Entfernungen und Zeit bis zum nächsten Navigationsschritt oder Endziel
Sie können den Feed für die detaillierte Routenführung verwenden, um Funktionen zu erstellen, für die die vollständige Navigation SDK-Benutzeroberfläche nicht geeignet ist, z. B. für kleine Displays. Sie können diese Funktion beispielsweise für Zweiradfahrer verwenden, um ihnen nur die Navigation anzuzeigen. So können sie ihr Ziel schneller und sicherer erreichen und werden weniger abgelenkt.
Wichtige Navigationselemente
Die primären Felder für jeden Navigationsschritt sind der vollständige Straßenname, das Manöver und die Gesamtdistanz des Schritts. Diese sind in GMSNavigationStepInfo verfügbar.
Für die gesamte Fahrt können Sie die verbleibende Zeit und Entfernung bis zum aktuellen Schritt oder bis zum Ziel anzeigen lassen. Diese Informationen sind in GMSNavigationNavInfo verfügbar.
Das Bild rechts zeigt ein Beispiel für diese wichtigen Navigationselemente.
Event-Listener einrichten
Wenn Sie nur Navigationsdaten verwenden möchten, müssen Sie einen Event-Listener für das Ereignis didChangeNavInfo implementieren. Über den Event-Listener können Sie auf Informationen zu Fahrten und Schritten zugreifen, um Ihren Nutzern eine detaillierte Routenführung zu bieten.
Wenn Sie Event-Handler implementieren möchten, muss der Ansichts-Controller der Karte das Protokoll GMSNavigatorListener implementieren. Ausführliche Informationen zum Umgang mit Ereignissen im Navigation SDK for iOS finden Sie unter Auf Navigationsereignisse warten.
Ereignis didChangeNavInfo verarbeiten
Erstellen Sie einen Listener für das didChangeNavInfo-Ereignis, um Ihrer App Unterstützung für die detaillierte Routenführung hinzuzufügen. Verwenden Sie im Event-Listener die folgenden Klassen und Enums, um die detaillierte Routenführung zu steuern:
GMSNavigationNavInfo– Klasse, die Informationen zum Navigationsstatus definiert.GMSNavigationStepInfo: Klasse, die Informationen zu einem einzelnen Schritt auf einer Navigationsroute definiert.GMSNavigationNavState: Enum, das den aktuellen Status einer Navigation definiert, z. B. „Unterwegs“, „Route wird neu berechnet“ oder „Angehalten“.GMSNavigationDrivingSide– Enum, das definiert, ob dieser Schritt auf einer Route mit Rechts- oder Linksverkehr liegt.GMSNavigationManeuver– Enum, das die auszuführende Navigationsaktion definiert, z. B. links oder rechts abbiegen.
Hier sehen Sie Beispiel-Event-Listener für das didChangeNavInfo-Ereignis:
Swift
// ViewController.swift class SomeViewController: UIViewController { ... mapView.navigator?.add(self); ... } extension SomeViewController: GMSNavigatorListener { func navigator(_ navigator: GMSNavigator, didUpdateNavInfo navInfo: GMSNavigationNavInfo) { // Get the current step information if navInfo.navState == .enroute { if let currentStep = navInfo.currentStep { ... roadNameLabel.text = currentStep.simpleRoadName ... } } } }
Objective-C
// ViewController.h @interface SomeViewController () <GMSNavigatorListener> @end // ViewController.m @implementation SomeViewController // Some initialization code. ... { ... [_mapView.navigator addListener:self]; ... } #pragma mark GMSNavigatorListener - (void)navigator:(GMSNavigator *)navigator didUpdateNavInfo:(GMSNavigationNavInfo *)navInfo { // Get the current step information if (navInfo.navState == GMSNavigationNavStateEnroute) { GMSNavigationStepInfo *currentStep = navInfo.currentStep; if (currentStep) { ... roadNameLabel.text = currentStep.simpleRoadName; ... } } ... }
Navigationsstatus
Verwenden Sie das Attribut navState von GMSNavigationNavInfo, um den aktuellen Navigationsstatus abzurufen. Dieser kann einen der folgenden Werte haben:
Enroute: Der Status
GMSNavigationNavStateEnroutebedeutet, dass die geführte Navigation aktiv ist und der Nutzer sich auf der angegebenen Route befindet. Informationen zum aktuellen bevorstehenden Manöverschritt sind verfügbar.Route wird neu berechnet:
GMSNavigationNavStateReroutingbedeutet, dass die Navigation läuft, aber der Navigator nach einer neuen Route sucht. Der nächste Manöverschritt ist nicht verfügbar, da noch keine neue Route vorhanden ist.Beendet:
GMSNavigationNavStateStoppedbedeutet, dass die Navigation beendet wurde. Die Navigation wird beispielsweise beendet, wenn der Nutzer die Navigation in der App beendet. In der Beispiel-App wird die Anzeige der Navigationsinformationen durch den StatusGMSNavigationNavStateStoppedgelöscht, damit keine veralteten Schrittanleitungen angezeigt werden.
Spurführung
Im Navigation SDK werden Fahrspuren in der Abbiegekarte als GMSNavigationLane- und GMSNavigationLaneDirection-Datenobjekte dargestellt. Ein GMSNavigationLane-Objekt stellt eine bestimmte Fahrspur während der Navigation dar und enthält eine Liste von GMSNavigationLaneDirection-Objekten, die alle Abbiegungen beschreiben, die von dieser Fahrspur aus möglich sind.
Die empfohlene Richtung, die ein Fahrer auf einer Fahrspur einschlagen sollte, wird mit dem Feld recommended angegeben.

Beispiel für Spurführung
Das folgende Snippet veranschaulicht die Datendarstellung der im vorherigen Screenshot angezeigten Lanes.
// Lane 1
GMSNavigationLaneDirections =
[{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]
// Lane 2
GMSNavigationLaneDirections =
[{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeNormalLeft, /*recommended=*/ true}]
// Lane 3
GMSNavigationLaneDirections =
[{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false}]
// Lane 4
GMSNavigationLaneDirections =
[{/*GMSNavigationLaneShape=*/
GMSNavigationLaneShapeStraight, /*recommended=*/ false},
{/*GMSNavigationLaneShape=*/ GMSNavigationLaneShapeNormalRight, /*recommended=*/ false}]
Bilder für die Spurführung
Das Navigation SDK unterstützt die Generierung von Fahrstreifenbildern für jeden Navigationsschritt, wie von GMSNavigationStepInfo angegeben. Diese Symbole entsprechen den Leitlinien zur Bildgröße von CarPlay.
Swift
let currentStepInfo = navInfo.currentStep let options = GMSNavigationStepImageOptions() options.maneuverImageSize = .square96 options.screenMetrics = UIScreen.mainScreen let maneuverImage = currentStepinfo.maneuverImage(options: options)
Objective-C
GMSNavigationStepInfo *stepInfo = navInfo.currentStep; GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init]; options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96; options.screenMetrics = UIScreen.mainScreen; UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];
Symbole für Manöver erstellen
![]()
Die Aufzählung GMSNavigationManeuver definiert alle möglichen Manöver, die während der Navigation auftreten können. Sie können das Manöver für einen bestimmten Schritt über die Property maneuver von GMSNavigationStepInfo abrufen.
Sie müssen Symbole für Fahrmanöver erstellen und sie mit den entsprechenden Fahrmanövern verknüpfen.
Für einige Manöver können Sie eine 1:1-Zuordnung zu einem Symbol einrichten, z. B. GMSNavigationManeuverDestinationLeft und GMSNavigationManeuverDestinationRight. Da einige Manöver jedoch Merkmale mit anderen Manövern gemeinsam haben, kann es sinnvoll sein, einem Symbol mehr als ein Manöver zuzuordnen. Beispiel: GMSNavigationManeuverTurnLeft und GMSNavigationManeuverOnRampLeft könnten beide dem Symbol für Linksabbiegen zugeordnet werden.
Einige Manöver enthalten ein zusätzliches Label „Clockwise“ (Im Uhrzeigersinn) oder „CounterClockwise“ (Gegen den Uhrzeigersinn), das vom SDK anhand der Straßenseite bestimmt wird, auf der in einem Land gefahren wird. In Ländern mit Linksverkehr fahren Fahrer beispielsweise im Uhrzeigersinn in einen Kreisverkehr oder eine Kehre, während in Ländern mit Rechtsverkehr gegen den Uhrzeigersinn gefahren wird. Das Navigation SDK erkennt, ob ein Manöver im Links- oder Rechtsverkehr stattfindet, und gibt das entsprechende Manöver aus. Daher kann sich das Symbol für ein Manöver im Uhrzeigersinn von dem für ein Manöver gegen den Uhrzeigersinn unterscheiden.
Maximieren, um Beispielsymbole für verschiedene Manöver zu sehen
| Beispielsymbol | Detaillierte Routenführung |
|---|---|
![]() |
DEPARTUNKNOWN |
![]() |
STRAIGHTON_RAMP_UNSPECIFIEDOFF_RAMP_UNSPECIFIEDNAME_CHANGE
|
![]() |
TURN_RIGHTON_RAMP_RIGHT
|
![]() |
TURN_LEFTON_RAMP_LEFT
|
![]() |
TURN_SLIGHT_RIGHTON_RAMP_SLIGHT_RIGHTOFF_RAMP_SLIGHT_RIGHT
|
![]() |
TURN_SLIGHT_LEFTON_RAMP_SLIGHT_LEFTOFF_RAMP_SLIGHT_LEFT
|
![]() |
TURN_SHARP_RIGHTON_RAMP_SHARP_RIGHTOFF_RAMP_SHARP_RIGHT
|
![]() |
TURN_SHARP_LEFTON_RAMP_SHARP_LEFTOFF_RAMP_SHARP_LEFT
|
![]() |
TURN_U_TURN_COUNTERCLOCKWISEON_RAMP_U_TURN_COUNTERCLOCKWISEOFF_RAMP_U_TURN_COUNTERCLOCKWISE
|
![]() |
TURN_U_TURN_CLOCKWISEON_RAMP_U_TURN_CLOCKWISEOFF_RAMP_U_TURN_CLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_STRAIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_U_TURN_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_U_TURN_CLOCKWISE
|
![]() |
ROUNDABOUT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_CLOCKWISE
|
![]() |
ROUNDABOUT_EXIT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_EXIT_CLOCKWISE
|
![]() |
MERGE_RIGHTOFF_RAMP_RIGHT
|
![]() |
MERGE_LEFTOFF_RAMP_LEFT
|
![]() |
FORK_RIGHTTURN_KEEP_RIGHTON_RAMP_KEEP_RIGHTOFF_RAMP_KEEP_RIGHT
|
![]() |
FORK_LEFTTURN_KEEP_LEFTON_RAMP_KEEP_LEFTOFF_RAMP_KEEP_LEFT
|
![]() |
MERGE_UNSPECIFIED
|
![]() |
DESTINATION
|
![]() |
DESTINATION_RIGHT
|
![]() |
DESTINATION_LEFT
|
![]() |
FERRY_BOAT
|
![]() |
FERRY_TRAIN
|
Generierte Symbole verwenden
Das Navigation SDK unterstützt die Generierung von Manöversymbolen für ein bestimmtes GMSNavigationStepInfo. Diese Symbole entsprechen den Größenrichtlinien für CarPlay-Bilder.
Swift
let currentStepInfo = navInfo.currentStep let options = GMSNavigationStepImageOptions() options.maneuverImageSize = .square96 options.screenMetrics = UIScreen.mainScreen let maneuverImage = currentStepinfo.maneuverImage(options: options)
Objective-C
GMSNavigationStepInfo *stepInfo = navInfo.currentStep; GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init]; options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96; options.screenMetrics = UIScreen.mainScreen; UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];







































