ガイド変更履歴HERE SDK API references
ガイド
  1. 開発者ガイド：HERE SDK for iOS
  2. コンポーネント
  3. iOSのナビゲーション

ナビゲーションの使用を開始する

ナビゲーションはNavigateライセンスでのみ利用できます。

HERE SDKを使用すると、包括的なターン・バイ・ターンナビのエクスペリエンスを構築できます。この機能では、アプリはデバイスの現在の位置情報を計算されたルートと照合して確認し、ジャストインタイムのナビゲーション指示を取得できます。

次のような主要機能があります。

  • 自動レンダリング：カスタマイズされたナビゲーション マップ ビューは、必要に応じて VisualNavigator を使用してレンダリングできます。startRendering() が呼び出されると、現在の方向を示す事前設定された矢印型の MapMarker3D インスタンスが追加され、着信した位置情報の更新がスムーズに補間されます。また、マップの向きが最適なデフォルト値に変更されます。

  • トラッキング モード：追随するルートがない場合でも、HERE SDK ではトラッキング モードがサポートされており、現在の道路、マップマッチングした場所の他、制限速度などの補足情報が提供されます。

  • リアルタイムの指示：音声ガイダンスは運転操作通知として提供され、任意のプラットフォームのTTS (音声合成) ソリューションにStringとして送信できます。

  • 警告のサポート：制限速度、トラック制約、道路標識などの警告を含む包括的な警告システムを使って、常に注意を促すことができます。

  • オフライン サポート：オフライン マップ データがキャッシュ、インストール、またはプリロードされている場合、ほぼすべてのナビゲーション機能はインターネット接続なしでも動作します。オンライン接続を必要とする機能は、DynamicRouteEngine を使用して交通状況に最適化されたルートをオンラインで検索するなど、ごく一部です。

ターン・バイ・ターンナビの基本原理は、速度と方位の値を含む位置情報を頻繁に受信し、それを道路と照合して目的のルートと比較することです。運転操作指示が与えられ、現在地から目的地に案内します。

ルートを離れると、逸脱がメートル単位で通知されます。この通知は、新しいルートを計算するかを決定するうえで役立ちます。最後に、位置シミュレーターを使用すると、開発フェーズでルート ナビゲーションをテストできます。

注

ターン・バイ・ターンナビを使用するアプリケーション開発者は、安全で正確な動作を確実に提供できるよう、予想されるすべての使用シナリオでアプリケーションを徹底的にテストする必要があります。アプリケーション開発者は、以下のような義務をアプリケーション ユーザーに告知する責任があります。

  • 危険または違法な状況につながる可能性のある指示には従わないでください。
  • 現地のすべての法律に従ってください。
  • 運転中の携帯電話やその一部の機能の使用が禁止されている場合があります。
  • 運転中は常に両手で車を運転できる状態でいる必要があります。
  • 運転中は交通安全を最優先してください。

仕組み

  1. ナビゲーションを開始する主なエントリー ポイントは 2 つあります。
    1. Navigator クラスは、Location データに対応するすべての機能を提供します。これは、ルート案内を表示してルートを追随しながら、一般道路に沿ってあらゆる種類の情報を取得できる広範な警告システムを提供します。後者は、ルートを追随せずにトラッキング モードでも使用できます。
    2. VisualNavigator クラスは、ヘッドレス Navigator と同じ機能を提供しますが、上部では事前設定された 3D マップ ビュー エクスペリエンスを提供します。上部には、交差点表示とその他のオプションの視覚要素が表示されます。
  2. Location データを提供する必要があります。独自のソリューションを使用するか、HERE SDK を使用します。詳細については、「Get Locations」 (位置情報を取得する) ガイドをご覧ください。
  3. 音声ガイダンスは、オプションの音素サポートと Natural Guidance 情報を使用してテキストの指示を表示することでサポートされます。これらの文字列は利用可能な TTS 機能 (サード パーティまたはネイティブ OS) で使用できます。
  4. RoutePrefetcher を使用して、接続が十分でない状況でのエクスペリエンスを最適化するか、オフライン マップをダウンロードおよびインストールすると、インターネット接続がなくてもナビゲートできます。

