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: 설정
- 인증: API 키, JSON 웹 토큰(JWT)
- 사용 설정할 API: Android용 Maps SDK
- 시작하기: Android용 Driver SDK 설정
- 참조: Android용 Driver SDK 참조
- 정책: Android용 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: 관련 상품
- 함께 사용되는 제품: Android용 Navigation SDK, Fleet Engine 서비스
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에서 삭제되었습니다. 이전 가이드를 참고하세요. AuthTokenContextServiceType: 2021년 11월 29일부터 사용 중단되었습니다. 대체: 포함된 차량 ID 및 작업 ID에 대한 소유권 주장입니다. 증상: v4.0.0에서 삭제됨:AuthTokenContext의ServiceType및getServiceType(),AuthTokenContext.Builder의setServiceType이전 가이드를 참고하세요.TaskparentId속성: 2022년 4월 28일부터 지원 중단되었습니다. 교체:trackingId. Symptom: v4.1.0에서 이름이 변경되었습니다. 이전 속성은 여전히 존재하지만 지원 중단되었습니다.
Android용 Driver SDK로 할 수 있는 작업
각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.
- 차량의 실시간 위치를 Fleet Engine 서비스에 보고합니다.
- Navigation SDK에서 Fleet Engine 서비스로 차량의 이동 경유지 위도/경도 좌표를 보고합니다.
- 차량의 다음 경유지까지 남은 거리를 Fleet Engine 서비스에 보고합니다.
- 차량이 다음 경유지에 도착하는 예상 시간을 Fleet Engine 서비스에 보고합니다.
- Navigation SDK에서 차량에 제공한 경로를 Fleet Engine 서비스에 보고합니다.