내비게이터

공개 인터페이스 Navigator

탐색을 제어하는 메서드를 제공하는 싱글톤입니다.

UI 스레드에서 호출해야 하는 setAudioGuidance 및 setHeadsUpNotificationEnabled를 제외한 모든 메서드는 스레드로부터 안전합니다.

중첩된 클래스 요약

인터페이스	Navigator.ArrivalListener		운전자가 경유지에 도착할 때 호출되는 메서드의 서명을 정의합니다.
@인터페이스	Navigator.AudioGuidance		AudioGuidance는 탐색 중에 사용할 오디오 알림과 안내의 종류를 지정하는 데 사용되는 플래그 집합입니다.
인터페이스	Navigator.RemainingTimeOrDistanceChangedListener		다음 대상까지의 남은 시간이나 거리가 변경될 때 호출되는 메서드의 서명을 정의합니다.
인터페이스	Navigator.RouteChangedListener		경로가 변경될 때 호출되는 메서드의 서명을 정의합니다.
enum	Navigator.RouteStatus		RouteStatus는 setDestination(Waypoint)에서 반환된 Future를 통해 액세스되는 경로 계산 결과를 나타내는 상태 코드입니다.

공개 메서드 요약

추상 void	cleanup() 탐색기의 내부 상태를 정리합니다.
추상 void	clearDestinations() 이전에 설정한 모든 목적지를 지우고 계산된 경로를 지도에서 삭제합니다.
추상 void	clearLicensePlateRestrictionInfo() 현재 운전자에 대한 번호판 정보를 삭제합니다.
추상 void	clearRemainingTimeOrDistanceChangedListener() 남은 시간이나 거리 변경의 리스너를 지웁니다.
추상 경유지	continueToNextDestination() 현재 대상을 삭제합니다.
추상 ListenableResultFuture<RouteInfo>	fetchRouteInfo(경유지 경유지, RoutingOptions routeOptions) 각 RoutingOptions.RoutingStrategy 값을 기반으로 경로의 경로 정보를 반환합니다.
추상 RouteSegment	getCurrentRouteSegment() 여정의 현재 구간을 반환합니다.
추상 TimeAndDistance	getCurrentTimeAndDistance() 현재 위치에서 현재 목적지까지의 예상 시간과 거리를 반환합니다.
추상 List<RouteSegment>	getRouteSegments() 경로 구간의 목록을 반환합니다.
추상 시뮬레이터	getSimulator() 테스트 중에 사용할 시뮬레이터 객체를 반환합니다.
추상 List<TimeAndDistance>	getTimeAndDistanceList() 현재 경로의 각 목적지에 해당하는 시간과 거리의 목록을 반환하여 현재 위치에서 각 목적지까지의 예상 시간과 거리를 나타냅니다.
추상 List<LatLng>	getTraveledRoute() 이 안내 세션 중에 지금까지 이동한 경로를 반환합니다 (마지막 startGuidance() 호출 이후).
추상 불리언	isGuidanceRunning() 안내가 현재 실행 중인 경우 true를 반환합니다.
추상 void	setArrivalListener(Navigator.ArrivalListener 리스너) 도착 이벤트에 대한 리스너를 등록합니다.
추상 void	setAudioGuidance(int 지침) 어떤 유형의 오디오 안내 (진동 포함)를 사용할지 설정합니다.
추상 ListenableResultFuture<Navigator.RouteStatus>	setDestination(경유지 대상, RoutingOptions routeOptions, DisplayOptions displayOptions) 탐색의 단일 대상을 설정하여 이전에 설정된 대상을 재정의합니다.
추상 ListenableResultFuture<Navigator.RouteStatus>	setDestination(경유지 목적지, RoutingOptions 옵션) 탐색의 단일 대상을 설정하여 이전에 설정된 대상을 재정의합니다.
추상 ListenableResultFuture<Navigator.RouteStatus>	setDestination(경유지 목적지) 탐색의 단일 대상을 설정하여 이전에 설정된 대상을 재정의합니다.
추상 ListenableResultFuture<Navigator.RouteStatus>	setDestinations(List<Waypoint> 목적지, RoutingOptions 옵션) 탐색을 위한 여러 대상을 설정하여 이전에 설정된 대상을 재정의합니다.
추상 ListenableResultFuture<Navigator.RouteStatus>	setDestinations(List<Waypoint> 목적지, RoutingOptions 라우팅 옵션, DisplayOptions displayOptions) 탐색을 위한 여러 대상을 설정하여 이전에 설정된 대상을 재정의합니다.
추상 ListenableResultFuture<Navigator.RouteStatus>	setDestinations(List<Waypoint> 목적지) 탐색을 위한 여러 대상을 설정하여 이전에 설정된 대상을 재정의합니다.
추상 void	setHeadsUpNotificationEnabled(불리언 사용 설정됨) 헤드업 알림 표시 여부를 설정합니다.
추상 void	setLicensePlateRestrictionInfo(intRawLicensePlateLastDigit, String LicensePlateCountryCode) 현재 운전자에 대한 번호판 정보를 설정합니다.
추상 void	setRemainingTimeOrDistanceChangedListener(int timeChangeThresholdSeconds, intdistanceChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListener 리스너) 대상까지의 남은 시간이나 거리가 지정된 임곗값 이상 변경되는 경우를 위한 리스너를 등록합니다.
추상 void	setRouteChangedListener(Navigator.RouteChangedListener 리스너) 경로 변경 이벤트에 대한 리스너를 등록합니다.
추상 void	setSpeedingListener(SpeedingListener speedingListener) 운전자가 현재 운전하고 있는 속도 제한을 초과하는 비율에 SpeedingListener를 등록합니다.
추상 void	startGuidance(인텐트 재개 인텐트) startGuidance()와 동일하지만 탐색기의 상태 표시줄 알림에서 애플리케이션을 재개하는 데 사용할 수 있는 인텐트를 지정합니다.
추상 void	startGuidance() 목적지가 설정되고 이에 대해 계산된 경로가 설정된 경우 경로의 세부 경로 안내 내비게이션을 시작합니다.
추상 void	stopGuidance() 세부 경로 안내 내비게이션을 중지합니다.

