Details zum detaillierten Datenfeed

Ein Datenfeed für die detaillierte Routenführung enthält nur Navigationsinformationen für Geräte, die nicht für die kartenbasierte Routenführung entwickelt wurden. Er enthält anstehende Manöver mit von Ihnen bereitgestellten Elementen:

• Symbole (links, rechts, U-Turn)
• Abbiegenummern in Kreisverkehren
• Straßennamen
• Geschätzte Entfernungen und Zeit bis zum nächsten Navigationsschritt oder zum Ziel

Sie können den Feed für die detaillierte Routenführung verwenden, um Benutzeroberflächen zu erstellen, bei denen die vollständige Navigation SDK-UI nicht geeignet ist, z. B. für kleine Bildschirme. Sie können ihn beispielsweise für Fahrer von Zweirädern verwenden, denen Sie nur Navigationsanweisungen anzeigen können, damit sie ihr Ziel schneller und sicherer erreichen und weniger abgelenkt werden.

Wichtige Elemente der Navigationsanzeige

Die primären Felder für jeden Navigationsschritt sind der vollständige Straßenname, das Manöver und die Gesamtentfernung des Schritts, die in GMSNavigationStepInfo verfügbar sind.

Für die gesamte Fahrt können Sie die verbleibende Zeit und Entfernung bis zum aktuellen Schritt oder zum Ziel anzeigen. Diese Informationen sind in GMSNavigationNavInfo verfügbar. Die Abbildung 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. Greifen Sie im Event-Listener auf Fahrt- und Schrittinformationen zu, um Ihren Nutzern eine detaillierte Routenführung zu bieten.

Um Event-Handler zu implementieren, muss der View-Controller der Karte das GMSNavigatorListener Protokoll implementieren. Ausführliche Informationen zum Verarbeiten von Ereignissen im Navigation SDK for iOS finden Sie unter Auf Navigationsereignisse warten.

Ereignis didChangeNavInfo verarbeiten

Erstellen Sie einen Listener für das Ereignis didChangeNavInfo, 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 Status der Navigation 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 abbiegen“ oder „Rechts abbiegen“.

Unten sehen Sie Beispiel-Event-Listener für das Ereignis didChangeNavInfo:

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

  // 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 die Property navState von GMSNavigationNavInfo, um den aktuellen Status der Navigation abzurufen. Er kann einen der folgenden Werte haben:

• Unterwegs : Der GMSNavigationNavStateEnroute Status bedeutet, dass die geführte Navigation aktiv ist und sich der Nutzer auf der angegebenen Route befindet. Informationen zum aktuellen anstehenden Manöverschritt sind verfügbar.

• Route wird neu berechnet : GMSNavigationNavStateRerouting bedeutet, dass die Navigation ausgeführt wird, der Navigator aber nach einer neuen Route sucht. Der anstehende Manöverschritt ist nicht verfügbar, da es noch keine neue Route gibt.

• Angehalten : 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 löscht der Status GMSNavigationNavStateStopped die Anzeige der Navigationsinformationen, damit keine Schrittanweisungen mehr angezeigt werden.

Spurführung

Das Navigation SDK stellt Fahrspuren in der Navigationskarte als GMSNavigationLane und GMSNavigationLaneDirection Datenobjekte dar. Ein GMSNavigationLane Objekt stellt eine bestimmte Fahrspur während der Navigation dar und enthält eine Liste von GMSNavigationLaneDirection Objekten, die alle Abbiegevorgänge beschreiben, die von dieser Fahrspur aus möglich sind.

Die empfohlene Richtung, die ein Fahrer in einer Fahrspur einschlagen sollte, ist mit dem Feld recommended gekennzeichnet.

Beispiel für die Spurführung

Das folgende Snippet veranschaulicht die Datendarstellung der Fahrspuren, die im vorherigen Screenshot angezeigt werden.

// 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 Fahrspurbildern für jeden Navigationsschritt, wie in GMSNavigationStepInfo angegeben. Diese Symbole entsprechen den Richtlinien für die Bildgröße von CarPlay's guidance.

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)
      

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

Das GMSNavigationManeuver Enum definiert jedes mögliche Manöver, das während der Navigation auftreten kann. Sie können das Manöver für einen bestimmten Schritt über die maneuver Property von GMSNavigationStepInfo abrufen.

Sie müssen Manöversymbole erstellen und sie mit den zugehörigen Manö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, sollten Sie möglicherweise mehr als ein Manöver einem einzelnen Symbol zuordnen. Beispielsweise könnten GMSNavigationManeuverTurnLeft und GMSNavigationManeuverOnRampLeft beide dem Symbol für das Linksabbiegen zugeordnet werden.

Einige Manöver enthalten ein zusätzliches Label „Im Uhrzeigersinn“ oder „Gegen den Uhrzeigersinn“, das vom SDK anhand der Fahrseite eines Landes bestimmt wird. In Ländern mit Linksverkehr fahren Fahrer beispielsweise im Uhrzeigersinn in einen Kreisverkehr oder machen eine Kehrtwende, 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 Ihr Manöversymbol für ein Manöver im Uhrzeigersinn von einem Manöver gegen den Uhrzeigersinn unterscheiden.

Maximieren, um Beispiele für Symbole für verschiedene Manöver zu sehen

Beispielsymbol	Manöver für die 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 Richtlinien für die Bildgröße von CarPlay guidance.

let currentStepInfo = navInfo.currentStep

let options = GMSNavigationStepImageOptions()
options.maneuverImageSize = .square96
options.screenMetrics = UIScreen.mainScreen

let maneuverImage = currentStepinfo.maneuverImage(options: options)
      

GMSNavigationStepInfo *stepInfo = navInfo.currentStep;

GMSNavigationStepImageOptions *options = [[GMSNavigationStepImageOptions alloc] init];
options.maneuverImageSize = GMSNavigationManeuverImageSizeSquare96;
options.screenMetrics = UIScreen.mainScreen;

UIImage* maneuverImage = [stepInfo maneuverImageWithOptions:options];