UI ビルディング ブロックを追加する

このセクションでは、HERE SDKのサービスの一部としてすでに利用可能なさまざまなUI要素と関連するコードスニペットについて説明します。運転操作手順や運転操作アイコンアセットから、視覚的なルート表現まで、これらの要素をアプリケーションインターフェースに統合する方法を確認します。今後、再利用可能なUIビルディングブロックの追加が計画されています。

運転指示を取得する

Routeオブジェクトの各Sectionには、目的地に到達するためにユーザーが従う必要がある運転指示が含まれています。それぞれの右左折では、Maneuverオブジェクトに運転操作を実行する必要がある場所とアクションが含まれます。アクションは、「出発」などのアクションや「左折」などの指示を示す場合があります。

let sections = route.sections
for section in sections {
    logManeuverInstructions(section: section)
}

セクションごとの運転指示にアクセスするコードは次のとおりです。

private func logManeuverInstructions(section: heresdk.Section) {
    print("Log maneuver instructions per route section:")
    let maneuverInstructions = section.maneuvers
    for maneuverInstruction in maneuverInstructions {
        let maneuverAction = maneuverInstruction.action
        let maneuverLocation = maneuverInstruction.coordinates
        let maneuverInfo = "\(maneuverInstruction.text)"
            + ", Action: \(maneuverAction)"
            + ", Location: \(maneuverLocation)"
        print(maneuverInfo)
    }
}

これは、ルート全体を書面で説明する運転指示リストを簡単に作成するのに役立ちます。たとえば、ManeuverAction列挙型を使用して、独自のルート検索エクスペリエンスを構築できます。

スクリーンショット:運転指示を含むルートのプレビューが表示されている画面の例。

注 (Navigateにのみ適用)

ナビゲーション中のManeuver指示テキスト (maneuverInstruction.text) は、NavigatorまたはVisualNavigatorから取得された場合は空になります。これには、Routeインスタンスから取得された場合のローカライズされた指示のみが含まれます。ManeuverAction列挙型は、ナビゲーション中に視覚的なインジケーターを表示するために使用されることが想定されており、テキストによる指示は、移動を開始する前に運転指示をプレビューするリストに適しています。

反対に、maneuverInstruction.roadTexts、maneuverInstruction.nextRoadTexts、maneuverInstruction.exitSignTexts は、ナビゲーション中に経路誘導運転操作の一部として表示されることを意図しているため、Maneuver が Navigator または VisualNavigator から取得された場合には空になりません。Routeインスタンスから取得した場合は、これらの属性は常に空になります。

注 (Exploreにのみ適用)

属性maneuverInstruction.roadTexts、maneuverInstruction.nextRoadTexts、maneuverInstruction.exitSignTextsはナビゲーション中に経路誘導運転操作の一部として表示されることを目的としているため、Navigateなどのライセンスを持つユーザーのみが使用できます。Routeインスタンスから取得した場合は、これらの属性は常に空になります。

「APIリファレンス」では利用可能な運転操作アクションの概要を確認できます。

以下の表は、すべてのManeuverActionアイテムとプレビューの説明およびアセットの例をまとめたものです。HERE SDK 自体には運転操作アイコンが付属していないことに注意してください。アセットは、オープンソースのHERE Icon Libraryの一部として、さまざまな密度のSVGまたはソリッドPNGとして利用できます。

利用可能な運転操作アクションは、「APIリファレンス」に記載されている順序で並べ替えられています。