Navigator または VisualNavigator を初期化する

VisualNavigator を使用すると HERE SDK は、既存のビジュアル エクスペリエンスを提供してルート案内を開始できます。このコンポーネントは、ルートを進んでいる間の進行状況を示すために必要なすべてのビットを含むマップ ビューを作成します。オプションで、ビューをカスタマイズしたり、ヘッドレス Navigator を使用してレンダリングしたりできます。

VisualNavigator と同様に Navigator を次のように初期化できます。

do {
    try visualNavigator = VisualNavigator()
} catch let engineInstantiationError {
    fatalError("Failed to initialize VisualNavigator. Cause: \(engineInstantiationError)")
}

ナビゲーション イベントをリッスンする

目的地へのナビゲートを開始するには、次の 2 つのことが必要です。

  1. 追随する Route。ナビゲーションを開始するには、Route を Navigator または VisualNavigator インスタンスに設定する必要があります。
  2. ドライバーの現在地を Navigator または VisualNavigator インスタンスに定期的に知らせる位置情報ソース。

ルートを計算済みでない場合は作成します。Route インスタンスの取得については、こちらを参照してください。トラッキング モードのみでアプリを起動する場合は、この手順を省略できます。

注

ターン・バイ・ターンナビ中は、Navigator または VisualNavigator インスタンスからのすべての Maneuver 情報が取得され、現在の Location と同期されます。ナビゲーション中は、ManueverデータをRouteオブジェクトから直接取得しないようにしてください。

以下のコード スニペットは、Route から取得された、シミュレートされた Location イベントを使用してシミュレートされたルート案内を開始するために必要なすべてのコードを示しています。これは、VisualNavigator インスタンス使用しているため、stopRendering() が呼び出されるまで、HERE SDK がレンダリング部分を引き継ぎます。

private func startGuidance(route: Route) {
    do {
        // Without a route set, this starts tracking mode.
        try visualNavigator = VisualNavigator()
    } catch let engineInstantiationError {
        fatalError("Failed to initialize VisualNavigator. Cause: \(engineInstantiationError)")
    }

    // This enables a navigation view including a rendered navigation arrow.
    visualNavigator!.startRendering(mapView: mapView)

    // Hook in one of the many delegates. Here we set up a delegate to get instructions on the maneuvers to take while driving.
    // For more details, please check the "Navigation" example app and the Developer Guide.
    visualNavigator!.eventTextDelegate = self

    // Set a route to follow. This leaves tracking mode.
    visualNavigator!.route = route

    // VisualNavigator acts as LocationDelegate to receive location updates directly from a location provider.
    // Any progress along the route is a result of getting a new location fed into the VisualNavigator.
    setupLocationSource(locationDelegate: visualNavigator!, route: route)
}

// Conform to EventTextDelegate.
func onEventTextUpdated(_ eventText: heresdk.EventText) {
    print("Maneuver text: \(eventText.text)")
}

private func setupLocationSource(locationDelegate: LocationDelegate, route: Route) {
    do {
        // Provides fake GPS signals based on the route geometry.
        try locationSimulator = LocationSimulator(route: route,
                                                  options: LocationSimulatorOptions())
    } catch let instantiationError {
        fatalError("Failed to initialize LocationSimulator. Cause: \(instantiationError)")
    }

    locationSimulator!.delegate = locationDelegate
    locationSimulator!.start()
}

このコードの引用例では、ガイダンス ビューが開始され、指定した route で定義された目的地に到達するまでの運転指示がコンソールに表示されます (宣言を含む全コードについては、NavigationQuickStart のサンプル アプリを参照してください)。運転指示はドライバーに話しかけるようにできており、「Turn left onto Invalidenstraße in 500 meters」(500 m 先で左折してインヴァリーデン通りに入ります) というような文字列が含まれている場合があります。より詳細な運転指示も提供でき、それらについては、以下のセクションで説明しています。

上の例では、HERE SDK のシミュレーション機能を使用して位置の更新を取得しています。もちろん、実際の位置情報の更新を VisualNavigator にフィードすることもできます。

注

