RoutePreviewNavigationTemplate

@CarProtocol
public final class RoutePreviewNavigationTemplate implements Template

A template that supports showing a list of routes alongside a custom drawn map.

The list must have its ItemList.OnSelectedListener set, and the template must have its navigate action set (see setNavigateAction). These are used in conjunction to inform the app that:

1. A route has been selected. The app should also highlight the route on the map surface.
2. A navigate action has been triggered. The app should begin navigation using the selected route.

The template itself does not expose a drawing surface. In order to draw on the canvas, use setSurfaceCallback.

• The previous template is in a loading state (see setLoading, or
• The template title has not changed, and the number of rows and the title (not counting spans) of each row between the previous and new ItemLists have not changed.

Note that specifically, this means the app should not use this template to continuously refresh the routes as the car moves.

In order to use this template your car app MUST declare that it uses the androidx.car.app.NAVIGATION_TEMPLATES permission in the manifest.

RoutePreviewNavigationTemplate template = new RoutePreviewNavigationTemplate
 .Builder()
         .setItemList(new ItemList.Builder()
                 .addItem(new Row.Builder()
                     .setTitle(title))
                     .build())
                 .build())
         .setHeader(header)
         .setNavigateAction(new Action.Builder()
                 .setTitle("drive")
                 .setOnClickListener(() -> {})
                 .build())
         .setActionStrip(actionStrip)
         .setMapActionStrip(mapActionStrip)
         .build();

MapWithContentTemplate template = new MapWithContentTemplate.Builder()
             .setContentTemplate(new ListTemplate.Builder()
                    .setSingleList(new ItemList.Builder()
                         .addItem(new Row.Builder()
                              .setTitle(title))
                              .addAction(new Action.Builder()
                                     .setTitle("drive")
                                     .setOnClickListener(() -> {})
                                     .build())
                              .build())
                         .build()))
                    .setHeader(header)
                    .build())
             .setActionStrip(actionStrip)
             .setMapController(new MapController.Builder()
                   .setMapActionStrip(mapActionStrip)
                   .build())
             .build();

Summary

public boolean equals(@Nullable Object other)

public @Nullable ActionStrip getActionStrip()

@RequiresCarApi(value = 5)
public @Nullable Header getHeader()

public @Nullable Action getHeaderAction()

public @Nullable ItemList getItemList()

@RequiresCarApi(value = 4)
public @Nullable ActionStrip getMapActionStrip()

public @Nullable Action getNavigateAction()

@RequiresCarApi(value = 4)
public @Nullable PanModeDelegate getPanModeDelegate()

public @Nullable CarText getTitle()

public int hashCode()

public boolean isLoading()

public @NonNull String toString()