運転操作アクション 説明の例 アイコンの例
arrive 「~に到着」などの到着運転操作。中間の経由地の説明の例:「<道路名 | 経由地> に到着」。ルートの目的地の場合:「<道路名 | 目的地名 | 目的地> に到着」。 到着
continueOn 「<道路名>をそのまま走行」などの運転操作を続行します。 そのまま走行
depart 「<道路名>を出発」などの出発運転操作。 出発
enterHighwayFromLeft 左側から高速道路に合流します。これは、ドライバーが右に移動して高速道路に入る必要があることを意味します。このような運転操作は、一般道路の左側 (左側通行) を走行する国でのみ実行されます。 左側から高速道路に合流
enterHighwayFromRight 右側から高速道路に合流します。これは、ドライバーが左に移動して高速道路に入る必要があることを意味します。このような運転操作は、一般道路の右側 (右側通行) を走行する国でのみ実行されます。 右側から高速道路に合流
leftExit 「左側の出口から出て<次の道路名>に合流」などの左側出口運転操作。 左側出口
leftFork 「左車線を走行して<次の道路名>に合流」などの左車線運転操作。 左車線
leftRamp 「左ランプを走行」などの左ランプ運転操作。 左ランプ
leftRoundaboutEnter 「ロータリーに入る」などのロータリー運転操作 (左側通行)。
leftRoundaboutExit1 「ロータリーの最初の出口を出る」などのロータリー運転操作 (左側通行)。 左ロータリー出口 1 アイコン
leftRoundaboutExit10 「ロータリーの10番目の出口を出る」などのロータリー運転操作 (左側通行)。 左ロータリー出口 10 アイコン
leftRoundaboutExit11 「ロータリーの11番目の出口を出る」などのロータリー運転操作 (左側通行)。 左ロータリー出口 11 アイコン
leftRoundaboutExit12 「ロータリーの12番目の出口を出る」などのロータリー運転操作 (左側通行)。 左ロータリー出口 12 アイコン
leftRoundaboutExit2 「ロータリーの2番目の出口を出る」などのロータリー運転操作 (左側通行)。 左ロータリー出口 2 アイコン
leftRoundaboutExit3 「ロータリーの3番目の出口を出る」などのロータリー運転操作 (左側通行)。 左ロータリー出口 3 アイコン
leftRoundaboutExit4 「ロータリーの4番目の出口を出る」などのロータリー運転操作 (左側通行)。 左ロータリー出口 4 アイコン
leftRoundaboutExit5 「ロータリーの5番目の出口を出る」などのロータリー運転操作 (左側通行)。 左ロータリー出口 5 アイコン
leftRoundaboutExit6 「ロータリーの6番目の出口を出る」などのロータリー運転操作 (左側通行)。 左ロータリー出口 6 アイコン
leftRoundaboutExit7 「ロータリーの7番目の出口を出る」などのロータリー運転操作 (左側通行)。 左ロータリー出口 7 アイコン
leftRoundaboutExit8 「ロータリーの8番目の出口を出る」などのロータリー運転操作 (左側通行)。 左ロータリー出口 8 アイコン
leftRoundaboutExit9 「ロータリーの9番目の出口を出る」などのロータリー運転操作 (左側通行)。 左ロータリー出口 9 アイコン
leftRoundaboutPass 「ロータリーを通過する」などのロータリー運転操作 (左側通行)。 左ロータリーを通過アイコン
leftTurn 「<次の道路名>を左折」などの左折運転操作。 左折アイコン
leftUTurn 「<次の道路名>でUターン」などの左Uターン運転操作。 左 U ターンアイコン
middleFork 「中央車線を走行して<次の道路名>に合流」などの中央車線運転操作。 中央車線アイコン
rightExit 「右側の出口から出て<次の道路名>に合流」などの右側出口運転操作。 右側出口アイコン
rightFork 「右車線を走行して<次の道路名>に合流」などの右車線運転操作。 右車線アイコン
rightRamp 「右ランプを走行」などの右ランプ運転操作。 右ランプ アイコン
rightRoundaboutEnter 「ロータリーに入る」などのロータリー運転操作 (右側通行)。 右側ロータリー進入アイコン
rightRoundaboutExit1 「ロータリーの最初の出口を出る」などのロータリー運転操作 (右側通行)。 右側ロータリー出口 1 アイコン
rightRoundaboutExit10 「ロータリーの10番目の出口を出る」などのロータリー運転操作 (右側通行)。 右側ロータリー出口 10 アイコン
rightRoundaboutExit11 「ロータリーの11番目の出口を出る」などのロータリー運転操作 (右側通行)。 右側ロータリー出口 11 アイコン
rightRoundaboutExit12 「ロータリーの12番目の出口を出る」などのロータリー運転操作 (右側通行)。 右ロータリー出口 12 アイコン
rightRoundaboutExit2 「ロータリーの2番目の出口を出る」などのロータリー運転操作 (右側通行)。 右ロータリー出口 2 アイコン
rightRoundaboutExit3 「ロータリーの3番目の出口を出る」などのロータリー運転操作 (右側通行)。 右ロータリー出口 3 アイコン
rightRoundaboutExit4 「ロータリーの4番目の出口を出る」などのロータリー運転操作 (右側通行)。 右ロータリー出口 4 アイコン
rightRoundaboutExit5 「ロータリーの5番目の出口を出る」などのロータリー運転操作 (右側通行)。 右ロータリー出口 5 アイコン
rightRoundaboutExit6 「ロータリーの6番目の出口を出る」などのロータリー運転操作 (右側通行)。 右ロータリー出口 6 アイコン
rightRoundaboutExit7 「ロータリーの7番目の出口を出る」などのロータリー運転操作 (右側通行)。 右ロータリー出口 7 アイコン
rightRoundaboutExit8 「ロータリーの8番目の出口を出る」などのロータリー運転操作 (右側通行)。 右ロータリー出口 8 アイコン
rightRoundaboutExit9 「ロータリーの9番目の出口を出る」などのロータリー運転操作 (右側通行)。 右ロータリー出口 9 アイコン
rightRoundaboutPass 「ロータリーを通過する」などのロータリー運転操作 (右側通行)。 右側ロータリー通過アイコン
rightTurn 「<次の道路名>を右折」などの右折運転操作。 右折アイコン
rightUTurn 「<次の道路名>で右Uターン」などの右Uターン運転操作。 右 U ターンアイコン
sharpLeftTurn 「左に急旋回して<次の道路名>に合流」などの左急旋回運転操作。 急な左折アイコン
sharpRightTurn 「右に急旋回して<次の道路名>に合流」などの右急旋回運転操作。 急な右折アイコン
slightLeftTurn 「道なりに左側を進んで<次の道路名>に合流」などの道なり左側走行運転操作。 わずかに左折アイコン
slightRightTurn 「道なりに右側を進んで<次の道路名>に合流」などの道なり右側走行運転操作。 わずかに右折アイコン