他のエンジンとは異なり、VisualNavigator または Navigator は、事前にキャッシュ、インストール、またはプリロードされていない地域に到達すると自動的にオンライン データをダウンロードしようとします。その逆に、デバイスでオフラインマップデータを利用できる場合は、オンライン接続できるときでも、この地図データを使用します。

位置情報をナビゲーターにフィードする

上に示したとおり、Locationインスタンスを提供する必要があります。これは、現在地を頻繁に更新して取得しないとナビゲーションができないためです。シミュレートされていないデータとシミュレートされた Location データをシステムにフィードする方法をもう一度見てみましょう。

ナビゲーションコンポーネントはポジショニングから切り離されます。プラットフォーム固有のポジショニングソリューションを実装するか、HERE SDKのHEREポジショニング機能を使用するか、あるいはロケーションシミュレーターを設定することにより、新しい位置情報を提供できます。

Locationソースは、位置情報プロバイダーとして設定できます。Navigator または VisualNavigator で呼び出す必要があるのは、onLocationUpdated() のみです。

VisualNavigator に有効な位置情報をフィードするのは、ディベロッパーの責任です。VisualNavigator は、受信した位置情報ごとに、運転操作や予定ルートからの逸脱など、ルート上の進行状況を示す適切なイベントで応答します。結果のイベントは、提供される位置情報信号の精度とバンドによって異なります。

HERE Positioningを使用する場合は、LocationAccuracy.navigationを使用することをお勧めします。これは、ナビゲーションコンテキストで最良の結果が得られるためです。

すべてのイベントはマップマッチングした場所に基づいて行われます。これは、未処理の場所の信号を一番近い一般道路に一致させるためのMapMatcherコンポーネントの呼び出しを組み込んだHERE SDKによって自動的に行われます。MapMatcherを適切に動作させるには、Location.timeパラメーターを設定する必要があります。このパラメーターが設定されていない場合、場所は無視されます。また、Locationオブジェクトごとにbearingパラメーターとspeedパラメーターを指定することが推奨されています。

HERE Positioningを使用したポジショニングプロバイダーの実装はGitHubにあります。これは、HEREPositioningSimulatorクラスを使用してシミュレーションされたLocationイベントを提供し、HEREPositioningProviderクラスを使用してシミュレーションされていないLocationイベントを提供します。

サポートされているすべての HERE Positioning 機能の詳細については、「Positioning」ガイドに従うことをお勧めします。

Navigator および VisualNavigator の両クラスは、位置情報を受信する onLocationUpdated(location:) メソッドを定義する LocationDelegate プロトコルに準じます。

// Now visualNavigator will receive locations from the HEREPositioningProvider.
// Choose a suitable accuracy for the navigation use case.
herePositioningProvider.startLocating(locationDelegate: visualNavigator,
                                      accuracy: .navigation)

トラッキング モードで開始する予定がない場合は、必要に応じて、追随するルートを設定します。

visualNavigator.route = route

バックグラウンドで位置情報の更新を取得する場合は、NSLocationAlwaysAndWhenInUseUsageDescription 権限を追加する必要があります。詳細については、ポジショニング ガイドを参照してください。位置情報の更新を提供する限り、デバイスの画面がロックされている場合やマップ ビューが一時停止されている場合も、すべてのナビゲーション イベントがシームレスに継続して配信されます。

ルート案内を開始および停止する

ターン・バイ・ターンナビは、route が設定され、herePositioningProvider が開始されると自動的に開始しますが、ナビゲーションの停止は想定シナリオによって異なります。

ナビゲーションを停止してトラッキング モードに切り替え (以下参照)、パスを追随しながらマップマッチングした場所を受信するか、トラッキング モードに戻らずにナビゲーションを停止します。前者の場合は、現在の route を nil に設定します。これにより、ターン・バイ・ターンナビ関連のすべてのイベントの伝播だけが停止され、マップマッチングした場所の更新や速度警告情報などを受信するためのイベントは停止されません。希望の目的地に到達すると、ターン・バイ・ターンナビの伝播は自動的に停止します。route を再度設定すると、ターン・バイ・ターンナビ関連のすべてのイベントが再び伝播されます。

