ナビゲーションアプリを作成する

このページでは、ターンバイターン方式のナビゲーションアプリの機能を実装するために使用できる、自動車向けアプリライブラリのさまざまな機能について詳しく説明します。

ナビゲーションアプリでは、CarAppService のインテントフィルタで自動車アプリのカテゴリとして androidx.car.app.category.NAVIGATION を宣言する必要があります。

<application>
    ...
   <service
       ...
        android:name=".MyNavigationCarAppService"
        android:exported="true">
      <intent-filter>
        <action android:name="androidx.car.app.CarAppService" />
        <category android:name="androidx.car.app.category.NAVIGATION"/>
      </intent-filter>
    </service>
    ...
</application>

アプリに送信されるナビゲーションインテント（音声クエリを使用して Google アシスタントから取得したものを含む）をサポートするためには、アプリは Session.onCreateScreen と Session.onNewIntent で CarContext.ACTION_NAVIGATE インテントを処理する必要があります。

インテントの形式について詳しくは、CarContext.startCarApp のドキュメントをご覧ください。

ナビゲーションアプリでは、ナビゲーションアプリ専用に設計された以下のテンプレートにアクセスできます。これらのテンプレートはすべて、背景のサーフェスに地図を表示し、ナビゲーション使用時にはターンバイターン方式のルート案内を表示します。

NavigationTemplate: ナビゲーション使用時に任意の情報メッセージと推定所要時間も表示します。
MapTemplate: リスト（ListTemplate にあるようなリスト）またはペイン（PaneTemplate にあるような目立つアクションを伴う詳細情報）のコンパクトなバージョンを表示します。
PlaceListNavigationTemplate: 場所のリストも表示します。これらの場所に対応するマーカーを地図上に描画できます。
RoutePreviewNavigationTemplate: 経路のリストも表示します。経路の一つを選択して、地図上でハイライト表示ができます。

これらのテンプレートを使用してナビゲーションアプリのユーザーインターフェースを設計する方法について詳しくは、ナビゲーションアプリをご覧ください。

ナビゲーションテンプレートにアクセスするには、AndroidManifest.xml ファイルで androidx.car.app.NAVIGATION_TEMPLATES 権限を宣言する必要があります。

<uses-permission android:name="androidx.car.app.NAVIGATION_TEMPLATES"/>

地図を描画する

ナビゲーションアプリは Surface にアクセスして、適用するテンプレート上に地図を描画できます。

SurfaceCallback インスタンスを AppManager 自動車サービスに設定して、SurfaceContainer オブジェクトにアクセスできます。

Kotlin

carContext.getCarService(AppManager::class.java).setSurfaceCallback(surfaceCallback)

Java

carContext.getCarService(AppManager.class).setSurfaceCallback(surfaceCallback);

SurfaceCallback は、SurfaceContainer が利用可能な場合のコールバックのほか、Surface のプロパティが変更された場合の他のコールバックを提供します。

サーフェスにアクセスするには、アプリは AndroidManifest.xml ファイルで androidx.car.app.ACCESS_SURFACE 権限を宣言する必要があります。

<uses-permission android:name="androidx.car.app.ACCESS_SURFACE"/>

地図の表示エリア

ホストはテンプレートのユーザーインターフェース要素を地図上に描画できます。ホストは SurfaceCallback.onVisibleAreaChanged メソッドを呼び出して、遮るものがない、ユーザーに全体が表示されることが確実な領域を伝えます。また、変更回数を最小限に抑えるために、ホストは SurfaceCallback.onStableAreaChanged メソッドを呼び出します。この呼び出しでは現在のテンプレートに基づいて常に表示される最小の長方形が使用されます。