공개 메서드

공개 추상 void 정리 ()

탐색기의 내부 상태를 정리합니다.

참고: 이 메서드를 호출하면 대기 중인 setDestinations(List) 요청이 취소됩니다.

public 추상 void clearDestinations ()

이전에 설정한 모든 목적지를 지우고 계산된 경로를 지도에서 삭제합니다. 내비게이션이 실행 중인 경우 자동으로 중지됩니다.

public 추상 void clearLicensePlateRestrictionInfo ()

현재 운전자에 대한 번호판 정보를 삭제합니다. 이는 이 값이 설정된 후 실행된 setDestination 호출에만 적용됩니다.

공개 추상 void clearRemainingTimeOrDistanceChangedListener ()

남은 시간이나 거리 변경의 리스너를 지웁니다.

공개 추상 경유지 continueToNextDestination ()

현재 대상을 삭제합니다. 이 호출 후에 다음 대상에 대한 안내가 제공되며 이전 대상에 관한 정보는 사용할 수 없습니다.

반환 값

• 경유지 안내가 이제 향하고 있거나 남은 경유지가 없는 경우 null입니다.

공개 추상 ListenableResultFuture<RouteInfo> fetchRouteInfo (Waypoint Waypoint, RoutingOptions 라우팅 옵션)

각 RoutingOptions.RoutingStrategy 값을 기반으로 경로의 경로 정보를 반환합니다. 이 메서드가 모든 라우팅 전략의 경로 정보를 반환하므로 RoutingOptions.RoutingStrategy는 무시됩니다.