トラッキング モードに戻らずにナビゲーションを停止する場合、たとえば、マップマッチングしなかった場所の更新のみを位置情報プロバイダーから直接取得する場合は、VisualNavigator からのイベントの取得をすべて停止することをお勧めします。この場合は、すべてのデリゲートを個別に nil に設定してください。

位置情報プロバイダーの実装を再利用して、アプリで位置情報の更新を消費できます。HERE Positioning を使用すると、複数の LocationDelegate インスタンスを設定できます。

VisualNavigator を使用する場合は stopRendering() を呼び出します。一度呼び出すと、MapView は VisualNavigator でコントロールできなくなります。

  • レンダリング中に変わった可能性のある地図の向き、カメラの距離、傾きなどの設定は更新されません。これらは stopRendering() が呼び出される前の最後の状態に保たれます。たとえば、ガイド中に地図が斜めに表示されていたのであれば、地図は斜めのままになります。そのため、stopRendering() を呼び出した後に、カメラ設定を指定して適用することをお勧めします。
  • 新しい位置情報を引き続き VisualNavigator にフィードしても、地図は現在の位置に移動しなくなります。
  • VisualNavigator が所有するデフォルトまたはカスタムの位置情報インジケーターは再び非表示になります。
  • RouteProgress などの位置情報関連のイベントはすべて、nil デリゲートを設定してサブスクリプションを解除しない限り、配信され続けます。上記を参照してください。

注

VisualNavigator は MapView インスタンスで動作するため、MapView の初期化を解除する前に stopRendering() を呼び出すことをお勧めします。また、LocationSimulator および DynamicRoutingEngine が開始される前にこれらを停止することをお勧めします。ただし、MapView が一時停止された場合、VisualNavigator も停止する必要はありません。VisualNavigator は、MapView が一時停止されるとレンダリングを自動的に停止しMapView が再開されるとレンダリングを開始します (前にレンダリングが VisualNavigator で行われていた場合)。

トラッキングを開始および停止する

VisualNavigator クラスを使用するとターン・バイ・ターンナビを開始、停止することができ、追随するルートを必要としないトラッキング モードに切り替えることもできます。このモードはドライバー アシスタンス モードとも呼ばれます。公共交通機関を除くすべての移動モードで利用できます。公共交通機関のルートをトラッキングに使用すると、安全ではない予期せぬ結果につながる可能性があります。他のすべての移動モードに対応していますが、トラッキングは車の移動モードに最適です。

トラッキングを有効にするには、以下を呼び出します。

visualNavigator.route = nil
herePositioningProvider.startLocating(locationDelegate: visualNavigator,
                                              accuracy: .navigation)

ここでは実際の GPS 位置情報の取得を有効にしていますが (上の例を参照)、LocationSimulator を使用した任意ルートからでも位置を再生できます。

もちろん、route インスタンスを設定せずに VisualNavigator を初期化することも可能です。トラッキング モードのみを使用する場合は、ルートを明示的に nil に設定する必要はありません。

注

トラッキング モードでは、ルートに従う必要がなく発生する NavigableLocationDelegate や SpeedWarningDelegate などのデリゲートのイベントのみを取得できます。一般に、すべての警告がサポートされています。RouteProgressDelegate などの他のデリゲートは、ルートが設定されていない場合はイベントを配信しません。

これにより、デリゲートを有効に保ち、フリー トラッキングとターン・バイ・ターンナビをすぐに切り替えることができます。

トラッキング モードで動作するデリゲートの概要については、「API リファレンス」を参照してください。

トラッキングは、ドライバーが経路をすでに知っているが、現在の道路名や走行中の制限速度などの追加情報を取得する場合に役立ちます。

トラッキングを有効にしている場合は、SpeedBasedCameraBehavior も有効にすることをお勧めします。

visualNavigator.cameraBehavior = SpeedBasedCameraBehavior()

このカメラ モードはカメラの位置を自動的に調整して、現在の運転速度に基づいてマップ ビューを最適化します。

カメラの追跡を停止するには、以下を呼び出します。

visualNavigator.setCameraBehavior(null)

これは、ガイダンス中にジェスチャー処理を一時的に有効にする場合にも役立ちます。ターン・バイ・ターンナビが実行されている場合は、ドライバーの注意をそらすことのないように、トラッキングに自動的に切り替わるようにすることをお勧めします。

