Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

Auf einem Mobilgerät wird angezeigt, dass in 15 Metern rechts in die Church Street abgebogen werden muss. Unten auf dem Display wird angezeigt, dass es noch 13 Minuten bis zum Ziel sind und die verbleibende Strecke 2, 1 Meilen beträgt.

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:

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

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

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.

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];

Details zum detaillierten Datenfeed Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Wichtige Elemente der Navigationsanzeige

Event-Listener einrichten

Ereignis didChangeNavInfo verarbeiten

Swift

Objective-C

Navigationsstatus

Spurführung

Beispiel für die Spurführung

Bilder für die Spurführung

Swift

Objective-C

Symbole für Manöver erstellen

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

Generierte Symbole verwenden

Swift

Objective-C

Details zum detaillierten Datenfeed

Ereignis `didChangeNavInfo` verarbeiten