たとえば、ナビゲーションアプリが NavigationTemplate を使用していて、上部にアクションストリップがある場合、ユーザーがしばらく画面を操作しなければアクションストリップ自体を非表示にして、地図用のスペースを確保します。この場合、onStableAreaChanged と onVisibleAreaChanged へのコールバックは同じ長方形で行われます。アクションストリップが非表示になると、onVisibleAreaChanged のみがより大きな領域で呼び出されます。ユーザーが画面を操作すると、最初の長方形で onVisibleAreaChanged のみが再度呼び出されます。

ダークモードをサポートする

条件を満たしているとホストが判断した場合、ナビゲーションアプリは自動車向け Android アプリの品質の説明のとおり、適切な暗い色を使用して Surface インスタンスに地図を再描画する必要があります。

暗い色の地図を描画するかどうかの判断には、CarContext.isDarkMode メソッドを使用できます。ダークモードのステータスが変更されるたびに、Session.onCarConfigurationChanged の呼び出しを受け取ります。

ナビゲーションアプリは、ホストに追加のナビゲーションメタデータを伝える必要があります。ホストはこの情報を使用して、車のヘッドユニットに情報を伝え、共有リソース上のナビゲーションアプリ間の競合を防ぎます。

ナビゲーションメタデータは、CarContext からアクセスできる NavigationManager 自動車サービスより取得できます。

Kotlin

val navigationManager = carContext.getCarService(NavigationManager::class.java)

Java

NavigationManager navigationManager = carContext.getCarService(NavigationManager.class);

ホストが複数のナビゲーションアプリ、経路通知、自動車クラスタデータを管理するためには、ナビゲーションの現在の状態を把握している必要があります。ユーザーがナビゲーションを開始したときには、NavigationManager.navigationStarted を呼び出します。同様に、ユーザーが目的地に到着したときや、ナビゲーションをキャンセルしたときなど、ナビゲーションを終了したときには、NavigationManager.navigationEnded を呼び出します。

NavigationManager.navigationEnded はユーザーがナビゲーションを終了したときのみ、呼び出します。たとえば、ルートの途中で経路を再計算する必要がある場合は、Trip.Builder.setLoading(true) を使用します。

状況によって、ホストは、アプリによるナビゲーションの停止を必要とします。このような場合、NavigationManager.setNavigationManagerCallback を使用してアプリが提供する NavigationManagerCallback オブジェクトの onStopNavigation が呼び出されます。この場合、アプリはクラスタディスプレイ、ナビゲーション通知、音声案内で、次のターンの情報の提供を停止する必要があります。

ルート情報を更新する

ナビゲーション使用時に、NavigationManager.updateTrip を呼び出します。この呼び出しで提供される情報は、車のクラスタディスプレイとヘッドアップディスプレイで使用される場合があります。運転中の車の種類によっては、すべての情報がユーザーに表示されるわけではありません。たとえば、デスクトップヘッドユニット（DHU）には、Trip に追加された Step は表示されますが、Destination 情報は表示されません。

クラスタディスプレイに描画する

車のクラスタディスプレイに基本的なメタデータを表示するだけでなく、さらに臨場感のあるユーザーエクスペリエンスを提供したい場合があります。自動車向けアプリの API レベル 6 以降では、ナビゲーションアプリに独自のコンテンツをクラスタディスプレイ（サポートしている車の場合）に直接レンダリングするオプションがあります。ただし、次の制限があります。

クラスタディスプレイ API は入力コントロールをサポートしていません。
クラスタディスプレイには地図タイルのみが表示されます。これらのタイルには使用中のルートナビゲーションを表示することもできます。
クラスタディスプレイ API は NavigationTemplate の使用のみをサポートしています。
- メインディスプレイとは異なり、クラスタディスプレイにはターンバイターン方式の指示、ETA カード、アクションなどの NavigationTemplate の UI 要素がすべて、常に表示されるとは限りません。地図タイルのみが常に表示される UI 要素です。

クラスタのサポートを宣言する

アプリがクラスタディスプレイでのレンダリングをサポートしていることをホストアプリに伝えるには、次のスニペットのとおり、androidx.car.app.category.FEATURE_CLUSTER <category> 要素を CarAppService の <intent-filter> に追加する必要があります。