運転操作の進行状況イベントを取得する

ナビゲーション中は、通常、いくつかのデリゲートを添付して、ルートの進行状況、現在の位置、次の運転操作について通知されるようにします。HERE SDK では、目的に応じて多数のデリゲートを利用できます。

以下に、進行状況のイベントを取得する方法を示します。

visualNavigator.routeProgressDelegate = self

また、RouteProgressDelegate プロトコルに対応する準拠メソッドを設定します。

// Conform to RouteProgressDelegate.
// Notifies on the progress along the route including maneuver instructions.
func onRouteProgressUpdated(_ routeProgress: RouteProgress) {
    // [SectionProgress] is guaranteed to be non-empty.
    let distanceToDestination = routeProgress.sectionProgress.last!.remainingDistanceInMeters
    print("Distance to destination in meters: \(distanceToDestination)")
    let trafficDelayAhead = routeProgress.sectionProgress.last!.trafficDelay
    print("Traffic delay ahead in seconds: \(trafficDelayAhead)")

    // Contains the progress for the next maneuver ahead and the next-next maneuvers, if any.
    let nextManeuverList = routeProgress.maneuverProgress
    guard let nextManeuverProgress = nextManeuverList.first else {
        print("No next maneuver available.")
        return
    }

    let nextManeuverIndex = nextManeuverProgress.maneuverIndex
    guard let nextManeuver = visualNavigator.getManeuver(index: nextManeuverIndex) else {
        // Should never happen as we retrieved the next maneuver progress above.
        return
    }

    let action = nextManeuver.action
    let roadName = getRoadName(maneuver: nextManeuver, route: visualNavigator.route)
    let logMessage = "'\(String(describing: action))' on \(roadName) in \(nextManeuverProgress.remainingDistanceInMeters) meters."

    if previousManeuverIndex != nextManeuverIndex {
        // Log only new maneuvers and ignore changes in distance.
        showMessage("New maneuver: " + logMessage)
    } else {
        // A maneuver update contains a different distance to reach the next maneuver.
        showMessage("Maneuver update: " + logMessage)
    }

    previousManeuverIndex = nextManeuverIndex
}

routeProgress イベントを使用すると、進行方向の先の次の運転操作にアクセスできます。これには、maneuverIndex を使用します。

// Contains the progress for the next maneuver ahead and the next-next maneuvers, if any.
let nextManeuverList = routeProgress.maneuverProgress
guard let nextManeuverProgress = nextManeuverList.first else {
    print("No next maneuver available.")
    return
}

let nextManeuverIndex = nextManeuverProgress.maneuverIndex
guard let nextManeuver = visualNavigator.getManeuver(index: nextManeuverIndex) else {
    // Should never happen as we retrieved the next maneuver progress above.
    return
}

nextManeuver.actionを使用すると、ユーザーが実行する必要のある運転操作を特定できます。サポートされているManeuverAction列挙型 (enum) のすべてのリストについては、「APIリファレンス」をご覧ください。

注

ナビゲーション中は、ManeuverAction 列挙型 (enum) で示されている運転操作アイコンを視覚的インジケーターとして表示することをお勧めします。一方、Maneuver 指示テキスト (nextManeuver.text) は、移動を開始する前に運転操作をプレビューするリストでの使用により適しています。これらのローカライズされた指示は説明的であり、進行中のガイダンスのコンテキスト外で理解できます。ただし、通常は、オープンソースの HERE アイコン ライブラリにある、対応する ManeuverAction アイコンとともに表示されます。詳細については、ルート検索のセクションを参照してください。

RouteProgressDelegate によって提供されたデータを使って、渡された Route インスタンスの Section ごとに進行状況の詳細情報にアクセスできます。

ルートは、経由地の数と移動モードに基づいて複数のセクションに分割される場合があります。remainingDistanceInMeters と trafficDelay はセクションごとにすでに累積されています。SectionProgress リストの最後のアイテムを確認し、目的地までの全体的な残りの距離と全体的な推定交通遅延時間を取得します。