참고: 모든 호출에서 다시 계산되며 교통정보 및 기타 요소가 중간에 업데이트되었을 수 있으므로 현재 내비게이션에서 사용 중인 경로와 일치하지 않을 수도 있습니다.

매개변수

중간점	경로의 목적지 경유지
routingOptions	경로 정보를 가져오는 데 사용되는 옵션

반환 값

• 반환된 future

공개 추상 RouteSegment getCurrentRouteSegment ()

여정의 현재 구간을 반환합니다. 이 RouteSegment는 기기의 가장 최근으로 알려진 (도로에 맞춰진) 위치로 시작 위치를 갖습니다.

반환 값

• 경로 구간 객체 또는 현재 경로가 없는 경우 null

공개 추상 TimeAndDistance getCurrentTimeAndDistance ()

현재 위치에서 현재 목적지까지의 예상 시간과 거리를 반환합니다.

반환 값

• 시간 및 거리 객체 또는 현재 경로가 없는 경우 null

공개 추상 List<RouteSegment> getRouteSegments ()

경로 구간의 목록을 반환합니다. 반환된 각 세그먼트의 대상은 setDestination(s)에서 설정한 대상에 해당합니다.

공개 추상 시뮬레이터 getSimulator ()

테스트 중에 사용할 시뮬레이터 객체를 반환합니다.

공개 추상 List<TimeAndDistance> getTimeAndDistanceList ()

현재 경로의 각 목적지에 해당하는 시간과 거리의 목록을 반환하여 현재 위치에서 각 목적지까지의 예상 시간과 거리를 나타냅니다.

공개 추상 List<LatLng> getTraveledRoute ()

(마지막 startGuidance() 호출 이후) 이 안내 세션 중에 지금까지 이동한 경로를 반환합니다. 기록된 경로는 RoadSnappedLocationProvider에 의해 반환되는 도로에 맞춰진 위치로 구성되며, 중복 지점을 제거하도록 단순화되었습니다(예: 연속된 공선형 지점을 단일 선분으로 변환).

공개 추상 불리언 isGuidanceRunning ()

안내가 현재 실행 중인 경우 true를 반환합니다. 대상 경로가 계산되고 startGuidance()이 호출된 후에만 안내가 실행됩니다.

공개 추상 void setArrivalListener (Navigator.ArrivalListener 리스너)

도착 이벤트에 대한 리스너를 등록합니다. 이전에 등록된 리스너를 모두 재정의합니다.

참고: 메모리 누수를 방지하려면 리스너가 더 이상 필요하지 않을 때 setNavArrivalListener(null)를 호출해야 합니다.

매개변수

리스너	등록할 리스너입니다. null로 설정하여 이전에 등록된 리스너를 지울 수 있습니다.

public 추상 void setAudioGuidance (int 가이드)

어떤 유형의 오디오 안내 (진동 포함)를 사용할지 설정합니다. 기본적으로 진동, 음성, 블루투스를 통한 음성 (사용 가능한 경우)이 사용 설정됩니다.

이 메서드는 UI 스레드에서 호출해야 합니다.

매개변수

안내	사용 설정해야 하는 오디오 안내 유형을 지정하는 Navigator.AudioGuidance 플래그의 조합

공개 추상화 ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint 대상, RoutingOptions 라우팅 옵션, DisplayOptions displayOptions)

탐색의 단일 대상을 설정하여 이전에 설정된 대상을 재정의합니다. 반환된 future는 사용자의 위치에서 지정된 목적지까지의 경로를 찾으면 OK로 설정됩니다.

매개변수

연결 대상	설정할 새 대상
routingOptions	경로를 생성하는 데 사용할 옵션
displayOptions	경로를 표시하는 데 사용되는 옵션입니다.

반환 값

• 반환된 future

생성 값

NullPointerException	지정된 대상이 null인 경우

공개 추상 ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint 대상, RoutingOptions 옵션)

