Android용 Driver SDK 빠른 참조

Android용 Driver SDK는 Navigation SDK에서 Fleet Engine으로 차량 위치, 경로, 남은 거리, ETA 업데이트를 전송하는 운전자 앱용 모바일 툴킷입니다. 주문형 이동과 예약된 작업 모두 지원합니다.

Android용 Driver SDK: 주요 정보

  • 제품: Android용 Driver SDK
  • 다른 이름: Driver SDK, 주문형 이동을 위한 Driver SDK, 예약된 작업을 위한 Driver SDK
  • 카테고리: 경로
  • 플랫폼: Android
  • 실행 위치: 클라이언트(앱 또는 브라우저 코드)
  • 출시 단계: GA
  • 수명 주기: 활성
  • 개요: Android용 Driver SDK 개요

Android용 Driver SDK: 사용 시기

다음과 같은 경우 Android용 Driver SDK를 사용하세요.

  • 실시간 차량 위치 및 경로 업데이트를 Fleet Engine에 전송하려면 Android 드라이버 앱이 필요합니다.
  • Navigation SDK에서 다음 경유지까지의 남은 거리와 도착 예정 시간을 수신하려면 Fleet Engine이 필요합니다.
  • 할당된 주문형 이동 또는 예약된 작업을 관리하고 내비게이션을 제공하는 하나의 드라이버 앱이 필요합니다.

다음과 같은 경우에는 Android용 Driver SDK를 사용하지 마세요.

  • 앱에 세부 경로 안내 내비게이션만 필요하고 Fleet Engine은 사용하지 않습니다. 대신 Android용 Navigation SDK를 사용하세요.
  • 위치, 경로, 거리, ETA 이외의 차량 데이터 업데이트를 전송해야 합니다(이러한 업데이트는 백엔드를 통해 전송됨). 대신 Fleet Engine Service를 사용하세요.
  • iOS용 운전자 앱을 빌드합니다. 대신 iOS용 Driver SDK를 사용하세요.

Android용 Driver SDK: 설정

Android용 Driver SDK 공식 패키지:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-driver
  • maven: com.google.android.libraries.navigation:navigation

Android용 Driver SDK: 일반적인 실수

  • 문제: 빌드 종속 항목에서 Driver SDK 버전을 지정하지 않으면 IDE가 최신 버전을 로드합니다. v7.0.0부터 새 빌드는 더 이상 Android 6 및 7(API 23~25)을 지원하지 않습니다. 수정: 빌드 종속 항목에 Android용 Driver SDK 버전을 명시적으로 지정하여 지원되는 최소 OS가 변경되는 시점을 제어합니다. /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android를 참고하세요.
  • 문제: Driver SDK는 Navigation SDK에 종속됩니다. 고정된 Navigation SDK 버전이 없으면 프로젝트는 항상 메이저 버전 내에서 최신 Navigation SDK를 다운로드합니다. 해결 방법: Driver SDK와 Navigation SDK 종속 항목을 모두 추가합니다. Navigation SDK를 고정하는 경우 Driver SDK 버전의 출시 노트에 나열된 범위 내에서 버전을 선택합니다(예: Driver SDK 7.1의 경우 [7.0, 8.0)). /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project를 참고하세요.
  • 문제: SDK는 위치 업데이트 시 AuthTokenFactory를 통해 승인 토큰을 요청합니다. 서버에서 JWT를 발급할 수 없는 경우 Fleet Engine 업데이트를 승인할 수 없습니다. 해결 방법: SDK를 초기화하기 전에 서버 측 구현에서 토큰을 발급할 수 있는지 확인하고 만료될 때까지 토큰을 재사용합니다. /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate를 참고하세요.
  • 문제: ProGuard 빌드에서 com.google, io.grpc, okio 클래스에 관한 경고가 생성될 수 있습니다. 해결 방법: ProGuard 구성에 -dontwarn com.google.**, -dontwarn io.grpc.**, -dontwarn okio.**를 추가합니다. /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies를 참고하세요.

Android용 Driver SDK: 기존 및 지원 중단된 기능

  • StatusListener 인터페이스: 2024년 11월 25일부터 사용 중단되었습니다. 대체: DriverStatusListener. 증상: Android용 Driver SDK v6.0.0에서 삭제되었습니다. 이전 가이드를 참고하세요.
  • Android용 Nav/Driver SDK v1.x(결합된 바이너리): 2022년 6월 21일부터 사용 중단되었습니다. 대체: Driver SDK v3 이상과 Navigation SDK 바이너리를 분리합니다. 증상: 2021년 6월 21일에 지원 중단되었으며 2022년 6월 21일 이후 유지보수되지 않습니다. Waypoint#fromLatLng 및 Navigator#startGuidance(resumeIntent)와 같은 메서드가 v3.0에서 삭제되었습니다. 이전 가이드를 참고하세요.
  • AuthTokenContext ServiceType: 2021년 11월 29일부터 사용 중단되었습니다. 대체: 포함된 차량 ID 및 작업 ID에 대한 소유권 주장입니다. 증상: v4.0.0에서 삭제됨: AuthTokenContext의 ServiceType 및 getServiceType(), AuthTokenContext.Builder의 setServiceType 이전 가이드를 참고하세요.
  • Task parentId 속성: 2022년 4월 28일부터 지원 중단되었습니다. 교체: trackingId. Symptom: v4.1.0에서 이름이 변경되었습니다. 이전 속성은 여전히 존재하지만 지원 중단되었습니다.

Android용 Driver SDK로 할 수 있는 작업

각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.