trafficDelay は Route データが計算された時間に基づいているため、ガイダンス中は交通の遅延が更新されません。この値は、初期データに基づいて進行したセクション上でのみ更新されます。DynamicRoutingEngineを使用すると、現在の交通状況に基づいて最適化されたルートを定期的にリクエストできます。

visualNavigator から取得された maneuver 情報は、次のアクションを示すドライバーへの表示や、このアクションが実行されるまでの距離など役に立つ情報を生成するために使用されます。上の例で示すようなデバッグ目的でない限り、テキスト表現には使用しないことを推奨します。代わりに音声ルート案内を使用します。

運転操作から道路情報を取得する

visualNavigator または navigator から Maneuver を取得した後、Maneuver クラスで、ローカライズされた道路名または道路番号 (高速道路番号など) を表示すると役立つ可能性があります。

次の運転操作の一般道路テキストは、ターン・バイ・ターン運転操作から次のように取得できます。

enum RoadType {
    case highway
    case rural
    case urban
}

func getRoadName(maneuver: Maneuver, route: Route?) -> String {
    let currentRoadTexts = maneuver.roadTexts
    let nextRoadTexts = maneuver.nextRoadTexts

    let currentRoadName = currentRoadTexts.names.defaultValue()
    let currentRoadNumber = currentRoadTexts.numbersWithDirection.defaultValue()
    let nextRoadName = nextRoadTexts.names.defaultValue()
    let nextRoadNumber = nextRoadTexts.numbersWithDirection.defaultValue()

    var roadName = nextRoadName == nil ? nextRoadNumber : nextRoadName

    // On highways, we want to show the highway number instead of a possible road name,
    // while for inner city and urban areas road names are preferred over road numbers.
    if getRoadType(maneuver: maneuver, route: route!) == RoadType.highway {
        roadName = nextRoadNumber == nil ? nextRoadName : nextRoadNumber
    }

    if maneuver.action == ManeuverAction.arrive {
        // We are approaching destination, so there's no next road.
        roadName = currentRoadName == nil ? currentRoadNumber : currentRoadName
    }

    // Nil happens only in rare cases, when also the fallback above is nil.
    return roadName ?? "unnamed road"
}

// Determines the road type for a given maneuver based on street attributes.
// Returns the road type classification (highway, urban, or rural).
func getRoadType(maneuver: Maneuver, route: Route) -> RoadType {
    let sectionIndex = Int(maneuver.sectionIndex)
    let section = route.sections[sectionIndex]
    let spans = section.spans

    // If attributes list is empty then the road type is rural.
    guard !spans.isEmpty else {
        return .rural
    }

    let maneuverSpan: Span

    // Arrive maneuvers are placed after the last span of the route
    // and the span index for them would be greater than the span's list size.
    if maneuver.action == ManeuverAction.arrive {
        maneuverSpan = spans.last!
    } else {
        maneuverSpan = spans[Int(maneuver.spanIndex)]
    }

    let streetAttributes = maneuverSpan.streetAttributes

    // If attributes list contains either CONTROLLED_ACCESS_HIGHWAY, or MOTORWAY or RAMP then the road type is highway.
    // Check for highway attributes.
    if streetAttributes.contains(.controlledAccessHighway) ||
       streetAttributes.contains(.motorway) ||
       streetAttributes.contains(.ramp) {
        return .highway
    }

    // If attributes list contains BUILT_UP_AREA then the road type is urban.
    // Check for urban attributes.
    if streetAttributes.contains(.builtUpArea) {
        return .urban
    }

    // If the road type is neither urban nor highway, default to rural for all other cases.
    return .rural
}

デフォルトの道路テキストは、上に示したように currentRoadTexts.names.defaultValue 経由で直接取得できます。ほとんどの場合、これは現地の標識に示されている道路名になります。

あるいは、currentRoadTexts.names.preferredValue(for: [locale]) 経由で優先言語のリストに基づいてローカライズされた道路名のテキストを取得することもできます。利用可能な言語がない場合は、デフォルトの言語が返されます。

注

RoadTextsDelegate を使用すると、トラッキング モード時など、走行している現在の RoadTexts に関する通知を受け取ることができます。