現時点では、leftRoundaboutPassとrightRoundaboutPassのHEREアセットはSVGとしてのみ利用可能であり、一部の運転操作アセットはサブフォルダー「wego-fallback-roundabout」でのみ利用できます。

道路標識アイコンを取得する

iconProvider.createRoadShieldIcon(...)を使用すると、「A7」や「US-101」などの道路番号がマップ ビューにすでに表示されているように、非同期でBitmapを作成できます。

道路標識アイコンの作成はオフラインで行われ、インターネット接続は必要ありません。アイコンの作成に必要なデータは、Route自体から取得されますが、手動で入力することもできます。

道路標識アイコンの例。

運転操作プレビューに表示される道路標識の実装例は「Rerouting」サンプルの一部です。入手するには、GitHubのサンプルアプリリポジトリにアクセスします。これにはHERE SDK (Navigate)が必要ですが、IconProviderのコードは他のライセンスでも使用でき、たとえば、ルートプレビューの一部として道路標識アイコンを表示できます。

再利用可能な運転操作パネルと速度制限ビュー(Navigateのみ)

次のサンプルアプリでは、独自のナビゲーションエクスペリエンスに合わせて調整できる、再利用可能なUIビルディングブロックを紹介しています。

  • 運転操作パネルビュー:Rerouting (iOS Swift)サンプルアプリを参照してください。ガイダンス中は、右左折の指示、運転操作アイコン、道路標識アイコンが表示されます。
  • 速度制限ビュー:TruckGuidance (iOS Swift)サンプルアプリを参照してください。ガイダンスUIの一部として、現在のトラックと車の速度制限が表示されます。

運転操作パネルビューを使用する

ターンバイターンナビ中に次の運転操作を表示するには、運転操作アイコン、距離テキスト、道路名をレンダリングできるカスタムビューを作成します。そのビューをマップの上に配置し、VisualNavigatorから更新します。

スクリーンショット:ガイダンス中に運転操作パネルを表示しているReroutingサンプルアプリ。

完全なManeuverModelおよびManeuverView実装はGitHubのReroutingサンプルアプリにあります。

次に、カスタムビューがマップの上に配置され、そのモデルにバインドされます。

