세부 경로 안내 데이터 피드는 지도 기반 탐색 안내를 위해 설계되었습니다. 그것은 향후 작전을 제공하고 다음과 같습니다.
- 아이콘 (왼쪽, 오른쪽, U자형)
- 로터리에서 번호 바꾸기
- 도로 이름
- 다음 이동 단계 또는 최종 지점까지의 예상 거리 및 시간 목적지
세부 경로 안내 피드를 사용하면 전체 정보가 Navigation SDK UI가 적절하지 않습니다(예: Android Auto 또는 소형 전체 Android 스택을 사용할 수 없는 경우 표시되는 화면 예를 들어 오토바이 운전자에 사용할 수 있는데, 목적지에 더 빠르게 도달할 수 있는 내비게이션 전용 안내 자신 있게 연습할 수 있습니다.
SDK를 사용하려면 서비스를 만들고 새 탐색 정보를 수신할 수 있는 Android용 Navigation SDK 실시간 (내비게이션 사용 중 1초에 한 번)
이 문서에서는 SDK에서 탐색 정보를 수신하고 탐색 상태 제공 전송합니다.
개요
이 섹션에서는 프로젝트에 TurnByTurn 라이브러리를 추가하고 - 세부 경로 기능 구축을 위한 개략적인 흐름을 요약합니다.
Maven을 사용하여 프로젝트에 TurnByTurn 라이브러리 추가 (권장)
TurnByTurn 라이브러리의 독립형 버전을 사용하려면 다음 단계를 따르세요.
- 호스트 Maven 저장소에 액세스하도록 환경을 설정합니다.
Maven
pom.xml
파일에 다음을 추가합니다.<project> ... <repositories> <repository> <id>google-maven-repository</id> <url>https://maven.google.com</url> </repository> </repositories> ... </project>
Gradle
build.gradle
파일에 다음을 추가합니다.repositories { ... google() }
Maven 또는 Gradle 구성에 다음 종속 항목을 추가합니다.
-
Maven
<dependencies> ... <dependency> <groupId>com.google.android.maps</groupId> <artifactId>google_turnbyturn</artifactId> <version>1.0.0</version> </dependency> </dependencies>
Gradle
dependencies { ... implementation 'com.google.android.maps:google_turnbyturn:1.0.0' }
다운로드한 JAR 파일을 사용하여 TurnByTurn 라이브러리를 프로젝트에 추가합니다 (대안).
TurnByTurn 라이브러리는 이 SDK 폴더에서 JAR 파일로 제공됩니다. 액세스 권한이 없는 경우 담당자에게 문의하세요.
google_turnbyturn_*.jar
를 다운로드하여 압축을 풉니다.- 다운로드한 JAR 파일을 프로젝트의
app/libs
디렉터리에 복사합니다. 다음을
build.gradle
에 추가하여 빌드에 JAR을 포함합니다.dependencies { ... api fileTree(include: ['*.jar'], dir: 'libs') }
TurnByTurn 라이브러리 사용
세부 경로 안내 기능을 사용 설정하기 위한 대략적인 단계는 다음과 같습니다. 이 각 단계에 대한 세부정보를 제공합니다.
내비게이션 업데이트를 받을 서비스 만들기
Navigation SDK는 TurnByTurn 서비스에 바인딩되어 Android 메신저 에서 자세한 내용을 확인하실 수 있습니다. 이러한 업데이트에 대한 새 내비게이션 서비스를 만들거나 기존 내비게이션 서비스를 사용할 수 있습니다. 있습니다.
서비스를 사용하여 내비게이션 업데이트를 받으면 서비스가 별도의 백그라운드 프로세스에 상주할 수 있습니다.
다음 예시의 서비스는 내비게이션 정보를 수신하고
TurnByTurnManager
을 사용하여 데이터를 NavInfo
객체로
에는 탐색 세부정보가 포함됩니다.
/** * Receives turn-by-turn navigation information forwarded from NavSDK. */ public class NavInfoReceivingService extends Service { /** The messenger used by the service to receive nav step updates. */ private Messenger incomingMessenger; private TurnByTurnManager turnByTurnManager; private final class IncomingNavStepHandler extends Handler { public IncomingNavStepHandler(Looper looper) { super(looper); } @Override public void handleMessage(Message msg) { // Identify the message through the msg.what field. if (TurnByTurnManager.MSG_NAV_INFO == msg.what) { // Extract the NavInfo object using the TurnByTurnManager. NavInfo navInfo = turnByTurnManager .readNavInfoFromBundle(msg.getData())); // Do something with the NavInfo } } } @Nullable @Override public IBinder onBind(Intent intent) { return incomingMessenger.getBinder(); } @Override public void onCreate() { turnByTurnManager = TurnByTurnManager.createInstance(); HandlerThread thread = new HandlerThread("NavInfoReceivingService", Process.THREAD_PRIORITY_DEFAULT); thread.start(); incomingMessenger = new Messenger( new IncomingNavStepHandler(thread.getLooper())); }
메시지 코드
NavInfo
메시지는 다음을 통해 식별할 수 있습니다.
Message.what
필드가 Message
클래스의 필드로 설정되어 있으며 이는
TurnByTurnManager.MSG_NAV_INFO
입니다.
내비게이션 업데이트를 위한 서비스 등록
다음 코드 스니펫은 내비게이션 서비스를 등록합니다.
boolean isNavInfoReceivingServiceRegistered = navigator.registerServiceForNavUpdates( getPackageName(), NavInfoReceivingService.class.getName(), numNextStepsToPreview);
서비스 시작 및 중지
내비게이션 서비스는
Navigation SDK가 바인딩됩니다. 또는
내비게이션 서비스 수명을 제어하는 startService()
및 stopService()
그러나 서비스에 서비스를 등록하면
Navigation SDK를 사용하면 서비스가 자동으로 시작됨
등록 취소할 때만 중지됩니다. 앱 설정 방법에 따라
포그라운드 서비스를 시작하려는 경우
문서 서비스
개요를 참조하세요.
서비스 등록 취소 중
내비게이션 업데이트 수신을 중지하려면 Navigation SDK를 지원합니다.
navigator.unregisterServiceForNavUpdates();
탐색 상태 이해
NavInfo.getNavState()
를 사용하여 현재 탐색 상태를 가져옵니다.
다음 중 하나입니다.
경로 중 -
ENROUTE
상태는 현재 가이드 내비게이션이 진행 중임을 의미합니다. 사용자가 제공된 경로를 따라 이동 중임을 알 수 있습니다 최신 상태, 사용할 수 있습니다.경로 변경 -
REROUTING
는 탐색이 진행 중이지만 네비게이터가 새로운 경로를 찾고 있습니다. 다음 작전 단계는 사용할 수 있습니다. 아직 새로운 경로가 없기 때문입니다. 샘플 앱에서 '경로 변경 중...' 메시지가 표시되는 위치 네비게이션 정보 표시가 있습니다. 경로를 찾으면NavInfo
메시지가ENROUTE
상태로 전송됩니다.중지됨:
STOPPED
는 탐색이 종료되었음을 의미합니다. 예: 내비게이션 사용자가 앱에서 내비게이션을 종료하면 중지됩니다. 샘플 앱에서는STOPPED
상태는 단계가 지연되지 않도록 내비게이션 정보 표시를 지웁니다. 표시되지 않도록 할 수 있습니다.
피드 디스플레이 채우기
이제 세부 경로 서비스를 설정했으므로 이 섹션에서는 광고주, 콘텐츠, 대행사, 전문가, 기업에 대한 안내 카드를 채우는 데 세부 경로 안내 피드
탐색 카드 정보 필드
사용자가 가이드 내비게이션을 시작하면 상단에 탐색 카드가 표시됩니다. 여기에는 Navigation SDK를 지원합니다. 관련 이미지는 몇 가지 필수 탐색 요소를 살펴보겠습니다.
이 표에는 탐색 정보 입력란과 탐색 정보가 표시되는 위치가 나와 있습니다.
각 탐색 단계의 입력란 | 전체 여정의 필드 |
---|---|
StepInfo 에서 발견됨 |
NavInfo 에서 발견됨 |
전체 도로명 | 남은 시간 |
조작 아이콘 | 목적지까지의 거리 |
다음 단계까지의 거리 | |
차선 안내 필드 |
차선 안내
Navigation SDK는 내비게이션의 차선을 나타냅니다.
카드를 다음으로 바꿔 줘
레인
및
LaneDirection
데이터 객체입니다. Lane
객체는 내비게이션 중 특정 차선을 나타냅니다.
에는 될 수 있는 모든 회전을 설명하는 LaneDirection
객체 목록이 있습니다.
이 차선에서 출발합니다.
사용자가 차선을 이용해야 하는 권장 방향은 isRecommended 필드를 확인합니다.
차선 안내 예
다음 스니펫은 표시된 차선의 데이터 표현을 보여줍니다. 참조하세요.
// Lane 1
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false},
{/*laneShape=*/ SLIGHT_LEFT, /*isRecommended=*/ true}]
// Lane 2
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false}]
조작 아이콘 만들기
이
Maneuver
드림
enum은 탐색 중에 발생할 수 있는 각 가능한 조작을 정의합니다.
StepInfo.getManeuver()
메서드에서 특정 단계에 관한 조작을 가져올 수 있습니다.
조작 아이콘을 만들어 관련 작전과 짝지어야 합니다.
일부 작업의 경우 아이콘에 일대일 매핑을 설정할 수 있습니다(예:
DESTINATION_LEFT
및 DESTINATION_RIGHT
. 그러나 일부 조작은
마찬가지로 단일 아이콘에 두 가지 이상의 조작을 매핑할 수 있습니다. 대상
예: TURN_LEFT
및 ON_RAMP_LEFT
모두 왼쪽 회전 아이콘에 매핑될 수 있습니다.
일부 조작에는 추가 clockwise
또는 counterclockwise
라벨이 포함되어 있습니다.
국가별 운전 방향에 따라 SDK가 결정합니다. 예를 들어
운전이 도로 왼쪽에 있는 국가에 비해 운전자는
회전 교차로는 시계 방향으로 회전합니다
시계 방향으로 이동합니다 Navigation SDK는
좌우 트래픽에서 조작이 발생하는지 여부에 관계없이
도움이 됩니다. 따라서 각 시간대마다 조작 아이콘이
어떻게 변하는지 살펴보겠습니다.
펼쳐서 다양한 조작 방법에 대한 예시 아이콘을 확인하세요.
샘플 아이콘 | 턴바이턴 조작 |
---|---|
![]() |
DEPART UNKNOWN |
![]() |
STRAIGHT ON_RAMP_UNSPECIFIED OFF_RAMP_UNSPECIFIED NAME_CHANGE
|
![]() |
TURN_RIGHT ON_RAMP_RIGHT
|
![]() |
TURN_LEFT ON_RAMP_LEFT
|
![]() |
TURN_SLIGHT_RIGHT ON_RAMP_SLIGHT_RIGHT OFF_RAMP_SLIGHT_RIGHT
|
![]() |
TURN_SLIGHT_LEFT ON_RAMP_SLIGHT_LEFT OFF_RAMP_SLIGHT_LEFT
|
![]() |
TURN_SHARP_RIGHT ON_RAMP_SHARP_RIGHT OFF_RAMP_SHARP_RIGHT
|
![]() |
TURN_SHARP_LEFT ON_RAMP_SHARP_LEFT OFF_RAMP_SHARP_LEFT
|
![]() |
TURN_U_TURN_COUNTERCLOCKWISE ON_RAMP_U_TURN_COUNTERCLOCKWISE OFF_RAMP_U_TURN_COUNTERCLOCKWISE
|
![]() |
TURN_U_TURN_CLOCKWISE ON_RAMP_U_TURN_CLOCKWISE OFF_RAMP_U_TURN_CLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_STRAIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_U_TURN_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_U_TURN_CLOCKWISE
|
![]() |
ROUNDABOUT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_CLOCKWISE
|
![]() |
ROUNDABOUT_EXIT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_EXIT_CLOCKWISE
|
![]() |
MERGE_RIGHT OFF_RAMP_RIGHT
|
![]() |
MERGE_LEFT OFF_RAMP_LEFT
|
![]() |
FORK_RIGHT TURN_KEEP_RIGHT ON_RAMP_KEEP_RIGHT OFF_RAMP_KEEP_RIGHT
|
![]() |
FORK_LEFT TURN_KEEP_LEFT ON_RAMP_KEEP_LEFT OFF_RAMP_KEEP_LEFT
|
![]() |
MERGE_UNSPECIFIED
|
![]() |
DESTINATION
|
![]() |
DESTINATION_RIGHT
|
![]() |
DESTINATION_LEFT
|
![]() |
FERRY_BOAT
|
![]() |
FERRY_TRAIN
|
생성된 아이콘 사용
Android Auto 사용 사례를 용이하게 하기 위해 Navigation SDK가 조작 및 차선 생성을 지원함 안내 아이콘을 탭합니다. 이 아이콘은 Android Auto의 이미지 크기 조정 안내에 맞습니다. 500 x 74dp 경계 상자 타겟팅을 권장하는 자동차 앱 라이브러리입니다. 자세한 내용은 setsLaneImage 및 CarIcon Android 참조 문서를 참조하세요.
아이콘 생성 예
NavigationUpdatesOptions options =
NavigationUpdatesOptions.builder()
.setNumNextStepsToPreview(numNextStepsToPreview)
.setGeneratedStepImagesType(GeneratedStepImagesType.BITMAP)
.setDisplayMetrics(getResources().getDisplayMetrics())
.build();
boolean isRegistered =
navigator.registerServiceForNavUpdates(
getPackageName(),
NavInfoReceivingService.class.getName(),
options);
아이콘 생성을 사용 설정하면 TurnbyTurn StepInfo
객체가
maneuverBitmap 및 lanesBitmap 필드가 아이콘으로 표시됩니다.
다음 단계
- Android Auto 앱의 경우:
- 지도를 그리고 사용 설정 탐색을 참고하시기 바랍니다.