即時路線資料動態饋給的詳細資料

即時路線資料動態饋給會向不支援地圖導航的裝置,提供純導航資訊。它會使用您提供的元素,提供即將進行的操作:

  • 圖示 (左轉、右轉、迴轉)
  • 圓環出口編號
  • 道路名稱
  • 預估距離和時間,以及下一個導航步驟或最終目的地

您可以使用即時路線動態饋給,在不適合顯示完整 Navigation SDK UI 的情況下 (例如小型螢幕) 打造體驗。舉例來說,您可以將這項功能用於兩輪車輛騎士,投射僅限導航的路線指引,協助他們更快、更安心地抵達目的地,同時盡可能減少干擾。

基本導覽顯示元素

行動裝置畫面顯示,前方 50 英尺處要右轉進入 Church Street。畫面底部顯示抵達目的地所需時間為 13 分鐘,剩餘距離為 2.1 英里。

每個導航步驟的主要欄位包括完整路名、行進動作和步驟總距離,這些資訊可在 GMSNavigationStepInfo 中取得。

在整個行程中,您可能需要顯示目前步驟或目的地的剩餘時間和距離,這些資訊都可在 GMSNavigationNavInfo 中取得。右圖顯示這些基本導覽元素的範例。

設定事件監聽器

如要使用僅限導航資料,您必須為 didChangeNavInfo 事件實作事件監聽器。在事件監聽器中,存取行程和步驟資訊,為使用者提供即時路況導航。

如要實作事件處理常式,地圖的檢視控制器必須實作 GMSNavigatorListener 協定。如要進一步瞭解如何在 Navigation SDK for iOS 中處理事件,請參閱「監聽導航事件」。

處理 didChangeNavInfo 事件

為 didChangeNavInfo 事件建立監聽器,在應用程式中加入即時路線支援。在事件監聽器中,使用下列類別和列舉控制即時路況導航:

以下是 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;
        ...
      }
    }
    ...
  }

使用 GMSNavigationNavInfo 的 navState 屬性,取得目前的導航狀態,可能為下列其中一種:

  • Enroute:GMSNavigationNavStateEnroute 狀態表示導航功能已啟用,且使用者正在行駛於提供的路線上。可查看目前即將進行的行進步驟相關資訊。

  • 重新規劃路線 - GMSNavigationNavStateRerouting 表示導航正在進行中,但導航器正在尋找新路線。由於尚未產生新路線,因此無法提供下一個行進步驟。

  • Stopped - GMSNavigationNavStateStopped 表示導航已結束。舉例來說,當使用者在應用程式中退出導航時,導航就會停止。在範例應用程式中,GMSNavigationNavStateStopped 狀態會清除導航資訊顯示,以免顯示殘留的步驟指示。

車道指引

Navigation SDK 會將導航轉彎資訊卡中的車道,表示為 GMSNavigationLane 和 GMSNavigationLaneDirection 資料物件。GMSNavigationLane 物件代表導航期間的特定車道,並包含 GMSNavigationLaneDirection 物件清單,說明可從這個車道進行的所有轉彎。

駕駛人在車道上應行駛的建議方向,會以 recommended 欄位標示。

車道指引範例

以下程式碼片段說明上一個螢幕截圖中顯示的車道資料表示法。

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

車道指引圖片

Navigation SDK 支援為 GMSNavigationStepInfo 傳達的每個導航步驟生成車道圖片。這些圖示符合 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];
      

建立動作圖示

行車指示圖示

GMSNavigationManeuver 列舉定義了導航期間可能發生的每個動作,您可以從 GMSNavigationStepInfo 的 maneuver 屬性取得特定步驟的動作。

您必須建立行車動作圖示,並與相關聯的行車動作配對。對於某些行進動作,您可以設定與圖示的一對一對應,例如 GMSNavigationManeuverDestinationLeft 和 GMSNavigationManeuverDestinationRight。不過,由於某些行進動作與其他行進動作有共同特徵,您可能需要將多個行進動作對應至單一圖示。例如,GMSNavigationManeuverTurnLeft 和 GMSNavigationManeuverOnRampLeft 都可以對應到左轉圖示。

部分行進方向會包含額外的「Clockwise」或「CounterClockwise」標籤,由 SDK 根據國家/地區的行車方向決定。舉例來說,在靠左行駛的國家/地區,駕駛人會以順時針方向行經圓環或迴轉,而在靠右行駛的國家/地區,則會以逆時針方向行經圓環或迴轉。Navigation SDK 會偵測行車方向是靠左或靠右,並輸出適當的行車方向。因此,順時針和逆時針操作的圖示可能不同。

展開即可查看不同動作的範例圖示

範例圖示 即時路線導航
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

使用生成的圖示

Navigation SDK 支援為特定 GMSNavigationStepInfo 生成行進圖示。這些圖示符合 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];