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

세부 경로 안내 데이터 피드는 지도 기반 내비게이션 안내용으로 설계되지 않은 기기에 내비게이션 전용 정보를 제공합니다. 개발자가 제공하는 요소가 포함된 향후 조작을 제공합니다.

• 아이콘 (왼쪽, 오른쪽, U턴)
• 로터리에서 숫자 돌리기
• 도로 이름
• 다음 내비게이션 단계 또는 최종 목적지까지의 예상 거리 및 시간

세부 경로 안내 피드를 사용하여 작은 화면 디스플레이와 같이 전체 Navigation SDK UI가 적절하지 않은 환경을 만들 수 있습니다. 예를 들어 오토바이 탑승자에게 내비게이션 전용 안내를 투사하여 방해 요소를 최소화하여 더 빠르고 자신 있게 목적지에 도착할 수 있도록 할 수 있습니다.

필수 탐색 디스플레이 요소

각 탐색 단계의 기본 필드는 전체 도로명, 조작 방식, 단계의 총거리이며 GMSNavigationStepInfo에서 확인할 수 있습니다.

전체 이동과 관련하여 현재 단계 또는 목적지까지 남은 시간과 거리를 표시할 수 있습니다. 모든 항목은 GMSNavigationNavInfo에서 확인할 수 있습니다. 오른쪽 이미지는 이러한 필수 탐색 요소의 예를 보여줍니다.

이벤트 리스너 설정

탐색 전용 데이터를 사용하려면 didChangeNavInfo 이벤트의 이벤트 리스너를 구현해야 합니다. 이벤트 리스너 내에서 경로 및 단계 정보에 액세스하여 사용자에게 세부 경로 안내 내비게이션을 제공합니다.

이벤트 핸들러를 구현하려면 지도의 뷰 컨트롤러가 GMSNavigatorListener 프로토콜을 구현해야 합니다. iOS용 Navigation SDK의 이벤트 처리에 관한 자세한 내용은 내비게이션 이벤트 수신 대기를 참고하세요.

doChangeNavInfo 이벤트 처리

didChangeNavInfo 이벤트의 리스너를 만들어 앱에 세부 경로 안내 지원을 추가합니다. 이벤트 리스너에서 다음 클래스와 enum을 사용하여 세부 경로 안내 탐색을 제어합니다.

• GMSNavigationNavInfo - 탐색 상태에 관한 정보를 정의하는 클래스입니다.

• GMSNavigationStepInfo - 탐색 경로를 따라 하나의 단계에 관한 정보를 정의하는 클래스입니다.

• GMSNavigationNavState - 내비게이션의 현재 상태(예: 경로 변경 중, 경로 변경 중, 중지됨)를 정의하는 열거형입니다.

• GMSNavigationDrivingSide - 이 단계가 오른쪽 운전 경로인지 왼쪽 운전 경로인지 정의하는 열거형입니다.

• GMSNavigationManeuver - 왼쪽 또는 오른쪽으로 돌리는 등 실행할 탐색 작업을 정의하는 열거형입니다.

다음은 didChangeNavInfo 이벤트의 이벤트 리스너 예입니다.

Objective-C

  // ViewController.h
  @interface SomeViewController () <GMSNavigatorListener>

  @end

  // ViewController.m
  @implementation SomeViewController
  // Some initialization code.
  ... {
    ...
    [_mapView.navigator addListener:self];
    ...
  }

  #pragma mark GMSNavigatorListener
  - (void)navigator:(GMSNavigator *)navigator didUpdateNavInfo:(GMSNavigationNavInfo *)navInfo {
    // Get the current step information
    if (navInfo.navState == GMSNavigationNavStateEnroute) {
      GMSNavigationStepInfo *currentStep = navInfo.currentStep;
      if (currentStep) {
        ...
        roadNameLabel.text = currentStep.simpleRoadName;
        ...
      }
    }
    ...
  }

Swift

  // ViewController.swift
  class SomeViewController: UIViewController {
    ...
    mapView.navigator?.add(self);
    ...
  }

  extension SomeViewController: GMSNavigatorListener {
    func navigator(_ navigator: GMSNavigator,
                   didUpdateNavInfo navInfo: GMSNavigationNavInfo) {

      // Get the current step information
      if navInfo.navState == .enroute {
        if let currentStep = navInfo.currentStep {
          ...
          roadNameLabel.text = currentStep.simpleRoadName
          ...
        }
      }
    }
  }

탐색 상태

GMSNavigationNavInfo의 navState 속성을 사용하여 현재 탐색 상태를 가져옵니다. 이 속성은 다음 중 하나입니다.

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

• Reroute(경로 변경) - GMSNavigationNavStateRerouting은 탐색이 진행 중이지만 탐색기가 새 경로를 찾고 있음을 의미합니다. 아직 새 경로가 없으므로 다음 이동 단계를 사용할 수 없습니다.

• 중지됨 - GMSNavigationNavStateStopped은 내비게이션이 종료되었음을 의미합니다. 예를 들어 사용자가 앱에서 탐색을 종료하면 탐색이 중지됩니다. 샘플 앱에서는 GMSNavigationNavStateStopped 상태가 탐색 정보 표시를 지우므로 남아 있는 단계 안내가 표시되지 않도록 합니다.

조작을 위한 아이콘 만들기

GMSNavigationManeuver enum은 탐색 중에 발생할 수 있는 각 조작을 정의하며 GMSNavigationStepInfo의 maneuver 속성에서 특정 단계의 조작을 가져올 수 있습니다.

조작 아이콘을 만들고 관련 동작과 짝지어야 합니다. GMSNavigationManeuverDestinationLeft 및 GMSNavigationManeuverDestinationRight와 같은 일부 조작의 경우 아이콘에 일대일 매핑을 설정할 수 있습니다. 그러나 일부 조작은 다른 수단과 특성을 공유하므로 두 가지 이상의 조작을 단일 아이콘에 매핑하는 것이 좋습니다. 예를 들어 GMSNavigationManeuverTurnLeft 및 GMSNavigationManeuverOnRampLeft은 모두 왼쪽 회전 아이콘에 매핑될 수 있습니다.

일부 조작에는 SDK가 국가의 운전 측을 기준으로 결정하는 '시계 방향' 또는 '카운터 시계 방향' 라벨이 추가로 포함되어 있습니다. 예를 들어 도로가 왼쪽에 있는 국가에서는 운전자가 시계 방향으로 로터리 또는 U턴을 하는 반면 도로 오른쪽은 시계 반대 방향으로 이동합니다. 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