자주 묻는 질문(FAQ)

제품 세부정보

네트워크 및 연결

데이터

UI 맞춤설정

라우팅

시뮬레이터

워크플로

이동성 서비스

제품 세부정보

앱은 각 사용자가 수락해야 하는 Navigation SDK 서비스 약관 알림이 포함된 대화상자를 구현해야 합니다. 이 대화상자를 통해 사용자는 서비스 약관에 동의할 수 있습니다. 용어의 텍스트 파일은 Navigation SDK와 함께 제공됩니다. NavigationApi.showTermsAndConditionsDialog 메서드를 사용하여 약관이 포함된 대화상자를 표시합니다.
Google 지도 모바일에서 지원하는 모든 언어는 Navigation SDK에서 자동으로 사용할 수 있습니다. 기기에는 기본 시스템 언어가 있으며 앱은 이 설정을 변경할 수 없습니다. 하지만 앱은 70개가 넘는 언어에 액세스할 수 있습니다.

예. 일단 시작되면 LocationListener는 백그라운드에서 계속 실행됩니다. 앱은 계속해서 도로에서 위치를 스냅하고 방향을 유지합니다.

예. 경로가 생성되거나 변경되면 RouteChangeListener가 다중선을 제공합니다.

아니요. Navigation SDK를 사용하려면 기기에 Google Maps Mobile이 설치되어 있지 않아도 됩니다.
아니요. 현재 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는 약한 GPS 신호 또는 GPS 신호가 끊긴 상황을 어떻게 처리하나요?

내비게이션이 시작되고 Navigation SDK가 GPS 신호를 한 번 이상 수신한 후 다음과 같은 상황에서 'GPS를 찾는 중...' 메시지가 표시됩니다.

  • 마지막으로 GPS 신호를 수신한 후 10초가 지났습니다.
  • 마지막으로 GPS 신호를 수신한 이후 경로 위치가 500m 이상 이동한 경우

SDK가 장시간 GPS 신호를 수신하지 못하면 앱에 화살표 위치로 표시되는 경로 진행률이 느려져 완전히 중지될 수 있습니다. 이 경우 지도의 셰이본은 마지막 GPS 신호로 표시된 위치에 유지됩니다. GPS 신호를 수신하지 못해도 SDK는 자동으로 내비게이션 모드를 종료하지 않습니다. 하지만 신호를 다시 수신할 때까지 안내를 제공하지 못할 수도 있습니다.

오프라인 모드를 사용할 수 있나요?
아니요. 현재 Navigation SDK는 오프라인 모드를 제공하지 않습니다. 하지만 SDK는 경로에 대해 사전 캐시된 정보를 제공합니다.

데이터

경로를 시작하기 전에 경로의 모든 정류장/도착지를 가져올 수 있나요?

예. 경로의 경로를 가져오려면 Navigator.getRouteSegments()를 호출합니다.

경로 시작 시 세부 경로 안내를 사용할 수 있나요?
예. Navigation SDK는 경로 세그먼트 목록을 제공합니다. 또한 사용자는 헤더의 경로 카드를 스와이프하여 각 조작을 볼 수 있습니다.
도착 예정 시간이 앱 사용자에게 어떻게 전달되나요?

다음 단계에 따라 앱 사용자에게 ETA 정보를 제공하세요.

  1. Navigator.getTimeAndDistanceList()를 사용하여 모든 경유지의 시간과 거리를 가져옵니다.
  2. 운전자 도착 예정 시간과 마찬가지로 이 정보를 클라이언트 애플리케이션에 전달합니다.
내비게이션이 포그라운드에 있지 않은 경우 RoadSnappedLocationProvider를 사용하여 사용자의 현재 스냅된 위치를 가져올 수 있나요?

예. RoadSnappedLocationProvider는 기본적으로 백그라운드에서 실행됩니다.

Navigation SDK는 지오펜싱을 지원하나요?

아니요. 탐색 컨텍스트에서 remainingTimeOrdistanceChangeListener는 지오펜싱보다 유리합니다. 지오펜스는 도로 도형을 고려하지 않을 수 있으며 사용자가 이동 중인 정확한 지점에 중심을 두지 않을 수 있습니다.