<application>
    ...
   <service
       ...
        android:name=".MyNavigationCarAppService"
        android:exported="true">
      <intent-filter>
        <action android:name="androidx.car.app.CarAppService" />
        <category android:name="androidx.car.app.category.NAVIGATION"/>
        <category android:name="androidx.car.app.category.FEATURE_CLUSTER"/>
      </intent-filter>
    </service>
    ...
</application>

ライフサイクルと状態管理

API レベル 6 以降、自動車アプリのライフサイクルフローに変更はありませんが、CarAppService::onCreateSession は作成された Session に関する追加情報を提供する SessionInfo タイプのパラメータを取得するようになりました（すなわち、ディスプレイのタイプとサポートされているテンプレートのセット）。

アプリでは同じ Session クラスを使用して、クラスタとメインディスプレイの両方を処理するか、ディスプレイ固有の Sessions を作成して、各ディスプレイの動作をカスタマイズするか（以下のスニペットをご覧ください）を選択できます。

Kotlin

override fun onCreateSession(sessionInfo: SessionInfo): Session {
  return if (sessionInfo.displayType == SessionInfo.DISPLAY_TYPE_CLUSTER) {
    ClusterSession()
  } else {
    MainDisplaySession()
  }
}

Java

@Override
@NonNull
public Session onCreateSession(@NonNull SessionInfo sessionInfo) {
  if (sessionInfo.getDisplayType() == SessionInfo.DISPLAY_TYPE_CLUSTER) {
    return new ClusterSession();
  } else {
    return new MainDisplaySession();
  }
}

クラスタディスプレイが表示されるタイミングと表示されるか否かは確実ではありません。また、クラスタ Session が唯一の Session になる可能性もあります（たとえば、ユーザーがアプリでナビゲーションを使用中に、メインディスプレイを他のアプリに切り替えた場合）。「標準」の利用規約では、アプリは NavigationManager::navigationStarted が呼び出された後にのみ、クラスタディスプレイをコントロールできるようになります。ただし、ナビゲーションを使用していないときにアプリがクラスタディスプレイに表示される場合や、クラスタディスプレイにまったく表示されない場合もあります。アプリのアイドル状態時の地図タイルをレンダリングして、このようなシナリオに対応するかどうかはアプリによります。

ホストは Session ごとに別々のバインダと CarContext インスタンスを作成します。つまり、ScreenManager::push や Screen::invalidate などのメソッドを使用する場合、呼び出し元の Session のみが影響を受けます。Session をまたぐ通信が必要な場合、アプリはこれらのインスタンス間の独自の通信チャネルを作成する必要があります（たとえば、ブロードキャストや共有シングルトンなどを使用）。

クラスタのサポートをテストする

Android Auto と Android Automotive OS の両方で実装をテストできます。Android Auto の場合は、デスクトップヘッドユニットを構成して、セカンダリクラスタディスプレイをエミュレートすることで、テストできます。Android Automotive OS の場合は、API レベル 30 以上の Generic System Image でクラスタディスプレイをエミュレートします。

テキストまたはアイコンを使用して TravelEstimate をカスタマイズする

推定所要時間をテキスト、アイコン、またはその両方を使ってカスタマイズするには、TravelEstimate.Builder クラスの setTripIcon または setTripText メソッドを使用します。NavigationTemplate では TravelEstimate を使用して、予定到着時刻、残り時間、残りの距離とともに（またはその代わりに）テキストやアイコンを表示することもできます。

次のスニペットでは、setTripIcon と setTripText を使って推定所要時間をカスタマイズしています。

Kotlin

TravelEstimate.Builder(Distance.create(...), DateTimeWithZone.create(...))
      ...
      .setTripIcon(CarIcon.Builder(...).build())
      .setTripText(CarText.create(...))
      .build()

Java

