탐색 API

공개 최종 클래스 NavigationApi Object

Navigation API의 진입점입니다. 이 클래스의 정적 메서드를 사용하여 Navigator 참조를 가져옵니다.

중첩된 클래스 요약

@인터페이스 NavigationApi.ErrorCode ErrorCode는 Navigator를 성공적으로 가져올 수 없을 때 getNavigator(Activity, NavigatorListener) 및 getNavigator(Application, NavigatorListener)에서 반환하는 상태 코드입니다. 
인터페이스 NavigationApi.NavigatorListener getNavigator(Activity, NavigatorListener)에 NavigatorListener를 등록하여 해당 Navigator의 상태에 관한 알림을 받습니다. 
인터페이스 NavigationApi.OnTermsResponseListener 사용자가 이용약관에 동의하거나 거부할 때 알림을 받으려면 showTermsAndConditionsDialog(Activity, String, OnTermsResponseListener)에 OnTermsResponseListener를 등록합니다. 

공개 메서드 요약

정적 불리언
areTermsAccepted(신청서)
사용자가 이전에 Google의 탐색 이용약관에 동의한 경우 true를 반환합니다.
정적 void
cleanup()
NavSDK 구성요소의 내부 상태를 정리합니다.
동기화된 정적 ForegroundServiceManager
getForegroundServiceManager(애플리케이션 애플리케이션)
싱글톤 ForegroundServiceManager 인스턴스를 가져옵니다.
정적 문자열
getNavSDKVersion()
현재 NavSDK 버전을 반환합니다.
정적 void
getNavigator(애플리케이션 애플리케이션, NavigationApi.NavigatorListener 콜백)
Navigator 인스턴스를 가져옵니다.
정적 void
getNavigator(활동 활동, NavigationApi.NavigatorListener 콜백, TermsAndConditionsCheckOption termsCheck)
Navigator 인스턴스를 가져옵니다.
정적 void
getNavigator(활동 활동, NavigationApi.NavigatorListener 콜백)
getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED}과 같습니다.
정적 void
getNavigatorNoToS(애플리케이션 애플리케이션, NavigationApi.NavigatorListener 콜백)
Navigator 인스턴스를 가져옵니다.
정적 RoadSnappedLocationProvider
getRoadSnappedLocationProvider(애플리케이션 애플리케이션)
도로에 맞춰 촬영된 사용자 위치를 구독하는 데 사용할 수 있는 RoadSnappedLocationProvider의 인스턴스를 가져옵니다.
정적 NavigationTransactionRecorder
getTransactionRecorder(애플리케이션 애플리케이션)
탐색과 관련된 트랜잭션을 기록하는 데 사용할 수 있는 NavigationTransactionRecorder의 인스턴스를 가져옵니다.
동기화된 정적 void
initForegroundServiceManager(애플리케이션 애플리케이션, 정수 알림 ID, 문자열 defaultMessage, NotificationContentProvider 제공자)
제공된 인수로 ForegroundServiceManager 인스턴스를 초기화합니다.
정적 void
resetTermsAccepted(신청서)
테스트를 위해 이용약관을 재설정합니다.
정적 void
showTermsAndConditionsDialog(활동 활동, 문자열 companyName, 문자열 제목, NavigationApi.OnTermsResponseListener 리스너)
기본 디자인과 분위기를 사용하여 Google의 탐색 이용약관에 동의하도록 사용자에게 안내하는 대화상자를 표시합니다.
정적 void
showTermsAndConditionsDialog(활동 활동, 문자열 companyName, 문자열 제목, TermsAndConditionsUIParams uiParams, NavigationApi.OnTermsResponseListener 리스너, TermsAndConditionsCheckOption termsAndConditionsCheckOption)
사용자가 Google의 내비게이션 이용약관에 동의하도록 안내하는 대화상자를 표시합니다.
정적 void
showTermsAndConditionsDialog(활동 활동, 문자열 companyName, NavigationApi.OnTermsResponseListener 리스너)
기본 제목과 기본 디자인을 사용하여 Google의 탐색 이용약관에 동의하도록 사용자에게 안내하는 대화상자를 표시합니다.

상속받은 메서드 요약

공개 메서드

공개 정적 부울 areTermsAccepted (애플리케이션 애플리케이션)