탐색의 단일 대상을 설정하여 이전에 설정된 대상을 재정의합니다. 반환된 future는 사용자의 위치에서 지정된 목적지까지의 경로를 찾으면 OK로 설정됩니다. 기본 DisplayOptions가 경로를 표시하는 데 사용됩니다.

매개변수

연결 대상	설정할 새 대상
옵션	경로를 생성하는 데 사용할 옵션

반환 값

• 반환된 future

생성 값

NullPointerException	지정된 대상이 null인 경우

공개 추상화 ListenableResultFuture<Navigator.RouteStatus> setDestination (Waypoint 대상)

탐색의 단일 대상을 설정하여 이전에 설정된 대상을 재정의합니다. 반환된 future는 사용자의 위치에서 지정된 목적지까지의 경로를 찾으면 OK로 설정됩니다. 기본 RoutingOptions가 경로를 찾는 데 사용되고 기본 DisplayOptions가 경로를 표시하는 데 사용됩니다.

매개변수

연결 대상	설정할 새 대상

반환 값

• 반환된 future

생성 값

NullPointerException	지정된 대상이 null인 경우

공개 추상 ListenableResultFuture<Navigator.RouteStatus> setDestinations (목록<Waypoint> 대상, RoutingOptions 옵션)

탐색을 위한 여러 대상을 설정하여 이전에 설정된 대상을 재정의합니다. 반환된 future는 사용자의 위치에서 지정된 목적지까지의 경로를 찾으면 OK로 설정됩니다. 기본 DisplayOptions가 경로를 표시하는 데 사용됩니다.

매개변수

대상	설정할 새 대상 목록
옵션	경로를 생성하는 데 사용할 옵션

반환 값

• 반환된 future

공개 추상 ListenableResultFuture<Navigator.RouteStatus> setDestinations (목록<Waypoint> 대상, RoutingOptions 라우팅 옵션, DisplayOptions displayOptions)

탐색을 위한 여러 대상을 설정하여 이전에 설정된 대상을 재정의합니다. 반환된 future는 사용자의 위치에서 지정된 목적지까지의 경로를 찾으면 OK로 설정됩니다.

매개변수

대상	설정할 새 대상 목록
routingOptions	경로를 생성하는 데 사용할 옵션
displayOptions	경로를 표시하는 데 사용되는 옵션입니다.

반환 값

• 반환된 future

공개 추상화 ListenableResultFuture<Navigator.RouteStatus> setDestinations (목록<Waypoint> 대상)

탐색을 위한 여러 대상을 설정하여 이전에 설정된 대상을 재정의합니다. 반환된 future는 사용자의 위치에서 지정된 목적지까지의 경로를 찾으면 OK로 설정됩니다. 기본 RoutingOptions가 경로를 찾는 데 사용되고 기본 DisplayOptions가 경로를 표시하는 데 사용됩니다.

매개변수

대상	설정할 새 대상 목록

반환 값

• 반환된 future

공개 추상 void setHeadsUpNotificationEnabled (boolean enabled)

헤드업 알림 표시 여부를 설정합니다. 기본적으로 알림은 사용 설정되어 있습니다. 헤드업 이벤트는 방향 전환과 같이 표시되는 지도가 없을 때 표시되는 안내 이벤트입니다.

이 메서드는 UI 스레드에서 호출해야 합니다.

매개변수

사용 설정됨	헤드업 알림을 사용 설정해야 하는지 여부를 나타내는 플래그

공개 추상화 void setLicensePlateRestrictionInfo (intoriginalLicensePlateLastDigit, String LicensePlateCountryCode)

현재 운전자에 대한 번호판 정보를 설정합니다. 이렇게 하면 번호판 번호를 기반으로 한 특정 유형의 도로 제한 도로를 우회할 수 있습니다. 이는 이 값이 설정된 후 실행된 setDestination 호출에만 적용됩니다. 탐색기를 가져온 직후에 호출하는 것이 좋습니다.