new TravelEstimate.Builder(Distance.create(...), DateTimeWithZone.create(...))
      ...
      .setTripIcon(CarIcon.Builder(...).build())
      .setTripText(CarText.create(...))
      .build();

ターンバイターン通知を提供する

頻繁に更新されるナビゲーション通知を使用して、ターンバイターン（TBT）ナビゲーション指示を提供します。車の画面でナビゲーション通知として処理されるようにするには、通知ビルダーで次のことを行う必要があります。

NotificationCompat.Builder.setOngoing メソッドを使用して、通知を進行中としてマークします。
通知のカテゴリを Notification.CATEGORY_NAVIGATION に設定します。
CarAppExtender を使用して通知を拡張します。

ナビゲーション通知は車の画面下部にあるレールウィジェットに表示されます。通知の重要度レベルが IMPORTANCE_HIGH に設定されている場合は、ヘッドアップ通知（HUN）としても表示されます。CarAppExtender.Builder.setImportance メソッドで重要度が設定されていない場合は、通知チャンネルの重要度が使用されます。

CarAppExtender で PendingIntent を設定すると、ユーザーが HUN またはレールウィジェットをタップしたときにアプリに送信されるようにできます。

値が true の NotificationCompat.Builder.setOnlyAlertOnce が呼び出された場合、重要度の高い通知は HUN で 1 回のみアラートとして表示されます。

次のスニペットは、ナビゲーション通知を作成する方法を示しています。

Kotlin

NotificationCompat.Builder(context, NOTIFICATION_CHANNEL_ID)
    ...
    .setOnlyAlertOnce(true)
    .setOngoing(true)
    .setCategory(NotificationCompat.CATEGORY_NAVIGATION)
    .extend(
        CarAppExtender.Builder()
            .setContentTitle(carScreenTitle)
            ...
            .setContentIntent(
                PendingIntent.getBroadcast(
                    context,
                    ACTION_OPEN_APP.hashCode(),
                    Intent(ACTION_OPEN_APP).setComponent(
                        ComponentName(context, MyNotificationReceiver::class.java)),
                        0))
            .setImportance(NotificationManagerCompat.IMPORTANCE_HIGH)
            .build())
    .build()

Java

new NotificationCompat.Builder(context, NOTIFICATION_CHANNEL_ID)
    ...
    .setOnlyAlertOnce(true)
    .setOngoing(true)
    .setCategory(NotificationCompat.CATEGORY_NAVIGATION)
    .extend(
        new CarAppExtender.Builder()
            .setContentTitle(carScreenTitle)
            ...
            .setContentIntent(
                PendingIntent.getBroadcast(
                    context,
                    ACTION_OPEN_APP.hashCode(),
                    new Intent(ACTION_OPEN_APP).setComponent(
                        new ComponentName(context, MyNotificationReceiver.class)),
                        0))
            .setImportance(NotificationManagerCompat.IMPORTANCE_HIGH)
            .build())
    .build();

距離の変化に応じて TBT 通知を定期的に更新します。これにより、レールウィジェットが更新され、通知は HUN としてのみ表示されます。CarAppExtender.Builder.setImportance で通知の重要度を設定することにより、HUN の動作を制御できます。重要度を IMPORTANCE_HIGH に設定すると、HUN が表示されます。他の値に設定した場合は、レールウィジェットのみ更新されます。

PlaceListNavigationTemplate コンテンツを更新する

ドライバーが PlaceListNavigationTemplate で作成された場所のリストを閲覧しながら、ボタンをタップしてコンテンツを更新できるようにします。リストの更新を有効にするには、OnContentRefreshListener インターフェースの onContentRefreshRequested メソッドを実装し、PlaceListNavigationTemplate.Builder.setOnContentRefreshListener を使用して、テンプレートにリスナーを設定します。

次のスニペットは、テンプレートにリスナーを設定する方法を示しています。

Kotlin