デバイスの GPS センサーから取得する位置情報が不正確である場合があるため、VisualNavigator は、NavigableLocation オブジェクトの一部として取得されるマップマッチングした場所を内部的に計算します。この位置情報は、道路などのナビゲーション可能な経路上にあると想定されます。ただし、ユーザーが道路から離れたときや、GPS 信号が弱すぎてマップマッチングする場所を見つけることができない場合は、軌道から外れてしまうことがあります。

マップマッチングした場所を使用して、ユーザーに視覚的なフィードバックを提供することをお勧めします。ユーザーがオフロードを走行しているときなど、位置情報がマップマッチングできなかった場合にのみ、マッチングしなかった originalLocation にフォールバックすると役立ちます。以下では、VisualNavigator のレンダリング機能を使用して、マップ ビューを自動的に更新するようにしています。

注

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

高速道路などの一部の道路には名前がありません。そのような場合は代わりに、道路番号を取得できる可能性があります。国によっては、道路に名前がない場合もあります。

以下の表は、運転操作の属性の使用方法を示しています。

運転操作の属性RoutingEngineNavigator/VisualNavigator例
maneuver.text空でない文字列を提供します。空でない文字列を提供します。text の出力例：「Turn right onto Detmolder Straße towards A100. (右折してデットモルダー通りに入り、A100 に向かいます)」
maneuver.roadTexts空の文字列を提供します。空でない文字列を提供します。roadTexts.names.defaultValue() の出力例："Stadtring" (シュタットリング)。
maneuver.nextRoadTexts空の文字列を提供します。空でない文字列を提供します。nextRoadTexts.names.defaultValue() の出力例："Halenseestraße" (ハレンゼー)。
maneuver.exitSignTexts空の文字列を提供します。空でない文字列を提供します。exitSignTexts.defaultValue() の出力例："Hamburg" (ハンブルク)。

注

上のイベントを自分でトリガーする必要はありません。代わりに VisualNavigator は、位置情報プロバイダーの実装から提供された位置情報に反応します。

ナビゲーション中のETAおよび交通情報を更新する

到着予定時刻 (ETA) は、TrafficOnRouteオブジェクトをNavigatorまたはVisualNavigatorに設定することで更新できます。このため、routingEngine.calculateTrafficOnRoute(...)を定期的に呼び出すことをお勧めします。

詳細については、TrafficOnRouteの「交通情報を更新する」セクションを参照してください。

サポートされている移動モード

ナビゲーションは、PUBLIC_TRANSIT を除き、利用可能なすべての移動モードでサポートされています。公共交通機関のルートをナビゲーションに使用することは、安全ではない予期せぬ結果につながる可能性があります。

移動モードは Route によって異なり、たとえば、徒歩で公園を抜けて観光スポットに行く場合は車を置いて行かなければなりません。ルートが計算されると、移動モードは Route オブジェクトの各 Section に添付されます。

普通車、トラック、タクシー、バス、スクーターのルートではデバイスの位置情報が道路にマップマッチングされますが、歩行者ルートなどの他のモードでは位置情報が未舗装の道路や車ではアクセスできない他のパスにもマッチングされる場合があります。逆に、高速道路のような特定の道路には歩行者はナビゲートされません。自転車ルートでは、高速道路を除き、利用可能なすべてのパスを使用できます。

ナビゲーション サンプル アプリを試す

  • 上のセクションのすべてのコード スニペットは、Navigation のサンプル アプリの一部として GitHub でも入手できます。このアプリは、接続されているコードを表示し、検証可能なドライブ体験に加えてガイダンス中に画面をアクティブに保つなどのベストプラクティスを提供します。

また、GitHubで「NavigationQuickStart」サンプルアプリを確認できます。シミュレートされた位置情報ソースを使用してすばやく開始する方法を確認できます。

GitHubにあるNavigationCustomサンプルアプリも参照してください。このサンプルアプリでは、HERE SDKをセットアップして、カスタムLocationIndicatorで位置をナビゲートすることができます。デフォルトの歩行者およびナビゲーション LocationIndicator アセットの使用状況を示します。また、アプリはカスタム ズーム レベルと傾斜を設定してルート案内ビューをカスタマイズする方法も示します。

7 日前の更新