이 섹션에서는 자동차용 Android 앱 라이브러리가 포함된 Navigation SDK로 앱의 탐색 환경을 대시보드 헤드에 표시 단위를 참고하세요. 만약 사용자의 대시보드 내 시스템은 Android Auto를 지원하며 사용자는 앱을 직접 사용할 수 있습니다. 자동차 디스플레이에 표시됩니다. 음성 안내 자동차 스피커에서도 실행됩니다.
자동차용 Android 앱 보관함 은 Android 애플리케이션이 Android Auto에서 실행되도록 하는 데 사용되는 운전자 안전을 위해 승인된 템플릿 이러한 템플릿은 운전자의 행동을 줄이기 위해, 전화기와 동일한 대시보드 UI 컨트롤. 집중해야 합니다.
Navigation SDK 기반 앱이 작동하도록 사용 설정하는 경우
Android Auto를 사용하면 내비게이션 환경을 위한 추가 뷰를 제공합니다.
이렇게 하면 두 개의 지도뷰, 즉 휴대전화와 헤드 단위를 위한 뷰가 하나씩 생성됩니다. 모두
디스플레이는 싱글톤인 Navigator.java의 안내를 수신합니다.
대시보드 내 시스템에는 안전 승인을 받은 양방향 미디어 요소를 사용하여 사용자가 목적지로 안전하게 이동할 수 있습니다. 집중하도록 할 수 있습니다. 또한 사용자는 주문 수락 또는 거부와 같은 앱 관련 기능 지도에서 고객의 위치를 확인합니다. 주문 상태 업데이트는 대시보드 내 단위에 표시됩니다.
연결된 휴대전화에는 표준 Navigation SDK 환경 또는 기타 뷰 또는 워크플로에 따라 다릅니다 이렇게 하면 맞춤 인벤토리 크기를 통해 자동차 화면에서 제대로 작동하지 않을 수 있습니다.
설정
앱이 Android Auto와 함께 작동하도록 하려면 먼저 Android Auto로 자동차 서비스를 업로드한 다음 TurnByTurn 라이브러리 사용 설정 탐색 SDK 앱에서 찾을 수 있습니다.
Android Auto로 시작하기
Navigation SDK로 작업을 시작하기 전에 Android Auto와 호환되도록 설계된 기능을 사용하려면 자동차 서비스를 설정해야 합니다. Android Auto가 발견할 수 있도록 합니다.
다음 단계를 따르세요. 모든 내용은 Android용 자동차 개발자 문서:
- 숙지하기 기본 Android Auto 기능을 직접 경험해 보세요.
- 설치 빌드해 보겠습니다.
- 구성 앱의 매니페스트 파일에 Android Auto를 포함하도록 설정합니다.
- 선언 최소 자동차 앱 레벨 1을 설정해야 합니다.
- 만들기
CarAppService및 세션
Navigation SDK 설정
자동차 앱 서비스를 설정하고 나면 Navigation SDK를 지원합니다.
- 설정 프로젝트(있는 경우) Navigation SDK를 아직 통합하지 않은 경우 삽입해야 합니다.
- TurnbyTurn 안내 사용 설정 피드를 만듭니다.
- 선택사항입니다. 생성된 아이콘 사용 있습니다.
- 그림
지도
제공된 Android Auto Surface의
NavigationViewForAuto클래스 사용 (Screen클래스에서) - Android Auto 탐색 템플릿 채우기 TurnbyTurn 라이브러리의 데이터로 작업할 수 있습니다.
이제 내비게이션 정보를 제공하기 위해 등록된 서비스가 있으므로 앱이 Android Auto에 연결될 수 있다면 이제 앱이 제대로 작동하는 데 필요한 나머지 탐색 요소는 Android Auto:
지도 및 탐색 UI 그리기
NavigationViewForAuto 클래스는 Android에서 지도 및 탐색 UI를 렌더링합니다.
자동 화면 NavigationView와 거의 동일한 기능을 제공합니다.
스마트폰의 경우 상호작용 기능이 제한됩니다. NavigationViewForAuto을(를) 사용하여 그리기
을
노출 영역
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();
}
지도 상호작용 사용 설정
운전자의 안전을 위해 Android Auto는 화면 표면 상호작용을
일련의
SurfaceCallback
메서드를 참조하세요. 이 콜백을 사용하여 지도와의 제한적인 운전자 상호작용을 지원합니다.
표시됩니다. 예를 들어 onClick과 onScale는 탭에 해당합니다.
및 손가락 모으기 동작을 할 수 있습니다. 상호작용 콜백은 매핑
액션
스트립
방법은 다음과 같습니다.
지도 상호작용 콜백을 수신하려면 앱에서 Action.PAN을 사용해야 합니다. 버튼을 클릭합니다.
추가 사용자 작업을 지원하려면 지도 작업 스트립에 버튼을 추가합니다.
노출 영역 콜백 사용 설정
@NonNull
@Override
public Template onGetTemplate() {
return new NavigationTemplate.Builder()
.setActionStrip(new ActionStrip.Builder().build())
.setMapActionStrip(new ActionStrip.Builder().addAction(Action.PAN).build())
.build();
}
손가락을 모으거나 펼쳐 확대/축소
@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.
}
화면 이동
@Override
public void onScroll(float distanceX, float distanceY) {
googleMap.moveCamera(CameraUpdateFactory.scrollBy(distanceX, distanceY));
}
내비게이션 경로 표시
이 섹션에서는 탐색 게시물의 관찰자를 설정하는 방법과 턴카드 템플릿에 내비게이션 경로를 채웁니다.
Android Auto 내비게이션 템플릿 현재 상태와 관련된 내비게이션 정보를 표시하는 턴 카드를 제공합니다. 있습니다. Navigation SDK의 TurnByTurn 라이브러리는 탐색 정보: 코드에서 Android Auto를 채우는 데 사용하는 정보 탐색 템플릿입니다.
관찰자 설정
다음 예에서 SampleApplication은
MutableLiveData<NavInfo> 객체를 유지합니다. 관찰자가
탐색기 객체에서 업데이트하면 이 NavInfo 객체를
NavInfoMutableLiveData는 SampleApplication 클래스에 의해 유지됩니다.
다음 예는 Android Auto를 구현하고 화면.
public SampleAndroidAutoNavigationScreen(@NonNull CarContext carContext,
SampleApplication application) {
super(carContext);
getCarContext().getCarService(AppManager.class).setSurfaceCallback(this);
application.getNavInfoMutableLiveData().observe(this, this::processNextStep);
}
내비게이션 정보 채우기
다음 코드 스니펫은 Android Auto 템플릿을 현재 경로 정보(걸음 수, 거리 및 아이콘 포함) 다음과 같은 작업을 할 수 있습니다. 표시 요소에 대한 자세한 내용은 피드 채우기 디스플레이를 참조하세요.
펼쳐서 코드 예시를 확인하세요.
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);
}
}
올바른 조작 유형 확인
Android Auto 자동차 라이브러리에서 사용되는 조작 유형은 조작할 수 있습니다. 하지만 Navigation SDK 조작을 선언을 추가해야 합니다. 다음 표에서는 몇 개의 필드에 대한 대응과 샘플 변환기 유틸리티가 이어집니다. 확인하시기 바랍니다.
| 라이브러리 세부 경로 안내 | 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 |
펼쳐서 코드 예시를 확인하세요.
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;
}
}
관련 문서
- 세부 경로 안내 사용 설정 피드: 통합 앱이 Android Auto와 호환될 수 있도록 먼저 세부 경로 안내 기능을 활성화해야 합니다.
- 피드 채우기 display: 액세스 데이터 필드에 안내 정보를 표시하고 아이콘을 사용합니다.