PlaceListNavigationTemplate.Builder()
    ...
    .setOnContentRefreshListener {
        // Execute any desired logic
        ...
        // Then call invalidate() so onGetTemplate() is called again
        invalidate()
    }
    .build()

Java

new PlaceListNavigationTemplate.Builder()
        ...
        .setOnContentRefreshListener(() -> {
            // Execute any desired logic
            ...
            // Then call invalidate() so onGetTemplate() is called again
            invalidate();
        })
        .build();

更新ボタンは、リスナーに値がある場合にのみ、PlaceListNavigationTemplate のヘッダーに表示されます。

ユーザーが更新ボタンをクリックすると、OnContentRefreshListener 実装の onContentRefreshRequested メソッドが呼び出されます。onContentRefreshRequested 内で、Screen.invalidate メソッドを呼び出します。次に、ホストはアプリの Screen.onGetTemplate メソッドにコールバックして、更新されたコンテンツを含むテンプレートを取得します。テンプレートの更新について詳しくは、テンプレートのコンテンツを更新するをご覧ください。onGetTemplate から返される次のテンプレートが同じタイプであれば、更新としてカウントされ、テンプレート割り当てにはカウントされません。

音声によるガイダンスを提供する

車載スピーカーでナビゲーションガイダンスを再生するには、アプリで音声フォーカスをリクエストする必要があります。AudioFocusRequest の一部として、使用量を AudioAttributes.USAGE_ASSISTANCE_NAVIGATION_GUIDANCE として設定します。フォーカスゲインも AudioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK として設定します。

Google Play ストアへのアプリの送信時に、アプリのナビゲーション機能を検証するために、アプリで NavigationManagerCallback.onAutoDriveEnabled コールバックを実装する必要があります。このコールバックが呼び出されると、ユーザーがナビゲーションを開始したときに、選択された目的地へのナビゲーションをシミュレートする必要があります。現在の Session のライフサイクルが Lifecycle.Event.ON_DESTROY 状態になると、アプリはこのモードを終了できます。

コマンドラインから以下を実行することで、onAutoDriveEnabled の実装が呼び出されることをテストできます。

adb shell dumpsys activity service CAR_APP_SERVICE_NAME AUTO_DRIVE

例は次のとおりです。

adb shell dumpsys activity service androidx.car.app.samples.navigation.car.NavigationCarAppService AUTO_DRIVE

Android Auto では、デフォルトのナビゲーション自動車アプリは、ユーザーが最後に起動したナビゲーションアプリに対応します。ユーザーがアシスタントを介してナビゲーションコマンドを呼び出した場合や、他のアプリがナビゲーションを開始するインテントを送信した場合に、デフォルトのアプリがナビゲーションインテントを受信します。

ユーザーが地図を操作できるようにする

地図のさまざまな部分を確認するためのズームやパンといった、ユーザーによる地図の操作をサポートする機能を追加できます。テンプレートごとに、自動車向けアプリの最小 API レベル要件が異なります。実装するテンプレートの最小レベルについては、下記の表をご覧ください。

テンプレート	インタラクティビティをサポートする Car App API レベル
`NavigationTemplate`	2
`PlaceListNavigationTemplate`	4
`RoutePreviewNavigationTemplate`	4
`MapTemplate`	5

SurfaceCallback メソッド

SurfaceCallback インターフェースにはさまざまなコールバックメソッドがあり、NavigationTemplate、PlaceListNavigationTemplate、RoutePreviewNavigationTemplate、MapTemplate テンプレートを使って作成した地図にインタラクティビティを追加できます。メソッドには、onClick、onScroll、onScale、onFling があります。このコールバックとユーザー操作との関連については、次の表をご覧ください。

操作	`SurfaceCallback` メソッド	サポートする Car App API レベル
タップ	`onClick`	5
ピンチしてズーム	`onScale`	2
シングルタップドラッグ	`onScroll`	2
シングルタップフリング	`onFling`	2
ダブルタップ	`onScale`（スケーリングファクタはテンプレートホストによって決まる）	2
パンモードの回転ナッジ	`onScroll`（距離ファクタはテンプレートホストによって決まる）	2

