Google is committed to advancing racial equity for Black communities. See how.

NavigationTemplate

public class NavigationTemplate
extends Object implements Template

java.lang.Object
   ↳ com.google.android.libraries.car.app.navigation.model.NavigationTemplate


A template for showing navigation information.

This template has two independent sections which can be updated:

  • Navigation information such as routing instructions or navigation-related messages.
  • Travel estimates to the destination.

To update the template as the user navigates, call Screen.invalidate() to provide the host with a new template with the updated information.

The template itself does not expose a drawing surface. In order to draw on the canvas, use AppManager.setSurfaceListener(SurfaceListener).

See CarAppExtender for how to show alerts with notifications. Frequent alert notifications distract the driver and are discouraged.

Template Restrictions

In regard to template refreshes, as described in Screen.getTemplate(), this template supports any content changes as refreshes. This allows apps to interactively update the turn-by-turn instructions without the templates being counted against the template quota.

Further, this template is considered a view that the user will stay and consume contents from, and the host will reset the template quota once an app reaches this template.

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

Summary

Nested classes

class NavigationTemplate.Builder

A builder of NavigationTemplate

interface NavigationTemplate.NavigationInfo

Represents navigation information such as routing instructions or navigation-related messages. 

Public methods

static NavigationTemplate.Builder builder()

Constructs a new builder of NavigationTemplate.

void checkPermissions(Context context)
boolean equals(Object other)
int hashCode()
String toString()

Inherited methods

Public methods

builder

public static NavigationTemplate.Builder builder ()

Constructs a new builder of NavigationTemplate.

Returns
NavigationTemplate.Builder

checkPermissions

public void checkPermissions (Context context)

Parameters
context Context

equals

public boolean equals (Object other)

Parameters
other Object

Returns
boolean

hashCode

public int hashCode ()

Returns
int

toString

public String toString ()

Returns
String