In diesem Abschnitt wird beschrieben, wie Sie das Navigation SDK mit der Android for Cars App-Bibliothek verwenden können, um die Navigation Ihrer App auf Head-Units im Armaturenbrett anzuzeigen. Wenn das Infotainmentsystem eines Nutzers Android Auto unterstützt, können Nutzer Ihre App direkt auf dem Display ihres Autos verwenden, indem sie ihr Smartphone mit dem Gerät verbinden. Die Sprachnavigation wird auch über die Lautsprecher des Autos wiedergegeben.
Die Android for Cars App-Bibliothek ermöglicht das Ausführen von Android-Apps in Android Auto. Dazu stellt sie eine Reihe visueller Vorlagen zur Verfügung, die für die Sicherheit des Fahrers zugelassen sind. Bei diesen Vorlagen werden die Steuerelemente der Benutzeroberfläche im Dashboard bewusst auf die des Smartphones beschränkt, um Ablenkungen für den Fahrer zu reduzieren.
Wenn Sie die Funktion „Android Auto“ für Ihre Navigations-SDK-basierte App aktivieren, wird eine zusätzliche Ansicht für die Navigation bereitgestellt.
So können zwei Kartenansichten verwendet werden – eine für das Smartphone und eine für das Infotainmentsystem. Beide Displays erhalten Anweisungen von Navigator.java, einem Singleton.
Das Dashboard-System zeigt die für die Sicherheit zugelassenen interaktiven Elemente an, damit der Nutzer sicher und ohne unnötige Ablenkungen an sein Ziel gelangen kann. Der Nutzer kann auch mit Ihren app-spezifischen Funktionen interagieren, z. B. Bestellungen annehmen oder ablehnen oder den Standort des Kunden auf einer Karte ansehen. Updates zum Bestellstatus können auch im Dashboard angezeigt werden.
Auf dem verbundenen Smartphone wird weiterhin das Navigation SDK oder eine andere Ansicht oder ein anderer Workflow in Ihrer Anwendung angezeigt. So können Sie weiterhin benutzerdefinierte Funktionen anbieten, die auf einem Autodisplay möglicherweise nicht gut funktionieren.
Einrichten
Um Ihre App mit Android Auto verwenden zu können, müssen Sie zuerst einen Autodienst mit Android Auto einrichten und dann die Navigations-SDK-App aktivieren.
Mit Android Auto starten
Bevor Sie mit den Navigation SDK-Funktionen für Android Auto arbeiten können, müssen Sie einen Autodienst für Ihre App einrichten, damit Android Auto sie finden kann.
Führen Sie die folgenden Schritte aus, die alle in der Entwicklerdokumentation zu Android for Cars zu finden sind:
- Machen Sie sich mit den grundlegenden Android Auto-Funktionen vertraut.
- Installieren Sie die Android for Cars-App-Bibliothek.
- Konfigurieren Sie die Manifestdatei Ihrer App so, dass Android Auto enthalten ist.
- Deklarieren Sie in Ihrem Manifest eine Mindestebene für die Auto-App von 1.
- Erstellen Sie Ihr
CarAppServiceund Ihre Sitzung.
Navigation SDK einrichten
Sobald Sie Ihren Auto-App-Dienst eingerichtet haben, können Sie mit dem Navigations-SDK arbeiten.
- Richten Sie Ihr Projekt ein, falls Sie das Navigations-SDK noch nicht in Ihre App eingebunden haben.
- Aktivieren Sie den Feed für die Schritt-für-Schritt-Navigation für Ihre App.
- Optional. Generierte Symbole aus dem Navigation SDK verwenden
- Zeichnen Sie die Karte mit der Klasse
NavigationViewForAutoauf der Android Auto-Oberfläche, die in der KlasseScreenbereitgestellt wird. - Füllen Sie die Android Auto-Navigationsvorlage mit den Daten aus der Navigationsbibliothek auf.
Sie haben jetzt einen registrierten Dienst für die Bereitstellung von Navigationsinformationen für Ihre App und Ihre App kann eine Verbindung zu Android Auto herstellen. Sie können jetzt die restlichen Navigationselemente erstellen, die für die ordnungsgemäße Funktion Ihrer App mit Android Auto erforderlich sind:
- Karten- und Navigationsoberfläche zeichnen
- Karteninteraktionen aktivieren
- Wegbeschreibungen anzeigen
- Richtige Fahrmanöver
Karte und Navigations-UI zeichnen
Die Klasse NavigationViewForAuto rendert eine Karten- und Navigations-UI auf Android Auto-Bildschirmen. Sie bietet viele der Funktionen der NavigationView für Smartphones, aber mit eingeschränkter Interaktivität. Mit NavigationViewForAuto können Sie auf der von Android Auto bereitgestellten Oberfläche zeichnen:
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();
}
Karteninteraktionen aktivieren
Aus Sicherheitsgründen für Fahrer schränkt Android Auto die Interaktion mit der Bildschirmoberfläche auf eine Reihe von SurfaceCallback-Methoden ein. Mit diesen Rückrufen können Sie die Interaktion des Fahrers mit der Karte auf einem Infotainment-Display einschränken. onClick und onScale entsprechen beispielsweise den Gesten Tippen und Zum-Mittelpunkt-Ziehen des Nutzers. Für Interaktivitäts-Callbacks muss der Kartenaktionsstreifen so verwendet werden:
Damit Callbacks für die Karteninteraktivität empfangen werden können, muss Ihre App die Schaltfläche Action.PAN verwenden.
Wenn Sie zusätzliche Nutzeraktionen unterstützen möchten, fügen Sie dem Aktionsstreifen der Karte Schaltflächen hinzu.
Oberflächen-Callbacks aktivieren
@NonNull
@Override
public Template onGetTemplate() {
return new NavigationTemplate.Builder()
.setActionStrip(new ActionStrip.Builder().build())
.setMapActionStrip(new ActionStrip.Builder().addAction(Action.PAN).build())
.build();
}
Mit zwei Fingern zoomen
@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.
}
Schwenken
@Override
public void onScroll(float distanceX, float distanceY) {
googleMap.moveCamera(CameraUpdateFactory.scrollBy(distanceX, distanceY));
}
Navigationsanweisungen anzeigen
In diesem Abschnitt erfahren Sie, wie Sie einen Beobachter für Navigationsposts einrichten und Navigationsanweisungen in der Vorlage für Abbiegeverbote einfügen.
Die Navigationsvorlage für Android Auto enthält eine Abbiegeverstellkarte mit Navigationsinformationen zur aktuellen Fahrt. Die Navigationsinformationen werden von der Navigations-API im Navigation SDK bereitgestellt. Ihr Code verwendet diese Informationen, um die Navigationsvorlage für Android Auto zu füllen.
Beobachter einrichten
Im folgenden Beispiel ist SampleApplication eine benutzerdefinierte Anwendungsklasse, die ein MutableLiveData<NavInfo>-Objekt verwaltet. Wenn der Beobachter eine Aktualisierung vom Navigationsobjekt erhält, sendet er dieses NavInfo-Objekt an das NavInfoMutableLiveData, das von der SampleApplication-Klasse verwaltet wird.
Im folgenden Beispiel wird ein Beobachter für dieses Objekt in der Implementierung des Android Auto-Bildschirms registriert.
public SampleAndroidAutoNavigationScreen(@NonNull CarContext carContext,
SampleApplication application) {
super(carContext);
getCarContext().getCarService(AppManager.class).setSurfaceCallback(this);
application.getNavInfoMutableLiveData().observe(this, this::processNextStep);
}
Navigationsinformationen einfügen
Im folgenden Code-Snippet wird gezeigt, wie die Android Auto-Vorlage mit den aktuellen Informationen zur Routenführung wie Schritten, Entfernungen und Symbolen ausgefüllt wird. Weitere Informationen zu diesen Darstellungselementen finden Sie unter Feedanzeige befüllen.
Maximieren, um das Codebeispiel anzusehen
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);
}
}
Achten Sie darauf, dass Sie die richtigen Manövertypen auswählen.
Die Arten von Fahrmanövern, die in der Android Auto Car-Bibliothek verwendet werden, entsprechen genau den Fahrmanövern, die von der TurnByTurn-Bibliothek bereitgestellt werden. Sie müssen die Navigation SDK-Manöver jedoch in eine gültige Erklärung in der Android Auto Car-Bibliothek umwandeln. In der folgenden Tabelle sehen Sie die Zuordnung für einige Felder. Daran schließt sich ein Beispiel für ein Konvertierungstool an.
| Detaillierte Routenführung | Android Auto-Abbiegevorschlag |
|---|---|
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 |
Maximieren, um das Codebeispiel anzusehen:
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;
}
}
Weitere Dokumentation
- Feed für detaillierte Routenführung aktivieren: Integrieren Sie zuerst die Funktion für die detaillierte Routenführung, damit Ihre App mit Android Auto funktioniert.
- Feedanzeige füllen: Rufen Sie Datenfelder auf, um sich anhand von Informationen zu orientieren, und verwenden Sie Symbole.