사용자가 이전에 Google의 탐색 이용약관에 동의한 경우 true를 반환합니다.

이를 사용하여 사용자가 다른 곳으로 이동하려고 할 때가 아니라 애플리케이션의 초기에 약관 화면을 표시해야 하는지 확인할 수 있습니다. 예를 들어 사용자가 한 작업에서 앱의 모든 필수 이용약관에 동의할 수 있도록 앱에 다른 이용약관이 표시될 때 이 값을 확인하는 것이 적절할 수 있습니다.

매개변수
방법 현재 애플리케이션
반환 값
  • 사용자가 약관에 동의한 경우 true, 동의하지 않은 경우 false

공개 정적 void 정리 ()

NavSDK 구성요소의 내부 상태를 정리합니다. 현재 탐색기가 있으면 안내가 중지되고 중지됩니다. 더 이상 이 탐색기에서 안내를 요청할 수 없습니다. 앱에 더 이상 탐색기가 필요하지 않고 앱에서 Navigator에 대한 모든 참조를 소멸한 경우 이 메서드를 호출하여 메모리를 복구합니다. 이 호출 후에 앱에 Navigator가 필요한 경우 getNavigator()를 사용하여 새 Navigator를 생성합니다. 참고: 새 Navigator를 만드는 데는 시간이 걸립니다. 지연이 앱 성능에 미치는 영향과 복구된 메모리의 이점에 미치는 영향을 비교해 보세요.

공개 정적 동기화된 ForegroundServiceManager getForegroundServiceManager (애플리케이션 애플리케이션)

싱글톤 ForegroundServiceManager 인스턴스를 가져옵니다. getForegroundServiceManager(Application) 전에 initForegroundServiceManager(Application, Integer, String, NotificationContentProvider)를 호출하지 않으면 기본 알림 ID, 메시지, 알림 제공자가 사용됩니다.

매개변수
방법 현재 Application

공개 정적 문자열 getNavSDKVersion ()

현재 NavSDK 버전을 반환합니다.

public static void getNavigator (애플리케이션 애플리케이션, NavigationApi.NavigatorListener 콜백)

Navigator 인스턴스를 가져옵니다.

사용자가 아직 이용약관에 동의하지 않은 경우 오류 코드 TERMS_NOT_ACCEPTED와 함께 콜백이 즉시 실행됩니다.

Navigator는 싱글톤입니다. 이 메서드를 여러 번 호출하면 각 호출이 동일한 Navigator를 반환합니다.

매개변수
방법 현재 Application
콜백 Navigator가 준비되거나 오류가 발생할 때 실행되는 콜백

공개 static void getNavigator (활동 활동, NavigationApi.NavigatorListener 콜백, TermsAndConditionsCheckOption termsCheck)

Navigator 인스턴스를 가져옵니다.

사용자가 아직 이용약관에 동의하지 않은 경우 이 호출은 사용자에게 현지 규정을 준수할 것을 권하는 대화상자를 표시합니다.

termsCheck이 ENABLED이면 대화상자에 Navigation SDK 이용약관의 링크도 포함됩니다. 사용자가 이 약관에 동의하지 않으면 TERMS_NOT_ACCEPTED 오류와 함께 callback가 호출됩니다.

Navigator는 싱글톤입니다. 이 메서드를 여러 번 호출하면 각 호출이 동일한 Navigator를 반환합니다.

매개변수
활동 아직 수락하지 않은 경우 이용약관 대화상자를 표시하는 Activity
콜백 Navigator가 준비되거나 오류가 발생할 때 실행되는 콜백
termsCheck 이용약관 확인을 건너뛰어야 할지 여부를

public static void getNavigator (활동 활동, NavigationApi.NavigatorListener 콜백)

