세부 경로 안내 데이터 피드 사용 설정

세부 경로 안내 데이터 피드는 지도 기반 내비게이션 안내를 위해 설계되지 않은 기기에 내비게이션 전용 정보를 제공합니다. 사용자가 제공하는 요소로 예정된 기동을 제공합니다.

  • 아이콘 (왼쪽, 오른쪽, 유턴)
  • 로터리의 회전 수
  • 도로 이름
  • 다음 내비게이션 단계 또는 최종 목적지까지의 예상 거리 및 시간

세부 경로 안내 피드를 사용하여 전체 Navigation SDK UI가 적합하지 않은 환경(예: Android Auto 또는 전체 Android 스택을 사용할 수 없는 소형 화면 디스플레이)을 만들 수 있습니다. 예를 들어 내비게이션 전용 안내를 투영하여 운전자가 최소한의 방해 요소로 더 빠르고 자신 있게 목적지에 도달할 수 있도록 지원하는 이륜차 운전자에게 사용할 수 있습니다.

SDK를 사용하려면 서비스를 만들고 Android용 Navigation SDK에 등록하여 새로운 내비게이션 정보를 실시간으로 (내비게이션 중에는 초당 약 1회) 수신할 수 있도록 해야 합니다.

이 문서에서는 SDK에서 내비게이션 정보를 수신하고 수신 기기에 내비게이션 상태를 제공하는 내비게이션 서비스를 만들고 등록하는 방법을 보여줍니다.

개요

이 섹션에서는 세부 경로 안내 기능을 사용 설정하기 위한 대략적인 흐름을 요약합니다.

TurnByTurn 기능 사용

세부 경로 안내 기능을 사용 설정하기 위한 대략적인 단계는 다음과 같습니다. 다음 섹션에서는 각 단계에 관한 세부정보를 제공합니다.

  1. 내비게이션 업데이트를 수신하는 서비스를 만듭니다.

  2. 서비스를 등록합니다.

  3. 내비게이션 상태를 파악합니다.

내비게이션 업데이트를 수신하는 서비스 만들기

Navigation SDK는 TurnByTurn 서비스에 바인딩하고 Android Messenger 를 통해 내비게이션 업데이트를 전송합니다. 이러한 업데이트를 위한 새 내비게이션 서비스를 만들거나 기존 서비스를 사용할 수 있습니다.

내비게이션 업데이트를 수신하는 서비스를 사용하면 서비스가 별도의 백그라운드 프로세스에 상주할 수 있다는 이점이 있습니다.

다음 예의 서비스는 내비게이션 정보를 수신하고 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에 서비스를 등록하면 서비스가 자동으로 시작되고 등록 취소할 때만 중지됩니다. 앱을 설정하는 방법에 따라 Android 문서 서비스 개요에 설명된 포그라운드 서비스 시작을 고려할 수 있습니다.

서비스 등록 취소

내비게이션 업데이트 수신을 중지하려면 Navigation SDK에서 서비스를 등록 취소하세요.

navigator.unregisterServiceForNavUpdates();

내비게이션 상태 파악

NavInfo.getNavState()를 사용하여 내비게이션의 현재 상태를 가져옵니다. 이는 다음 중 하나입니다.

  • 경로 - ENROUTE 상태는 안내 내비게이션이 활성 상태이고 사용자가 제공된 경로에 있음을 의미합니다. 현재 예정된 기동 단계에 관한 정보를 사용할 수 있습니다.

  • 경로 재탐색 - REROUTING은 내비게이션이 진행 중이지만 내비게이터가 새 경로를 찾고 있음을 의미합니다. 아직 새 경로가 없으므로 예정된 기동 단계를 사용할 수 없습니다. 샘플 앱에서 내비게이션 정보 디스플레이에 '경로 재탐색 중...' 메시지가 표시됩니다. 경로가 발견되면 상태가 ENROUTE인 NavInfo 메시지가 전송됩니다.

  • 중지됨 - STOPPED는 내비게이션이 종료되었음을 의미합니다. 예를 들어 사용자가 앱에서 내비게이션을 종료하면 내비게이션이 중지됩니다. 샘플 앱에서 STOPPED 상태는 내비게이션 정보 디스플레이를 지워 단계 안내가 계속 표시되지 않도록 합니다.

피드 디스플레이 채우기

이제 세부 경로 안내 서비스를 설정했으므로 이 섹션에서는 세부 경로 안내 피드의 안내 카드를 채우는 데 사용할 수 있는 시각적 요소와 텍스트 요소를 다룹니다.

W Ahwanee Ave로 100피트 앞에서 좌회전할 예정임을 보여주는 모바일 화면입니다. 화면 하단에는 목적지까지 남은 시간이 46분, 남은 거리가 39마일로 표시되어 있습니다.

사용자가 안내 내비게이션을 시작하면 상단에 Navigation SDK에서 채워진 내비게이션 데이터가 포함된 내비게이션 카드가 표시됩니다. 관련 이미지는 이러한 필수 내비게이션 요소의 예를 보여줍니다.

이 표는 내비게이션 정보의 필드와 필드를 찾을 수 있는 위치를 보여줍니다.

각 내비게이션 단계의 필드 전체 여정의 필드
StepInfo에 있음 NavInfo에 있음
전체 도로 이름 남은 시간
기동 아이콘 목적지까지의 거리
다음 단계까지의 거리
차선 안내 필드

차선 안내

Navigation SDK는 내비게이션 회전 카드의 차선을 Lane 및 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

생성된 아이콘 사용

Navigation SDK에서 제공하는 생성된 아이콘의 작은 목록입니다.

Android Auto 사용 사례를 용이하게 하기 위해 Navigation SDK는 기동 및 차선 안내 아이콘 생성을 지원합니다. 이러한 아이콘은 500 x 74dp 경계 상자를 타겟팅하는 것이 좋은 Android Auto 자동차 앱 라이브러리의 이미지 크기 조정 안내에 적합합니다. 자세한 내용은 Android 참조 문서의 setsLaneImage 및 CarIcon 을 참고하세요.

아이콘 생성 예

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 필드를 채웁니다.

다음 단계