Details zum detaillierten Datenfeed

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

Ein Smartphone-Display, auf dem ein bevorstehendes Abbiegen nach rechts in 15 Metern auf die Church Street angezeigt wird. Unten auf dem Bildschirm wird die verbleibende Zeit bis zum Ziel mit 13 Minuten und die verbleibende Entfernung mit 2,1 Meilen angegeben.

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;
        ...
      }
    }
    ...
  }

Verwenden Sie das Attribut navState von GMSNavigationNavInfo, um den aktuellen Navigationsstatus abzurufen. Dieser kann einen der folgenden Werte haben:

  • Enroute: Der Status GMSNavigationNavStateEnroute bedeutet, 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: GMSNavigationNavStateRerouting bedeutet, 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: GMSNavigationNavStateStopped bedeutet, 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 Status GMSNavigationNavStateStopped gelö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

Symbol für ein Manöver

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
DEPART
UNKNOWN
STRAIGHT
ON_RAMP_UNSPECIFIED
OFF_RAMP_UNSPECIFIED
NAME_CHANGE
TURN_RIGHT
ON_RAMP_RIGHT
TURN_LEFT
ON_RAMP_LEFT
TURN_SLIGHT_RIGHT
ON_RAMP_SLIGHT_RIGHT
OFF_RAMP_SLIGHT_RIGHT
TURN_SLIGHT_LEFT
ON_RAMP_SLIGHT_LEFT
OFF_RAMP_SLIGHT_LEFT
TURN_SHARP_RIGHT
ON_RAMP_SHARP_RIGHT
OFF_RAMP_SHARP_RIGHT
TURN_SHARP_LEFT
ON_RAMP_SHARP_LEFT
OFF_RAMP_SHARP_LEFT
TURN_U_TURN_COUNTERCLOCKWISE
ON_RAMP_U_TURN_COUNTERCLOCKWISE
OFF_RAMP_U_TURN_COUNTERCLOCKWISE
TURN_U_TURN_CLOCKWISE
ON_RAMP_U_TURN_CLOCKWISE
OFF_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_RIGHT
OFF_RAMP_RIGHT
MERGE_LEFT
OFF_RAMP_LEFT
FORK_RIGHT
TURN_KEEP_RIGHT
ON_RAMP_KEEP_RIGHT
OFF_RAMP_KEEP_RIGHT
FORK_LEFT
TURN_KEEP_LEFT
ON_RAMP_KEEP_LEFT
OFF_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];