getNavigator(activity, callback, {@link TermsAndConditionsCheckOption#ENABLED}과 같습니다.

매개변수
활동
콜백
더보기

public static void getNavigatorNoToS (애플리케이션 애플리케이션, NavigationApi.NavigatorListener 콜백)

Navigator 인스턴스를 가져옵니다.

이용약관을 우회합니다.

Navigator는 싱글톤입니다. 이 메서드를 여러 번 호출하면 각 호출이 동일한 Navigator를 반환합니다.

매개변수
방법 현재 Application
콜백 Navigator가 준비되거나 오류가 발생하면 실행되는 콜백입니다.

공개 정적 RoadSnappedLocationProvider getRoadSnappedLocationProvider (애플리케이션 애플리케이션)

도로에 맞춰 촬영된 사용자 위치를 구독하는 데 사용할 수 있는 RoadSnappedLocationProvider의 인스턴스를 가져옵니다. 도로 스냅 위치 업데이트를 구독하면 배터리가 소모되거나 백그라운드에서 실행되는 경우 의도치 않게 사용자 위치 데이터가 수집될 수 있습니다.

이 메서드를 호출하기 전에 Navigator를 성공적으로 가져와야 합니다. 그러지 않으면 null이 반환됩니다.

매개변수
방법 현재 Application

공개 정적 NavigationTransactionRecorder getTransactionRecorder (애플리케이션 애플리케이션)

탐색과 관련된 트랜잭션을 기록하는 데 사용할 수 있는 NavigationTransactionRecorder의 인스턴스를 가져옵니다.

이 클래스는 거래별로 Google에서 청구하는 회사인 경우에만 사용해야 합니다.

이 메서드를 호출하기 전에 Navigator를 성공적으로 가져와야 합니다. 그러지 않으면 null이 반환됩니다.

매개변수
방법 현재 Application

public static 조정된 void initForegroundServiceManager (애플리케이션 애플리케이션, Integer notificationId, String defaultMessage, NotificationContentProvider provider)

제공된 인수로 ForegroundServiceManager 인스턴스를 초기화합니다.

기본 매개변수를 수정하려는 경우에만 호출해야 합니다. 그 외의 경우에는 getForegroundServiceManager(Application)를 직접 호출합니다. 이 메서드는 한 번만 호출할 수 있으며 getForegroundServiceManager(Application) 전에 호출해야 합니다.

매개변수
방법 현재 Application
notificationId 지속적인 알림의 알림 ID
defaultMessage provider이 지정되지 않은 경우 표시될 기본 메시지
제공업체 NotificationContentProvider의 구현

public static void resetTermsAccepted (신청서)

테스트를 위해 이용약관을 재설정합니다. 이용약관 대화상자를 테스트하려면 NavigationApi 호출 전에 이 호출을 추가합니다.

매개변수
방법 현재 애플리케이션

public static void showTermsAndConditionsDialog (Activity activity, String companyName, String title, NavigationApi.OnTermsResponseListener도로)

기본 디자인과 분위기를 사용하여 Google의 탐색 이용약관에 동의하도록 사용자에게 안내하는 대화상자를 표시합니다.

매개변수
활동
companyName
제목
리스너
더보기

Public showTermsAndConditionsDialogTermsAndConditionsUIParamsNavigationApi.OnTermsResponseListenerTermsAndConditionsCheckOption

사용자가 Google의 내비게이션 이용약관에 동의하도록 안내하는 대화상자를 표시합니다. 지정된 경우 리스너가 UI 스레드에서 호출되어 사용자가 이용약관을 수락하는지 여부를 나타냅니다.

사용자가 이전에 수락한 경우에도 대화상자가 표시됩니다. 이 메서드는 areTermsAccepted(Application)가 false인 경우에만 호출해야 합니다. 사용자가 이용약관에 동의할 수 없기 때문입니다.

매개변수
활동 대화상자가 표시되는 Activity
companyName 이용약관 대화상자에 표시되는 회사 이름
제목 대화상자 제목입니다. null인 경우 대화상자에 기본 제목이 사용됩니다.
uiParams 대화상자의 디자인을 맞춤설정하는 데 사용되는 매개변수입니다. null이면 기본 디자인이 사용됩니다.
리스너 사용자가 이용약관을 수락하거나 거부할 때 실행되는 선택적 콜백입니다.
termsAndConditionsCheckOption 이용약관 확인 옵션을 지정하는 TermsAndConditionsCheckOption

public static void showTermsAndConditionsDialog (Activity activity, String companyName, NavigationApi.OnTermsResponseListener 리스너)

기본 제목과 기본 디자인을 사용하여 Google의 탐색 이용약관에 동의하도록 사용자에게 안내하는 대화상자를 표시합니다.

매개변수
활동
companyName
리스너
더보기