マップアクションストリップ

NavigationTemplate、PlaceListNavigationTemplate、RoutePreviewNavigationTemplate、MapTemplate テンプレートでは、地図に関連する操作（拡大 / 縮小、センタリング、コンパスの表示などのアプリで可能な操作）に対応する、マップアクションストリップを設定できます。マップアクションストリップには、タスクの階層を変更することなく更新できる、アイコンのみのボタンを 4 つまで設定できます。このボタンはアイドル状態では非表示になり、アクティブな状態になると再び表示されます。

マップインタラクティビティコールバックを受け取るようにするには、マップアクションストリップに Action.PAN ボタンを追加する必要があります。次のセクションで説明しているとおり、ユーザーがパンボタンを押すと、ホストはパンモードに入ります。

アプリのマップアクションストリップに Action.PAN ボタンを設定しない場合、SurfaceCallback メソッドからユーザー入力を取得できず、ホストで有効になっていたパンモードが終了します。

パンボタンはタッチスクリーンには表示されません。

パンモード

パンモードでは、ノンタッチの入力デバイス（ロータリーコントローラやタッチパッドなど）からのユーザー入力が、テンプレートホストによって適切な SurfaceCallback メソッドに変換されます。パンモードを開始または終了するユーザー操作には、NavigationTemplate.Builder の setPanModeListener メソッドで応答します。ユーザーがパンモードのときは、テンプレートの他の UI コンポーネントを非表示にできます。

安定領域

安定領域は、アイドル状態とアクティブ状態の間に更新されます。速度、速度制限、道路警告などの運転に関連する情報を表示するかどうかは、安定領域のサイズに基づき決定し、地図上の重要な情報がマップアクションストリップによって遮られないようにします。

Alert は、ナビゲーション画面のコンテキストを離れることなく、ドライバーに重要な情報をオプションのアクションとともに表示します。ドライバーに優れたエクスペリエンスを提供するために、Alert は NavigationTemplate 内で機能し、ルートのナビゲーションを妨げることなく、できる限りドライバーが注意散漫にならないようにします。

Alert は NavigationTemplate 内でのみ使用できます。NavigationTemplate の外部でユーザーに通知するには、通知を表示するの説明のとおり、ヘッドアップ通知（HUN）の使用を検討してください。

たとえば、Alert を使用して次のことができます。

交通状況の変化など、現在のナビゲーションに関連する最新情報をドライバーに通知します。
ドライバーに現在のナビゲーションに関する最新情報（スピード違反取締の有無など）を確認します。
ドライバーが途中で誰かを迎えに行くかどうかなど、今後のタスクを提案し、ドライバーがそのタスクを実行するかどうかを確認します。

基本的な形式では、Alert はタイトルと Alert 継続時間で構成されます。継続時間は進行状況バーで表されます。必要に応じて、サブタイトル、アイコン、最大 2 つの Action オブジェクトを追加できます。

Alert が表示されると、ドライバーの操作によって NavigationTemplate から離れても、その情報が別のテンプレートに引き継がれることはありません。Alert がタイムアウトするか、ユーザーが操作を行うか、アプリが Alert を解除するまで、元の NavigationTemplate が維持されます。

アラートを作成する

Alert.Builder を使用して、Alert インスタンスを作成します。

Kotlin

Alert.Builder(
        /*alertId*/ 1,
        /*title*/ CarText.create("Hello"),
        /*durationMillis*/ 5000
    )
    // The fields below are optional
    .addAction(firstAction)
    .addAction(secondAction)
    .setSubtitle(CarText.create(...))
    .setIcon(CarIcon.APP_ICON)
    .setCallback(...)
    .build()

Java