remainingTimeOrdistanceChangeListener를 사용하여 이 기능을 근사할 수 있습니다.

  1. 콜백 빈도를 결정하는 기준을 설정합니다.
  2. 목적지까지의 남은 거리를 확인합니다.

예를 들어 기준을 100m로 설정하면 목적지까지의 거리가 100m 변경될 때 콜백이 수신됩니다. 거리가 줄어들수록 이 임곗값을 더 작은 값으로 업데이트하고 콜백을 더 자주 받을 수 있습니다. 그런 다음 남은 거리를 확인하여 픽업/하차 장소에 충분히 가까운지 확인합니다.

내비게이션 앱이 백그라운드에 있을 때 알림을 사용 중지할 수 있나요?

예. Navigator.setHeadsUpNotificationEnabled를 사용하여 알림을 제어합니다. 이 메서드에는 불리언 인수가 있습니다. FALSE는 알림을 사용 중지하고 TRUE는 알림을 사용 설정합니다.

거래 레코더는 제품 분석 목적으로 Google에서 로깅하는 고유 ID로 픽업 및 하차를 추적합니다. Mobility Services 고객인 경우 NavigationTransactionRecorder를 구현하여 거래 기록을 로깅하는 것이 좋습니다.

UI 맞춤설정

가장 좋은 경로 옵션에 색상 코드를 지정할 수 있나요?
아니요. 특정 경로 옵션에 색상 코딩을 적용하는 기능은 현재 지원되지 않습니다.
Navigation SDK에서 최종 목적지의 도착 예정 시간을 표시할 수 있나요?

예. 다음 방법을 사용하세요.

  1. Navigator.getTimeAndDistanceList()를 사용하여 모든 경유지의 시간과 거리를 가져옵니다.
  2. NavigationFragment.setEtaCardEnabled(false)를 사용하여 현재 중간 지점의 도착예정시간을 숨깁니다.
  3. 최종 도착 시간(ETA)을 렌더링합니다.
ETA 업데이트를 숨기려면 어떻게 해야 하나요?

navigationView.setEtaCardEnabled(false)를 호출하여 도착 예정 시간 카드를 사용 중지할 수 있습니다.

머리글 및 바닥글 카드에 어떤 UI 맞춤설정을 사용할 수 있나요?

StylingOptions를 사용하여 배경 색상 스타일을 설정합니다. 헤더와 바닥글을 숨기거나 표시하려면 NavigationFragment의 setHeaderEnabled 및 setFooterEnabled 멤버 함수를 사용합니다.

라우팅

사용자에게 특정 경로를 제공하거나 대체 경로를 삭제할 수 있나요?
아니요. 기본적으로 여러 경로가 제공되며 가장 빠른 경로가 우선 적용됩니다. 요청에 '고속도로 및 유료 도로 피하기'와 같은 환경설정을 추가하여 기본 경로에 영향을 줄 수 있습니다. 경로에 경유지를 추가하면 경로에도 영향을 미칩니다.
앱 사용자에게 기본 대상 위치와 다른 대상 라벨을 표시할 수 있나요?

예. 대상의 맞춤 제목과 위도/경도로 Marker를 만듭니다. Navigation SDK는 NavigationMap에 맞춤 제목과 좌표를 표시합니다.

Navigation SDK를 사용하여 정의된 경로에서의 편차를 추적할 수 있나요?

예. 경로가 변경되거나 새 경로가 추천될 때 알림을 받으려면 Navigator.setRouteChangedListener를 사용하세요.

  1. Navigator.setRouteChangedListener 메서드를 사용하여 경로를 따라 기기 위치를 확인하는 리스너를 등록합니다.
  2. 콜백 이벤트 핸들러 onRouteChanged에 코드를 추가합니다.
    • 업데이트된 도착예정시간 및 거리 정보를 포함하여 앱 사용자에게 메시지를 보냅니다.
    • 기기의 위치를 추적합니다.
    • [선택사항] 사용자가 지정된 경로를 벗어날 때 처리하는 데 앱에 필요한 다른 기능을 추가합니다.
사용자가 경로를 완료하지 않고 탐색을 종료할 수 있나요?