@StateObject private var maneuverModel = ManeuverModel()

var body: some View {
  ZStack(alignment: .top) {
    WrappedMapView(mapView: $mapView)
      .edgesIgnoringSafeArea(.all)

    VStack {
      ManeuverView(model: maneuverModel)
        .padding()
    }
  }
}

運転操作データ自体はrouteProgress.maneuverProgressから取得されます。そこから、次のManeuverを解決し、アクション、残り距離、道路名を抽出し、バインドされているモデルを更新します。

次のコードは、次の運転操作を取得してUIモデルを更新するための重要なステップを示しています。

private func parseManeuver(_ maneuverProgress: ManeuverProgress) -> String {
  let nextManeuverIndex = maneuverProgress.maneuverIndex
  guard let nextManeuver = visualNavigator.getManeuver(index: nextManeuverIndex) else {
    return "Error: No next maneuver."
  }

  let action = nextManeuver.action
  let roadName = getRoadName(maneuver: nextManeuver, route: visualNavigator.route)
  let distanceText = convertDistance(meters: maneuverProgress.remainingDistanceInMeters)

  onManeuverEvent(action: action, distanceText: distanceText, roadName: roadName)
  return "Action: \(String(describing: action)) on \(roadName) in \(distanceText)"
}

onManeuverEvent(...)はバインドされているモデルを更新する小さなヘルパーです。

private func onManeuverEvent(action: ManeuverAction, distanceText: String, roadName: String) {
  maneuverModel.isManeuverPanelVisible = true
  maneuverModel.distanceText = distanceText
  maneuverModel.maneuverText = roadName
  maneuverModel.maneuverIcon = maneuverIconProvider.getManeuverIconForAction(action)
}

速度制限ビューを使用する

現在の法定速度制限を表示するには、50、NSL、n/aなど、1つの形式の値を表示する小さなカスタムビューを作成します。そのビューをマップの上に配置し、ナビゲーターによって配信された速度制限イベントから更新します。

スクリーンショット:トラックと車の速度制限インジケーターが表示されているTruckGuidanceサンプルアプリ。

完全なSpeedModelおよびSpeedView実装はGitHubのTruckGuidanceサンプルアプリにあります。

次に、ビューがレイアウトに追加され、モデルにバインドされます。

@StateObject private var truckSpeedLimitModel = SpeedModel()

var body: some View {
  ZStack(alignment: .top) {
    WrappedMapView(mapView: $mapView)
      .edgesIgnoringSafeArea(.all)

    VStack {
      SpeedView(model: truckSpeedLimitModel)
    }
  }
}

速度制限の更新ロジック自体はシンプルです。speedLimit.effectiveSpeedLimitInMetersPerSecond()を読み取り、表示したい単位に値を変換し、バインドされているモデルを更新します。戻り値が0の場合はNSLを表示できます。値が使用できない場合はn/aを表示できます。

次の例は最小限の統合ロジックを示しています。

func onSpeedLimitUpdated(_ speedLimit: heresdk.SpeedLimit) {
  if let currentSpeedLimit = speedLimit.effectiveSpeedLimitInMetersPerSecond() {
    if currentSpeedLimit == 0 {
      truckSpeedLimitModel.speedText = "NSL"
    } else {
      let kmh = Int(metersPerSecondToKilometersPerHour(currentSpeedLimit))
      truckSpeedLimitModel.speedText = "\(kmh)"
    }
  } else {
    truckSpeedLimitModel.speedText = "n/a"
  }
}

アプリケーションでトラックと車の速度制限が区別されている場合は、TruckGuidance サンプルアプリと同じパターンを使用できます。トラック固有の制限にはトラックルートをたどるVisualNavigatorを使用し、同じ場所の対応する車の制限速度を受け取るにはトラッキングモードの2つ目のNavigatorを使用します。

地図にルートを表示する

以下のコードスニペットは、出発地と目的地を含むルートの各座標間に描画されるMapPolylineを使用して地図にルートを表示する方法を示しています。