new Alert.Builder(
        /*alertId*/ 1,
        /*title*/ CarText.create("Hello"),
        /*durationMillis*/ 5000
    )
    // The fields below are optional
    .addAction(firstAction)
    .addAction(secondAction)
    .setSubtitle(CarText.create(...))
    .setIcon(CarIcon.APP_ICON)
    .setCallback(...)
    .build();

Alert のキャンセルまたは解除をリッスンするには、AlertCallback インターフェースの実装を作成します。AlertCallback の呼び出しパスは次のとおりです。

Alert がタイムアウトした場合、ホストは AlertCallback.onCancel メソッドを AlertCallback.REASON_TIMEOUT の値を指定して呼び出します。その後 AlertCallback.onDismiss メソッドを呼び出します。
ドライバーが操作ボタンのいずれかをクリックすると、ホストは Action.OnClickListener を呼び出してから、AlertCallback.onDismiss を呼び出します。
Alert がサポートされていない場合、ホストは AlertCallback.onCancel を AlertCallback.REASON_NOT_SUPPORTED の値を指定して呼び出します。Alert は表示されていないため、ホストは AlertCallback.onDismiss を呼び出しません。

アラート時間を構成する

アプリのニーズに合わせて、Alert の時間を選択します。ナビゲーション Alert の推奨時間は 10 秒です。詳しくは、ナビゲーションアラートをご覧ください。

アラートを表示する

Alert を表示するには、アプリの CarContext から利用できる AppManager.showAlert メソッドを呼び出します。

// Show an alert
carContext.getCarService(AppManager.class).showAlert(alert)

現在表示されている Alert の ID と同じ alertId の Alert で showAlert を呼び出すと、何も起こりません。Alert は更新されません。Alert を更新するには、新しい alertId で再作成する必要があります。
現在表示されている Alert とは違う alertId の Alert で showAlert を呼び出すと、現在表示されている Alert が終了します。

アラートを解除する

Alert はタイムアウトやドライバーの操作により自動的に解除されますが、情報が古くなった場合などに Alert を手動で解除することもできます。Alert を解除するには、その Alert の alertId で dismissAlert メソッドを呼び出します。

// Dismiss the same alert
carContext.getCarService(AppManager.class).dismissAlert(alert.getId())

現在表示されている Alert と一致しない alertId で dismissAlert を呼び出した場合、何も起こりません。例外はスローされません。

自動車向けモノのインターネットアプリを作成する

Android Auto のサポートを追加する

ナビゲーション アプリを作成する

マニフェストでナビゲーション サポートを宣言する

ナビゲーション インテントをサポートする

ナビゲーション テンプレートにアクセスする

地図を描画する

Kotlin

Java

地図の表示エリア

ダークモードをサポートする

ナビゲーション メタデータを伝える

Kotlin

Java

ナビゲーションを開始、終了、停止する

ルート情報を更新する

クラスタ ディスプレイに描画する

クラスタのサポートを宣言する

ライフサイクルと状態管理

Kotlin

Java

クラスタのサポートをテストする

テキストまたはアイコンを使用して TravelEstimate をカスタマイズする

Kotlin

Java

ターンバイターン通知を提供する

Kotlin

Java

PlaceListNavigationTemplate コンテンツを更新する

Kotlin

Java

音声によるガイダンスを提供する

ナビゲーションをシミュレートする

デフォルトのナビゲーション自動車アプリ

ユーザーが地図を操作できるようにする

SurfaceCallback メソッド

マップ アクション ストリップ

パンモード

安定領域

コンテキスト内のナビゲーション アラートを表示する

アラートを作成する

Kotlin

Java

アラート時間を構成する

アラートを表示する

アラートを解除する

ナビゲーションアプリを作成する

マニフェストでナビゲーションサポートを宣言する

ナビゲーションインテントをサポートする

ナビゲーションテンプレートにアクセスする

ナビゲーションメタデータを伝える

クラスタディスプレイに描画する

マップアクションストリップ

コンテキスト内のナビゲーションアラートを表示する