예. Navigator.stopGuidance() 메서드를 호출하여 탐색을 중지합니다.

시뮬레이터

시뮬레이터가 경로 변경을 지원하나요?

예. simulateLocationsAlongNewRoute를 호출하여 경로 변경이 포함된 여정을 시뮬레이션합니다. simulateLocationsAlongExistingRoute 메서드는 기존 경로의 변경사항을 무시합니다.

워크플로

탐색 프래그먼트가 포함된 활동을 닫은 후 알림을 닫으려면 어떻게 해야 하나요?

내비게이션 알림은 내비게이션 중과 활동이 닫혔을 때 계속 표시됩니다. 차량이 목적지에 도착하면 내비게이션이 중지되고 알림이 사라집니다.

알림 클릭을 처리하려면 Navigator.startGuidance(intent resumeIntent)를 사용합니다. resume intent는 앱 사용자가 알림을 클릭할 때 실행됩니다. 일반적으로 Navigator.startguidance(getIntent())는 앱 사용자가 알림을 클릭할 때 Activity를 호출하는 기본 Activity에서 호출됩니다.

이동성 서비스

모빌리티 서비스 고객의 Navigation SDK 사용은 어떻게 다른가요?

Google Maps Platform Mobility Services는 운송 및 물류 비즈니스에 대한 기업의 요구사항을 지원하는 API 및 SDK 모음을 제공합니다. 이동성 서비스 고객의 경우 Navigation SDK는 일반적으로 경로 최적화, 전달, 작업 추적, 차량 분석 등을 위한 관련 서비스와 함께 사용됩니다. 또한 Mobility Services 고객의 경우 Navigation SDK에 별도의 요금이 청구됩니다. 자세한 내용은 모빌리티 서비스 문서를 참고하세요.

이동성 제품은 현재 일부 고객에게만 제공됩니다. 자세한 내용은 영업 담당자에게 문의하세요.

이동통신 서비스 고객인지 어떻게 알 수 있나요?
현재 이동성 서비스 고객으로 내비게이션 SDK를 구현하고 있는지 확실하지 않은 경우 코드에서 ReportBillableEvent 호출을 찾습니다. 이동성 서비스 고객만 ReportBillableEvent 메서드를 호출해야 합니다.

이동성 서비스 고객의 Navigation SDK 요금은 어떻게 청구되나요?
모빌리티 서비스 고객의 경우 Navigation SDK의 결제 및 가격은 Google Maps Platform과의 서비스 계약에 따라 다릅니다. 이동성 서비스 구현에 대해 올바르게 청구되는지 확인하는 방법에 대한 자세한 내용은 결제 유효성 검사를 참고하세요. 이동통신 서비스 결제에 대한 자세한 내용은 영업 담당자에게 문의하세요.

이동성 서비스 고객만 사용해야 하는 내비게이션 SDK API는 무엇인가요?

Navigation SDK에는 Google에서 거래별로 요금을 청구하는 Mobility Services 고객만 사용할 수 있는 여러 API가 있습니다. Mobility Services 고객이 아닌 경우 다음 메서드는 작동하지 않습니다.

이동성 서비스 고객인 경우 이동성 서비스가 아닌 구현의 내비게이션 SDK를 사용할 수도 있나요?

예, 이동성 서비스 고객은 이동성 서비스와 이동성 서비스가 아닌 내비게이션 SDK 구현을 모두 사용할 수 있습니다. 그러나 앱에서는 한 번에 하나의 구현 유형만 사용할 수 있습니다. 또한 이동성 서비스 구현에 사용하는 것과 별도로 새 Google Cloud 프로젝트, 결제 계정, API 키를 만들어야 합니다. 자세한 내용은 Navigation SDK 설정 개요를 참고하세요.

앱을 한 구현 유형에서 다른 구현 유형으로 이전하는 등 Navigation SDK의 이동성 서비스가 아닌 구현 사용에 관한 자세한 내용은 Google 계정 담당자에게 문의하세요.

참고: 현재 Mobility Services 고객이 아니지만 Mobility Services API 및 SDK 모음에 대해 자세히 알아보려면 Google Maps Platform 영업팀에 문의하세요.