Skip to main content
For the complete documentation index, see llms.txt.

Legacy navigation screens

Deprecated screens

The FREE_DRIVE, ROUTE_PREVIEW, and ACTIVE_GUIDANCE screens are deprecated. On Car API Level 7 and higher, use the unified NAVIGATION screen instead. Continue using these separate screens on lower Car API levels.

The legacy Android Auto navigation experience uses a separate screen for each stage: free drive, route preview, and active guidance. This guide describes those screens for apps supporting Car API levels below 7.

Free drive​

Once MapboxNavigation is configured and location permissions have been accepted, you can start the FREE_DRIVE screen. This screen follows the current location with the CarNavigationCamera and shows the current location with the CarLocationRenderer. The MapboxMapActionStrip enables pan and zoom gestures for the map.

Use FreeDriveActionStrip to build Action buttons.

Route preview​

When a route is received, the result is presented with the ROUTE_PREVIEW screen. The user can select an alternative route or go back to the search screen. Active guidance begins after the user taps the selected route. You can use the implementations in the route preview package.

Active guidance​

ACTIVE_GUIDANCE provides turn-by-turn instructions to reach a destination. To build your own turn-by-turn experience, use the components in the navigation package. You can also request changes to Mapbox's Navigation SDK for Android.

Was this page helpful?