자주 묻는 질문(FAQ)
제품 세부정보
- Navigation SDK 서비스 약관 알림을 어떻게 표시해야 하나요?
- 음성 안내는 어떤 언어를 지원하나요?
- 사용자가 내비게이션 모드를 종료할 때 방위가 유지되나요?
- 경로를 시작하거나 변경할 때 다중선을 사용할 수 있나요?
- 앱 사용자가 Google 지도 모바일을 설치해야 하나요?
- Navigation SDK가 식당 및 기타 목적지 근처의 주차장을 식별할 수 있나요?
- 회전 지점에 접근할 때 Navigation SDK가 차선의 통행 방향을 표시하나요?
- Navigation SDK는 어떤 JDK 버전을 지원하나요?
네트워크
데이터
- 경로를 시작하기 전에 여정의 모든 정류장/목적지를 검색할 수 있나요?
- 경로의 시작 부분에 세부 경로 안내를 사용할 수 있나요?
- 도착 예정 시간(ETA)은 앱 사용자에게 어떻게 전달되나요?
- 탐색이 포그라운드에 있지 않은 경우
RoadSnappedLocationProvider
를 사용하여 사용자의 현재 맞춰진 위치를 가져올 수 있나요? - Navigation SDK는 지오펜싱을 지원하나요?
- 내비게이션 앱이 백그라운드에 있을 때 알림을 사용 중지할 수 있나요?
- Google에서 보관하는 거래 로그를 보려면 어떻게 해야 하나요?
UI 맞춤설정
- 최적의 경로 옵션에 색상을 지정할 수 있나요?
- Navigation SDK에서 최종 대상의 도착예정시간을 표시할 수 있나요?
- 도착예정시간 업데이트를 숨기려면 어떻게 해야 하나요?
- 머리글 및 바닥글 카드에 어떤 UI 맞춤설정을 사용할 수 있나요?
라우팅
- 사용자에게 특정 경로를 제공하거나 대체 경로를 삭제할 수 있나요?
- 기본 대상 위치와 다른 대상 라벨을 사용자에게 표시할 수 있나요?
- Navigation SDK를 사용하여 정의된 경로의 편차를 추적할 수 있나요?
- 사용자가 경로를 완료하지 않고 내비게이션을 종료할 수 있나요?
시뮬레이터
워크플로
제품 세부정보
- 앱은 각 사용자가 동의해야 하는 Navigation SDK 서비스 약관 고지가 포함된 대화상자를 구현해야 합니다. 이 대화상자에서 사용자는 서비스 약관에 동의할 수 있습니다. 약관 텍스트 파일은 Navigation SDK와 함께 제공됩니다.
용어가 포함된 대화상자를 표시하려면
NavigationApi.showTermsAndConditionsDialog
메서드를 사용합니다. - Google 모바일 지도에서 지원하는 모든 언어는 Navigation SDK에서 자동으로 사용할 수 있습니다. 기기에는 기본 시스템 언어가 있으며 앱은 이 설정을 변경할 수 없습니다. 하지만 앱은 70개가 넘는 언어를 사용할 수 있습니다.
-
저도요
LocationListener
는 시작되면 백그라운드에서 계속 실행됩니다. 앱은 도로 위치를 계속 스냅하고 방위를 유지합니다. -
저도요 경로를 만들거나 변경할 때
RouteChangeListener
에서 다중선을 제공합니다. - 아니요. Navigation SDK를 사용하려면 Google 모바일 지도를 기기에 설치하지 않아도 됩니다.
- 아니요. Navigation SDK는 현재 이 기능을 제공하지 않습니다.
- 예. 통행 방향이 기본적으로 사용 가능하며 표시됩니다.
- Navigation SDK는 어떤 JDK 버전을 지원하나요?
- Navigation SDK는 Oracle에서 적극적으로 지원하는 Java SE의 LTS 버전을 지원합니다. 이러한 버전은 Oracle Java SE 지원 로드맵에 프리미어 지원을 제공하는 것으로 표시됩니다.
네트워크
- Navigation SDK는 연결 상태가 좋지 않은 경우 어떻게 처리하나요?
- Navigation SDK는 각 여정의 경로를 사전 캐시합니다. 사전 캐시된 정보에는 15~20분 동안의 경로 정보와 사용자가 경로를 벗어나는 경우 사용할 수 있는 경로 정보가 포함됩니다. Navigation SDK는 기기 GPS와 센서를 사용하여 대략적인 위치를 파악합니다.
- 오프라인 모드를 사용할 수 있나요?
- 아니요. Navigation SDK는 현재 오프라인 모드를 제공하지 않습니다. 하지만 SDK는 여정에 대해 사전 캐시된 정보를 제공합니다.
데이터
- 경로를 시작하기 전에 여정의 모든 정류장/목적지를 검색할 수 있나요?
-
저도요 경로의 경로를 가져오려면
Navigator.getRouteSegments()
를 호출하세요. - 경로 시작 시 세부 경로 안내를 사용할 수 있나요?
- 예. Navigation SDK는 경로 세그먼트 목록을 제공합니다. 또한 사용자는 헤더의 경로 카드를 스와이프하여 각 방법을 확인할 수 있습니다.
- 도착예정시간이 앱 사용자에게 어떻게 전달되나요?
-
앱 사용자에게 도착예정시간 정보를 제공하려면 다음 단계를 따르세요.
Navigator.getTimeAndDistanceList()
를 사용하여 모든 경유지의 시간과 거리를 검색합니다.- 운전자 도착예정시간에서와 마찬가지로 이 정보를 클라이언트 애플리케이션에 전달하세요.
-
탐색이 포그라운드에 있지 않은 경우
RoadSnappedLocationProvider
를 사용하여 사용자의 현재 맞춰진 위치를 가져올 수 있나요? -
저도요
RoadSnappedLocationProvider
는 기본적으로 백그라운드에서 실행됩니다. - Navigation SDK는 지오펜싱을 지원하나요?
-
아니요. 탐색 컨텍스트에서
remainingTimeOrdistanceChangeListener
는 지오펜싱보다 유리합니다. 지오펜싱은 도로 도형을 고려하지 않을 수 있으며 사용자가 탐색하는 정확한 지점의 중심이 되지 않을 수 있습니다.remainingTimeOrdistanceChangeListener
를 사용하여 이 특성을 추정할 수 있습니다.- 임곗값을 설정하여 콜백 빈도를 결정합니다.
- 목적지까지 남은 거리를 확인합니다.
예를 들어 임곗값을 100m로 설정하면 목적지까지의 거리가 100m 변경될 때 콜백이 수신됩니다. 거리가 줄어들면 이 임곗값을 더 작은 값으로 업데이트하고 콜백을 더 자주 받을 수 있습니다. 그런 다음 남은 거리를 확인하여 승차/하차 위치에 충분히 가까이 있는지 확인합니다.
- 내비게이션 앱이 백그라운드에 있을 때 알림을 사용 중지할 수 있나요?
-
저도요
Navigator.setHeadsUpNotificationEnabled
를 사용하여 알림을 제어합니다. 이 메서드에는 불리언 인수가 있습니다.FALSE
는 알림을 사용 중지하고TRUE
는 알림을 사용 설정합니다. -
거래 기록기는 고유 ID로 승차 및 하차를 추적하며, Google에서 이를 제품 분석을 위해 기록합니다. 모빌리티 서비스 고객이라면
NavigationTransactionRecorder
를 구현하여 거래 기록을 로깅하는 것이 좋습니다.
UI 맞춤설정
- 최적 경로 옵션에 색상을 지정할 수 있나요?
- 아니요. 특정 경로 옵션에 대한 색상 지정은 현재 지원되지 않습니다.
- Navigation SDK에서 최종 목적지의 도착예정시간을 표시할 수 있나요?
-
저도요 다음 메서드를 사용합니다.
Navigator.getTimeAndDistanceList()
를 사용하여 모든 경유지의 시간과 거리를 검색합니다.NavigationFragment.setEtaCardEnabled(false)
를 사용하여 현재 경유지의 도착예정시간을 숨깁니다.- 최종 목적지 ETA를 렌더링합니다.
- 도착예정시간 업데이트를 숨기려면 어떻게 해야 하나요?
-
navigationView.setEtaCardEnabled(false)
를 호출하여 도착예정시간 카드를 사용 중지할 수 있습니다. -
StylingOptions
를 사용하여 배경 색상 스타일 지정을 설정합니다. 머리글과 바닥글을 숨기거나 표시하려면NavigationFragment
의setHeaderEnabled
및setFooterEnabled
멤버 함수를 사용합니다.
라우팅
- 사용자에게 특정 경로를 제공하거나 대체 경로를 삭제할 수 있나요?
- 아니요. 기본적으로 여러 경로가 제공되며 가장 빠른 경로가 우선합니다. 요청에 '고속도로 및 유료도로 제외'와 같은 환경설정을 추가하여 기본 경로에 영향을 줄 수 있습니다. 경유지를 추가하면 경로에도 영향을 줍니다.
- 앱 사용자에게 기본 대상 위치와 다른 대상 라벨을 표시할 수 있나요?
-
저도요 목적지 및 위도/경도의 맞춤 제목으로
Marker
를 만듭니다. Navigation SDK는NavigationMap
에 맞춤 제목과 좌표를 표시합니다. - Navigation SDK를 사용하여 정의된 경로로부터의 편차를 추적할 수 있나요?
-
저도요 경로가 변경되거나 새 경로가 권장될 때 알림을 받으려면
Navigator.setRouteChangedListener
를 사용합니다.Navigator.setRouteChangedListener
메서드를 사용하여 경로를 따라 기기 위치를 확인하는 리스너를 등록합니다.- 콜백 이벤트 핸들러
onRouteChanged
에 코드를 추가합니다.- 업데이트된 도착예정시간 및 거리 정보가 포함된 메시지를 앱 사용자에게 보냅니다.
- 기기 위치 추적
- [선택사항] 사용자가 규정된 경로를 벗어날 때 앱에서 처리해야 하는 다른 기능을 추가합니다.
-
저도요 내비게이션을 중지하려면
Navigator.stopGuidance()
메서드를 호출합니다.
시뮬레이터
- 시뮬레이터에서 경로 변경을 지원하나요?
-
저도요 경로 변경이 포함된 여정을 시뮬레이션하려면
simulateLocationsAlongNewRoute
를 호출합니다.simulateLocationsAlongExistingRoute
메서드는 기존 경로의 변경사항을 무시합니다.
워크플로
- 탐색 프래그먼트가 포함된 활동을 닫은 후 알림을 닫으려면 어떻게 해야 하나요?
-
탐색 알림은 탐색 중에 활동이 닫혀도 계속 표시됩니다. 차량이 목적지에 도착하면 내비게이션이 중지되고 알림이 사라집니다.
알림 클릭을 처리하려면
Navigator.startGuidance(intent resumeIntent)
를 사용합니다.resume intent
는 앱 사용자가 알림을 클릭하면 실행됩니다. 일반적으로Navigator.startguidance(getIntent())
는 앱 사용자가 알림을 클릭할 때 활동을 리콜하는 기본 활동에서 호출됩니다.