In questa sezione viene descritto come utilizzare l'SDK di navigazione con la libreria di app Android for Cars per mostrare l'esperienza di navigazione della tua app nelle unità principali integrate nel cruscotto. Se il sistema di cruscotto di un conducente supporta Android Auto, i conducenti possono utilizzare la tua app direttamente sul display dell'auto collegando il telefono all'unità. La guida vocale viene eseguita anche sugli altoparlanti dell'auto.
La libreria di app Android for Cars consente l'esecuzione delle app Android su Android Auto fornendo una serie di modelli visivi approvati per la sicurezza del conducente. Questi modelli limitano deliberatamente i controlli dell'interfaccia utente nella dashboard a quelli del telefono per ridurre le distrazioni causate dal conducente.
Se abiliti il funzionamento dell'app basata sull'SDK di navigazione con Android Auto, fornisci una vista aggiuntiva per l'esperienza di navigazione.
In questo modo sono disponibili due visualizzazioni mappa: una per il telefono e una per l'unità principale. Entrambi i display ricevono indicazioni da Navigator.java, che corrisponde a un singleton.
Il sistema della dashboard mostra gli elementi interattivi approvati per la sicurezza in modo che il conducente possa raggiungere la destinazione in sicurezza senza distrazioni indebite. Il conducente può anche interagire con le funzionalità specifiche dell'app, ad esempio accettare o rifiutare ordini o visualizzare la posizione del cliente su una mappa. Gli aggiornamenti dello stato degli ordini possono essere visualizzati anche nella dashboard.
Il telefono collegato può continuare a mostrare l'esperienza standard di navigazione con SDK o qualsiasi altra visualizzazione o flusso di lavoro nell'applicazione. In questo modo, puoi continuare a offrire funzionalità personalizzate che potrebbero non funzionare bene sullo schermo dell'auto.
Configura
La prima parte del funzionamento dell'app con Android Auto prevede la configurazione di un servizio per auto con Android Auto e l'attivazione della libreria TurnByTurn nell'app Navigation SDK.
Inizia a usare Android Auto
Prima di iniziare a utilizzare le funzionalità dell'SDK di navigazione progettate per Android Auto, devi configurare un servizio per la tua app affinché Android Auto possa rilevarla.
Segui questi passaggi, tutti disponibili nella documentazione per gli sviluppatori di Android for Cars:
- Acquisisci dimestichezza con le funzionalità di base di Android Auto.
- Installa la libreria di app Android for Cars.
- Configura il file manifest della tua app in modo che includa Android Auto.
- Dichiara nel file manifest un livello minimo di app per auto pari a 1.
- Crea
il tuo
CarAppServicee la tua sessione.
Configurare l'SDK di navigazione
Una volta stabilito il servizio dell'app per auto, puoi iniziare a lavorare con l'SDK di navigazione.
- Configura il tuo progetto, se non hai già integrato l'SDK di navigazione nell'app.
- Attiva il feed con indicazioni di TurnbyTurn per la tua app.
- Campo facoltativo. Utilizza le icone generate dall'SDK di navigazione.
- Disegna la mappa
utilizzando la classe
NavigationViewForAutosulla piattaforma Android Auto Surface fornita nella classeScreen. - Compila il modello di navigazione Android Auto con i dati della libreria TurnbyTurn.
Ora che disponi di un servizio registrato per fornire informazioni di navigazione alla tua app e che quest'ultima può essere connessa ad Android Auto, puoi creare gli altri elementi di navigazione necessari affinché la tua app funzioni correttamente con Android Auto:
- Disegnare la mappa e l'interfaccia utente di navigazione
- Attiva interazione sulla mappa
- Visualizza le indicazioni stradali di navigazione
- Verificare i tipi di manovre corretti
Tracciare la mappa e l'interfaccia utente di navigazione
La classe NavigationViewForAuto esegue il rendering di una mappa e di una UI di navigazione nelle schermate di Android Auto. Offre molte delle stesse funzionalità di NavigationView per i telefoni, ma con interattività limitata. Usa NavigationViewForAuto per disegnare sulla
piattaforma
fornita da Android Auto:
private boolean isSurfaceReady(SurfaceContainer surfaceContainer) {
return surfaceContainer.getSurface() != null
&& surfaceContainer.getDpi() != 0
&& surfaceContainer.getHeight() != 0
&& surfaceContainer.getWidth() != 0;
}
@Override
public void onSurfaceAvailable(@NonNull SurfaceContainer surfaceContainer) {
if (!isSurfaceReady(surfaceContainer)) {
return;
}
virtualDisplay =
getCarContext()
.getSystemService(DisplayManager.class)
.createVirtualDisplay(
VIRTUAL_DISPLAY_NAME,
surfaceContainer.getWidth(),
surfaceContainer.getHeight(),
surfaceContainer.getDpi(),
surfaceContainer.getSurface(),
DisplayManager.VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY);
presentation = new Presentation(getCarContext(), virtualDisplay.getDisplay());
navigationView = new NavigationViewForAuto(getCarContext());
navigationView.onCreate(null);
navigationView.onStart();
navigationView.onResume();
presentation.setContentView(navigationView);
presentation.show();
navigationView.getMapAsync(googleMap -> this.googleMap = googleMap);
}
@Override
public void onSurfaceDestroyed(@NonNull SurfaceContainer surfaceContainer) {
navigationView.onPause();
navigationView.onStop();
navigationView.onDestroy();
presentation.dismiss();
virtualDisplay.release();
}
Attiva l'interazione con la mappa
Per garantire la sicurezza del conducente, Android Auto limita l'interazione con la superficie dello schermo a una
serie di metodi
SurfaceCallback. Utilizza questi callback per supportare un'interazione limitata del conducente con la mappa
sullo schermo del cruscotto. Ad esempio, onClick e onScale corrispondono ai gesti di tocco
e pizzico dell'utente. I callback di interattività devono utilizzare la striscia di azioni della mappa come segue:
Per ricevere callback di interattività delle mappe, l'app deve utilizzare un pulsante Action.PAN.
Per supportare ulteriori azioni dell'utente, aggiungi pulsanti alla barra di azione della mappa.
Attiva i callback della piattaforma
@NonNull
@Override
public Template onGetTemplate() {
return new NavigationTemplate.Builder()
.setActionStrip(new ActionStrip.Builder().build())
.setMapActionStrip(new ActionStrip.Builder().addAction(Action.PAN).build())
.build();
}
Pizzicare lo zoom con un pizzico
@Override
public void onScale(float focusX, float focusY, float scaleFactor) {
CameraUpdate update =
CameraUpdateFactory.zoomBy((scaleFactor - 1),
new Point((int) focusX, (int) focusY));
googleMap.animateCamera(update); // map is set in onSurfaceAvailable.
}
Panoramica
@Override
public void onScroll(float distanceX, float distanceY) {
googleMap.moveCamera(CameraUpdateFactory.scrollBy(distanceX, distanceY));
}
Visualizza indicazioni stradali di navigazione
Questa sezione spiega come impostare un osservatore per i post di navigazione e come compilare le indicazioni di navigazione nel modello della scheda delle svolte.
Il modello di navigazione di Android Auto fornisce una scheda di svolta che mostra informazioni di navigazione relative alla corsa corrente. La libreria TurnByTurn nell'SDK di navigazione fornisce queste informazioni di navigazione, che il codice utilizza per completare il modello di navigazione di Android Auto.
Configurare un osservatore
Nell'esempio seguente, SampleApplication è una classe di applicazione personalizzata che gestisce un oggetto MutableLiveData<NavInfo>. Quando l'osservatore riceve un aggiornamento dall'oggetto navigator, pubblica questo oggetto NavInfo nell'oggetto NavInfoMutableLiveData gestito dalla classe SampleApplication.
L'esempio seguente registra un osservatore per questo oggetto nella sua implementazione dello Screen di Android Auto.
public SampleAndroidAutoNavigationScreen(@NonNull CarContext carContext,
SampleApplication application) {
super(carContext);
getCarContext().getCarService(AppManager.class).setSurfaceCallback(this);
application.getNavInfoMutableLiveData().observe(this, this::processNextStep);
}
Compilare le informazioni di navigazione
Il seguente snippet di codice mostra come completare il modello di Android Auto con le informazioni sui percorsi correnti, tra cui passi, distanze e icone. Per ulteriori informazioni su questi elementi di visualizzazione, consulta Compilare la visualizzazione del feed.
Espandi per vedere l'esempio di codice.
private RoutingInfo currentRoutingInfo;
@NonNull
@Override
public Template onGetTemplate() {
NavigationTemplate.Builder navigationTemplateBuilder =
new NavigationTemplate.Builder()
.setActionStrip(...)
.setMapActionStrip(...)
if (currentRoutingInfo != null) {
navigationTemplateBuilder.setNavigationInfo(currentRoutingInfo);
}
return navigationTemplateBuilder.build();
}
private void processNextStep(NavInfo navInfo) {
if (navInfo == null || navinfo.getCurrentStep() == null) {
return;
}
/**
* Converts data received from the Navigation data feed
* into Android-Auto compatible data structures. For more information
* see the "Ensure correct maneuver types" below.
*/
Step currentStep = buildStepFromStepInfo(navInfo.getCurrentStep());
Distance distanceToStep =
buildDistanceFromMeters(navInfo.getDistanceToCurrentStepMeters());
currentRoutingInfo =
new RoutingInfo.Builder().setCurrentStep(currentStep, distanceToStep).build();
// Invalidate the current template which leads to another onGetTemplate call.
invalidate();
}
private Step buildStepFromStepInfo(StepInfo stepInfo) {
IconCompat maneuverIcon =
IconCompat.createWithBitmap(stepInfo.getManeuverBitmap());
Maneuver.Builder
maneuverBuilder = newManeuver.Builder(
ManeuverConverter
.getAndroidAutoManeuverType(stepInfo.getManeuver()));
CarIcon maneuverCarIcon = new CarIcon.Builder(maneuverIcon).build();
maneuverBuilder.setIcon(maneuverCarIcon);
Step.Builder stepBuilder =
new Step.Builder()
.setRoad(stepInfo.getFullRoadName())
.setCue(stepInfo.getFullInstructionText())
.setManeuver(maneuverBuilder.build());
if (stepInfo.getLanes() != null
&& stepInfo.getLanesBitmap() != null) {
for (Lane lane : buildAndroidAutoLanesFromStep(stepInfo)) {
stepBuilder.addLane(lane);
}
IconCompat lanesIcon =
IconCompat.createWithBitmap(stepInfo.getLanesBitmap());
CarIcon lanesImage = new CarIcon.Builder(lanesIcon).build();
stepBuilder.setLanesImage(lanesImage);
}
return stepBuilder.build();
}
/*
* Constructs a {@code Distance} object in imperial measurement units.
* In a real world scenario, units would be based on locale.
*/
private Distance buildDistanceFromMeters(int distanceMeters) {
// Distance can be negative so set the min distance to 0.
int remainingFeet = (int) max(0, distanceMeters * DistanceConstants.FEET_PER_METER);
double remainingMiles = ((double) remainingFeet) / DistanceConstants.FEET_PER_MILE;
// Only use the tenths place digit if distance is less than 10 miles and show
// feet if distance is less than 0.25 miles.
if (remainingMiles >= DistanceConstants.MIN_MILES_TO_SHOW_INTEGER) {
return Distance.create((int) round(remainingMiles), Distance.UNIT_MILES);
} else if (remainingMiles >= 0.25) {
return Distance.create((int) remainingMiles, Distance.UNIT_MILES);
} else {
return Distance.create(remainingFeet, Distance.UNIT_FEET);
}
}
Assicurati che i tipi di manovre siano corretti
I tipi di manovre utilizzati nella raccolta di Android Auto Car corrispondono a quelle fornite dalla libreria TurnByTurn. Tuttavia, devi convertire le manovre dell'SDK di navigazione in una dichiarazione valida nella libreria di Android Auto Car. La seguente tabella mostra la corrispondenza di alcuni campi, seguiti da un'utilità di conversione di esempio per comodità.
| Manovra della libreria passo passo | Manovra di Android Auto |
|---|---|
DEPART |
TYPE_DEPART |
DESTINATION |
TYPE_DESTINATION |
DESTINATION_LEFT |
TYPE_DESTINATION_LEFT |
DESTINATION_RIGHT |
TYPE_DESTINATION_RIGHT |
TURN_U_TURN_CLOCKWISE |
TYPE_U_TURN_RIGHT |
ON_RAMP_LEFT |
TYPE_ON_RAMP_NORMAL_LEFT |
ON_RAMP_RIGHT |
TYPE_ON_RAMP_NORMAL_RIGHT |
ON_RAMP_SLIGHT_LEFT |
TYPE_ON_RAMP_SLIGHT_LEFT |
FORK_RIGHT |
TYPE_FORK_RIGHT |
Espandi per vedere l'esempio di codice.
import com.google.android.libraries.mapsplatform.turnbyturn.model.Maneuver;
import com.google.common.collect.ImmutableMap;
import javax.annotation.Nullable;
/** Converter that converts between turn-by-turn and Android Auto Maneuvers. */
public final class ManeuverConverter {
private ManeuverConverter() {}
// Map from turn-by-turn Maneuver to Android Auto Maneuver.Type.
private static final ImmutableMap<Integer, Integer> MANEUVER_TO_ANDROID_AUTO_MANEUVER_TYPE =
ImmutableMap.<Integer, Integer>builder()
.put(Maneuver.DEPART, androidx.car.app.navigation.model.Maneuver.TYPE_DEPART)
.put(Maneuver.DESTINATION, androidx.car.app.navigation.model.Maneuver.TYPE_DESTINATION)
.put(
Maneuver.DESTINATION_LEFT,
androidx.car.app.navigation.model.Maneuver.TYPE_DESTINATION_LEFT)
.put(
Maneuver.DESTINATION_RIGHT,
androidx.car.app.navigation.model.Maneuver.TYPE_DESTINATION_RIGHT)
.put(Maneuver.STRAIGHT, androidx.car.app.navigation.model.Maneuver.TYPE_STRAIGHT)
.put(Maneuver.TURN_LEFT, androidx.car.app.navigation.model.Maneuver.TYPE_TURN_NORMAL_LEFT)
.put(
Maneuver.TURN_RIGHT,
androidx.car.app.navigation.model.Maneuver.TYPE_TURN_NORMAL_RIGHT)
.put(Maneuver.TURN_KEEP_LEFT, androidx.car.app.navigation.model.Maneuver.TYPE_KEEP_LEFT)
.put(Maneuver.TURN_KEEP_RIGHT, androidx.car.app.navigation.model.Maneuver.TYPE_KEEP_RIGHT)
.put(
Maneuver.TURN_SLIGHT_LEFT,
androidx.car.app.navigation.model.Maneuver.TYPE_TURN_SLIGHT_LEFT)
.put(
Maneuver.TURN_SLIGHT_RIGHT,
androidx.car.app.navigation.model.Maneuver.TYPE_TURN_SLIGHT_RIGHT)
.put(
Maneuver.TURN_SHARP_LEFT,
androidx.car.app.navigation.model.Maneuver.TYPE_TURN_SHARP_LEFT)
.put(
Maneuver.TURN_SHARP_RIGHT,
androidx.car.app.navigation.model.Maneuver.TYPE_ON_RAMP_SHARP_RIGHT)
.put(
Maneuver.TURN_U_TURN_CLOCKWISE,
androidx.car.app.navigation.model.Maneuver.TYPE_U_TURN_RIGHT)
.put(
Maneuver.TURN_U_TURN_COUNTERCLOCKWISE,
androidx.car.app.navigation.model.Maneuver.TYPE_U_TURN_LEFT)
.put(
Maneuver.MERGE_UNSPECIFIED,
androidx.car.app.navigation.model.Maneuver.TYPE_MERGE_SIDE_UNSPECIFIED)
.put(Maneuver.MERGE_LEFT, androidx.car.app.navigation.model.Maneuver.TYPE_MERGE_LEFT)
.put(Maneuver.MERGE_RIGHT, androidx.car.app.navigation.model.Maneuver.TYPE_MERGE_RIGHT)
.put(Maneuver.FORK_LEFT, androidx.car.app.navigation.model.Maneuver.TYPE_FORK_LEFT)
.put(Maneuver.FORK_RIGHT, androidx.car.app.navigation.model.Maneuver.TYPE_FORK_RIGHT)
.put(
Maneuver.ON_RAMP_UNSPECIFIED,
androidx.car.app.navigation.model.Maneuver.TYPE_ON_RAMP_NORMAL_RIGHT)
.put(
Maneuver.ON_RAMP_LEFT,
androidx.car.app.navigation.model.Maneuver.TYPE_ON_RAMP_NORMAL_LEFT)
.put(
Maneuver.ON_RAMP_RIGHT,
androidx.car.app.navigation.model.Maneuver.TYPE_ON_RAMP_NORMAL_RIGHT)
.put(
Maneuver.ON_RAMP_KEEP_LEFT,
androidx.car.app.navigation.model.Maneuver.TYPE_ON_RAMP_NORMAL_LEFT)
.put(
Maneuver.ON_RAMP_KEEP_RIGHT,
androidx.car.app.navigation.model.Maneuver.TYPE_ON_RAMP_NORMAL_RIGHT)
.put(
Maneuver.ON_RAMP_SLIGHT_LEFT,
androidx.car.app.navigation.model.Maneuver.TYPE_ON_RAMP_SLIGHT_LEFT)
.put(
Maneuver.ON_RAMP_SLIGHT_RIGHT,
androidx.car.app.navigation.model.Maneuver.TYPE_ON_RAMP_SLIGHT_RIGHT)
.put(
Maneuver.ON_RAMP_SHARP_LEFT,
androidx.car.app.navigation.model.Maneuver.TYPE_ON_RAMP_SHARP_LEFT)
.put(
Maneuver.ON_RAMP_SHARP_RIGHT,
androidx.car.app.navigation.model.Maneuver.TYPE_ON_RAMP_SHARP_RIGHT)
.put(
Maneuver.ON_RAMP_U_TURN_CLOCKWISE,
androidx.car.app.navigation.model.Maneuver.TYPE_ON_RAMP_U_TURN_RIGHT)
.put(
Maneuver.ON_RAMP_U_TURN_COUNTERCLOCKWISE,
androidx.car.app.navigation.model.Maneuver.TYPE_ON_RAMP_U_TURN_LEFT)
.put(
Maneuver.OFF_RAMP_LEFT,
androidx.car.app.navigation.model.Maneuver.TYPE_OFF_RAMP_NORMAL_LEFT)
.put(
Maneuver.OFF_RAMP_RIGHT,
androidx.car.app.navigation.model.Maneuver.TYPE_OFF_RAMP_NORMAL_RIGHT)
.put(
Maneuver.OFF_RAMP_KEEP_LEFT,
androidx.car.app.navigation.model.Maneuver.TYPE_OFF_RAMP_SLIGHT_LEFT)
.put(
Maneuver.OFF_RAMP_KEEP_RIGHT,
androidx.car.app.navigation.model.Maneuver.TYPE_OFF_RAMP_SLIGHT_RIGHT)
.put(
Maneuver.OFF_RAMP_SLIGHT_LEFT,
androidx.car.app.navigation.model.Maneuver.TYPE_OFF_RAMP_SLIGHT_LEFT)
.put(
Maneuver.OFF_RAMP_SLIGHT_RIGHT,
androidx.car.app.navigation.model.Maneuver.TYPE_OFF_RAMP_SLIGHT_RIGHT)
.put(
Maneuver.OFF_RAMP_SHARP_LEFT,
androidx.car.app.navigation.model.Maneuver.TYPE_OFF_RAMP_NORMAL_LEFT)
.put(
Maneuver.OFF_RAMP_SHARP_RIGHT,
androidx.car.app.navigation.model.Maneuver.TYPE_OFF_RAMP_NORMAL_RIGHT)
.put(
Maneuver.ROUNDABOUT_CLOCKWISE,
androidx.car.app.navigation.model.Maneuver.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CW)
.put(
Maneuver.ROUNDABOUT_COUNTERCLOCKWISE,
androidx.car.app.navigation.model.Maneuver.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CCW)
.put(
Maneuver.ROUNDABOUT_STRAIGHT_CLOCKWISE,
androidx.car.app.navigation.model.Maneuver.TYPE_ROUNDABOUT_ENTER_CW)
.put(
Maneuver.ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE,
androidx.car.app.navigation.model.Maneuver.TYPE_ROUNDABOUT_ENTER_CCW)
.put(
Maneuver.ROUNDABOUT_LEFT_CLOCKWISE,
androidx.car.app.navigation.model.Maneuver
.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CW_WITH_ANGLE)
.put(
Maneuver.ROUNDABOUT_LEFT_COUNTERCLOCKWISE,
androidx.car.app.navigation.model.Maneuver
.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CCW_WITH_ANGLE)
.put(
Maneuver.ROUNDABOUT_RIGHT_CLOCKWISE,
androidx.car.app.navigation.model.Maneuver
.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CW_WITH_ANGLE)
.put(
Maneuver.ROUNDABOUT_RIGHT_COUNTERCLOCKWISE,
androidx.car.app.navigation.model.Maneuver
.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CCW_WITH_ANGLE)
.put(
Maneuver.ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE,
androidx.car.app.navigation.model.Maneuver
.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CW_WITH_ANGLE)
.put(
Maneuver.ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE,
androidx.car.app.navigation.model.Maneuver
.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CCW_WITH_ANGLE)
.put(
Maneuver.ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE,
androidx.car.app.navigation.model.Maneuver
.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CW_WITH_ANGLE)
.put(
Maneuver.ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE,
androidx.car.app.navigation.model.Maneuver
.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CCW_WITH_ANGLE)
.put(
Maneuver.ROUNDABOUT_SHARP_LEFT_CLOCKWISE,
androidx.car.app.navigation.model.Maneuver
.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CW_WITH_ANGLE)
.put(
Maneuver.ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE,
androidx.car.app.navigation.model.Maneuver
.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CCW_WITH_ANGLE)
.put(
Maneuver.ROUNDABOUT_SHARP_RIGHT_CLOCKWISE,
androidx.car.app.navigation.model.Maneuver
.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CW_WITH_ANGLE)
.put(
Maneuver.ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE,
androidx.car.app.navigation.model.Maneuver
.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CCW_WITH_ANGLE)
.put(
Maneuver.ROUNDABOUT_U_TURN_CLOCKWISE,
androidx.car.app.navigation.model.Maneuver
.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CW_WITH_ANGLE)
.put(
Maneuver.ROUNDABOUT_U_TURN_COUNTERCLOCKWISE,
androidx.car.app.navigation.model.Maneuver
.TYPE_ROUNDABOUT_ENTER_AND_EXIT_CCW_WITH_ANGLE)
.put(
Maneuver.ROUNDABOUT_EXIT_CLOCKWISE,
androidx.car.app.navigation.model.Maneuver.TYPE_ROUNDABOUT_EXIT_CW)
.put(
Maneuver.ROUNDABOUT_EXIT_COUNTERCLOCKWISE,
androidx.car.app.navigation.model.Maneuver.TYPE_ROUNDABOUT_EXIT_CCW)
.put(Maneuver.FERRY_BOAT, androidx.car.app.navigation.model.Maneuver.TYPE_FERRY_BOAT)
.put(Maneuver.FERRY_TRAIN, androidx.car.app.navigation.model.Maneuver.TYPE_FERRY_TRAIN)
.put(Maneuver.NAME_CHANGE, androidx.car.app.navigation.model.Maneuver.TYPE_NAME_CHANGE)
.buildOrThrow();
/** Represents the roundabout turn angle for a slight turn in either right or left directions. */
private static final int ROUNDABOUT_ANGLE_SLIGHT = 10;
/** Represents the roundabout turn angle for a normal turn in either right or left directions. */
private static final int ROUNDABOUT_ANGLE_NORMAL = 45;
/** Represents the roundabout turn angle for a sharp turn in either right or left directions. */
private static final int ROUNDABOUT_ANGLE_SHARP = 135;
/** Represents the roundabout turn angle for a u-turn in either right or left directions. */
private static final int ROUNDABOUT_ANGLE_U_TURN = 180;
/**
* Returns the corresponding {@link androidx.car.app.navigation.model.Maneuver.Type} for the given
* direction {@link Maneuver}
*
* @throws {@link IllegalArgumentException} if the given maneuver does not have a corresponding
* Android Auto Maneuver type.
*/
public static int getAndroidAutoManeuverType(@Maneuver int maneuver) {
if (MANEUVER_TO_ANDROID_AUTO_MANEUVER_TYPE.containsKey(maneuver)) {
return MANEUVER_TO_ANDROID_AUTO_MANEUVER_TYPE.get(maneuver);
}
throw new IllegalArgumentException(
String.format(
"Given turn-by-turn Maneuver %d cannot be converted to an Android Auto equivalent.",
maneuver));
}
/**
* Returns the corresponding Android Auto roundabout angle for the given turn {@link Maneuver}.
* Returns {@code null} if given maneuver does not involve a roundabout with a turn.
*/
@Nullable
public static Integer getAndroidAutoRoundaboutAngle(@Maneuver int maneuver) {
if (maneuver == Maneuver.ROUNDABOUT_LEFT_CLOCKWISE
|| maneuver == Maneuver.ROUNDABOUT_RIGHT_CLOCKWISE
|| maneuver == Maneuver.ROUNDABOUT_LEFT_COUNTERCLOCKWISE
|| maneuver == Maneuver.ROUNDABOUT_RIGHT_COUNTERCLOCKWISE) {
return ROUNDABOUT_ANGLE_NORMAL;
}
if (maneuver == Maneuver.ROUNDABOUT_SHARP_LEFT_CLOCKWISE
|| maneuver == Maneuver.ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
|| maneuver == Maneuver.ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
|| maneuver == Maneuver.ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE) {
return ROUNDABOUT_ANGLE_SHARP;
}
if (maneuver == Maneuver.ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
|| maneuver == Maneuver.ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
|| maneuver == Maneuver.ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
|| maneuver == Maneuver.ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE) {
return ROUNDABOUT_ANGLE_SLIGHT;
}
if (maneuver == Maneuver.ROUNDABOUT_U_TURN_CLOCKWISE
|| maneuver == Maneuver.ROUNDABOUT_U_TURN_COUNTERCLOCKWISE) {
return ROUNDABOUT_ANGLE_U_TURN;
}
return null;
}
}
Documentazione correlata
- Attiva il feed delle indicazioni passo passo: prima di tutto, integra la funzionalità passo passo in modo che l'app possa funzionare con Android Auto.
- Completa la visualizzazione del feed: accedi ai campi di dati per informazioni e utilizza le icone.