let routeGeoPolyline = route.geometry
let widthInPixels = 20.0
let polylineColor = UIColor(red: 0, green: 0.56, blue: 0.54, alpha: 0.63)
do {
    let routeMapPolyline =  try MapPolyline(geometry: routeGeoPolyline,
                                            representation: MapPolyline.SolidRepresentation(
                                                lineWidth: MapMeasureDependentRenderSize(
                                                    sizeUnit: RenderSize.Unit.pixels,
                                                    size: widthInPixels),
                                                color: polylineColor,
                                                capShape: LineCap.round))

    mapView.mapScene.addMapPolyline(routeMapPolyline)
} catch let error {
    fatalError("Failed to render MapPolyline. Cause: \(error)")
}

mapView.mapScene.addMapPolyline(routeMapPolyline)

以下の最初のスクリーンショットは、追加の経由地のないルート、つまりルートセクションが1つだけのルートを示しています。出発地と目的地は、緑色の丸のマップ マーカーで示されています。円で囲まれたオブジェクトを描画するコードはここには示されていませんが、興味があればサンプルのソースコードから確認できます。

スクリーンショット:地図上にルートが表示されています。

2番目のスクリーンショットは上記と同じルートを示していますが、赤丸のマップマーカーで示された2つの追加のstopover経由地があります。このため、ルートには3つのルートセクションが含まれています。

スクリーンショット:2つの追加の経由地を含むルートが表示されています。

stopoverで経由地を追加すると、ルートが複数のセクションに分割され、ルートはこれらのポイントを通過して、各ポイントで運転操作指示を生成するように強制されます。

内部的には、MapPolylineのレンダリングが非常に長いルート向けに最適化されていることに注意してください。たとえば、ズームレベルが高ければすべての座標をレンダリングする必要はありませんが、ズームレベルが低いとルート全体が表示されません。このためのアルゴリズムは公開されていませんが、基本原理はHEREのflexible-polylineオープンソースプロジェクトで見ることができます。

ルートにズームする

ユースケースによっては、計算されたルートにズームすると便利な場合があります。カメラクラスには、ルートが収まるようにビューポートを調整する便利なメソッドが用意されています。

let routeGeoBox = route?.boundingBox
camera.lookAt(area: routeGeoBox!,
              orientation: GeoOrientationUpdate(bearing: nil, tilt: nil))

ここでは、ルートオブジェクトの囲みバウンディング ボックスを使用します。これを使用すると、カメラを即座に更新できます。指定されたバウンディング長方形がビューポートに正確に収まるように、カメラのズームレベルとターゲット ポイントが変更されます。さらに、方向を指定してさらに多くのカメラパラメーターを指定することもできます。ここではデフォルト値をそのまま使用します。lookAt()を呼び出すとビューが即座に変更されることに注意してください。

ほとんどのユースケースでは、アニメーションを使用してルートにズームすると、ユーザーエクスペリエンスが向上します。以下に、GeoBoxに50ピクセルの追加のパディングを加えてズームする例を示します。

func animateToRoute(route: Route) {
    // Untilt and unrotate the map.
    let bearing: Double = 0
    let tilt: Double = 0

    // We want to show the route fitting in the map view with an additional padding of 50 pixels.
    let origin:Point2D = Point2D(x: 50.0, y: 50.0)
    let sizeInPixels:Size2D = Size2D(width: mapView.viewportSize.width - 100, height: mapView.viewportSize.height - 100)
    let mapViewport:Rectangle2D = Rectangle2D(origin: origin, size: sizeInPixels)

    // Animate to the route within a duration of 3 seconds.
    let update:MapCameraUpdate = MapCameraUpdateFactory.lookAt(area: route.boundingBox, orientation: GeoOrientationUpdate(GeoOrientation(bearing: bearing, tilt: tilt)), viewRectangle: mapViewport)
    let animation: MapCameraAnimation = MapCameraAnimationFactory.createAnimation(from: update, duration: TimeInterval(3), easing: Easing(EasingFunction.inCubic))
    mapView.camera.startAnimation(animation)
}

CameraKeyframeTracksサンプルアプリでは、これがどのように見えるかを示しています。

ルートに交通情報を表示する

ルート上に交通状況を視覚化する方法については、交通流に沿ってポリラインをレンダリングする方法やカスタムの交通情報オーバーレイなど、「ルート上の交通状況を視覚化する」参照してください。


このページは役に立ちましたか?