매개변수

rawLicensePlateLastDigit	번호판의 마지막 자릿수입니다 (0과 9 사이여야 함).
licensePlateCountryCode	현재 인도네시아 (ID)와 브라질 (BZ)만 지원하고 있으며 그 외 국가도 향후 지원될 예정입니다. 이 정보는 사전에 자유롭게 제공해도 됩니다.

공개 추상 void setRemainingTimeOrDistanceChangedListener (int timeChangeThresholdSeconds, intdistanceChangeThresholdMeters, Navigator.RemainingTimeOrDistanceChangedListenerListener)

대상까지의 남은 시간이나 거리가 지정된 임곗값 이상 변경되는 경우를 위한 리스너를 등록합니다. 이전에 등록된 리스너를 모두 재정의합니다.

리스너는 사용자 이동, 교통상황 변경, 경로 변경, 목적지 변경 또는 남은 시간과 거리가 처음 알려졌을 때 호출될 수 있습니다.

참고: 메모리 누수를 방지하려면 리스너가 더 이상 필요하지 않을 때 clearNavProgressionListener()를 호출해야 합니다.

매개변수

timeChangeThresholdSeconds	남은 시간(초)의 절대 변화가 이 값보다 크거나 같으면 리스너가 호출됩니다. 이 기준은 음수가 아니어야 합니다.
distanceChangeThresholdMeters	남은 거리의 절대 변화가 미터 단위보다 크거나 같으면 리스너가 호출됩니다. 이 기준은 음수가 아니어야 합니다.
리스너	등록할 리스너입니다. null이 아니어야 합니다.

공개 추상 void setRouteChangedListener (Navigator.RouteChangedListener 리스너)

경로 변경 이벤트에 대한 리스너를 등록합니다. 이전에 등록된 리스너를 모두 재정의합니다.

참고: 메모리 누수를 방지하려면 리스너가 더 이상 필요하지 않을 때 setNavRouteChangeListener(null)를 호출해야 합니다.

매개변수

리스너	등록할 리스너입니다. null로 설정하여 이전에 등록된 리스너를 지울 수 있습니다.

공개 추상 void setSpeedingListener (SpeedingListener speedingListener)

운전자가 현재 운전하고 있는 속도 제한을 초과하는 비율에 SpeedingListener를 등록합니다.

null SpeedingListener를 설정하거나 설정하지 않으면 속도 저하 피드 데이터를 수신하지 않습니다.

매개변수

speedingListener

공개 추상 void startGuidance (인텐트 재개 인텐트)

startGuidance()와 동일하지만 탐색기의 상태 표시줄 알림에서 애플리케이션을 재개하는 데 사용할 수 있는 인텐트를 지정합니다. 이 인텐트가 없으면 상태 표시줄에서 애플리케이션을 재개할 수 없습니다.

매개변수

resumeIntent	애플리케이션을 재개하기 위한 인텐트입니다. 대부분의 경우 android.app.Activity#getIntent()에서 반환하는 값이 적합합니다.

공개 추상 void startGuidance ()

목적지가 설정되고 이에 대해 계산된 경로가 설정된 경우 경로의 세부 경로 안내 내비게이션을 시작합니다. 경로가 아직 계산되지 않은 경우 경로가 계산되면 세부 경로 안내가 시작됩니다.

내비게이션 서비스를 중지하려면 StopGuidance()를 명시적으로 호출해야 합니다. 도착 시 내비게이션 서비스가 자동으로 중지되지 않습니다. 도착 시 내비게이션 서비스를 중지하려면 NavArrivalListener에서 stopGuidance()를 호출해야 합니다.

참고: 이 메서드는 Camera의 위치를 변경하지 않습니다.

public 추상 void stopGuidance ()

세부 경로 안내 내비게이션을 중지합니다.