Android용 소비자 SDK 빠른 참조

Android용 Consumer SDK는 주문형 이동을 위한 Fleet Engine의 일부입니다. 이 SDK는 이동 데이터를 모델링하고 Fleet Engine에서 이동을 추적하는 인터페이스와, Android 앱에서 이동 진행 상황(차량 위치, 경로, ETA, 남은 거리, 교통정보)을 소비자와 공유하는 지도 기반 디스플레이를 빌드하는 클래스를 제공합니다.

Android용 소비자 SDK: 주요 정보

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

Android용 소비자 SDK: 사용 시기

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

  • Android 앱의 소비자가 백엔드가 Fleet Engine에서 추적하는 주문형 이동(탑승, 주문 또는 배송)을 따라야 합니다.
  • Android 소비자 앱의 지도에 차량의 거의 실시간으로 도로에 스냅된 위치와 경로를 표시해야 합니다.
  • Android에서 Fleet Engine 이동의 승차 및 하차 예상 도착 시간, 남은 거리, 실시간 교통정보를 표시해야 합니다.
  • Android에서 여정 공유 지도의 이동 마커, 경로 다중선 또는 지도 스타일을 맞춤설정해야 합니다.

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

  • iOS 앱에서 주문형 이동을 위한 여정 공유가 필요합니다. 대신 iOS용 소비자 SDK를 사용하세요.
  • 웹페이지에서 여정 공유가 필요하거나 배송과 같은 예약된 작업의 소비자 추적이 필요합니다. 대신 JavaScript Consumer SDK를 사용하세요.
  • 운전자의 Android 앱에서 운전자 위치와 이동 진행 상황을 보고해야 합니다. 대신 Android용 Driver SDK를 사용하세요.

Android용 소비자 SDK: 설정

공식 Android용 Consumer SDK 패키지:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

Android용 소비자 SDK: 일반적인 실수

  • 문제: Maps SDK 종속 항목이 명시적 버전으로 설정되지 않은 경우 소비자 SDK는 필요한 최소 Maps SDK 버전을 사용하므로 이후 Maps SDK 버전의 기능에 의존하는 앱이 중단될 수 있습니다. 해결 방법: Gradle 또는 Maven에서 transportation-consumer와 함께 명시적으로 정의된 play-services-maps 버전을 선언합니다. /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project를 참고하세요.
  • 문제: 이동이 종료된 후 여정 공유를 중지하지 않으면 Fleet Engine에 불필요한 네트워크 요청이 발생하고 메모리 누수가 발생합니다. 해결 방법: 이동이 더 이상 필요하지 않은 경우(예: onDestroy() 또는 이동이 COMPLETE인 경우) JourneySharingSession.stop()를 호출합니다. /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey를 참고하세요.
  • 문제: API 인스턴스가 이미 있는 경우 ConsumerApi.initialize()에서 예외가 발생합니다(2.0.0 이상). 해결 방법: 먼저 ConsumerApi.getInstance()를 호출하고 반환된 Task를 확인하여 인스턴스가 이미 있는지 확인합니다. /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android를 참고하세요.
  • 문제: Consumer SDK v3 이하에서는 전체 R8 모드를 지원하지 않습니다. AGP 8.0 이상을 타겟팅하는 앱에서 빌드 또는 런타임 문제가 발생할 수 있습니다. 수정: AGP 8.0 이상을 타겟팅할 때 android.enableR8.fullMode=false를 설정하고 Consumer SDK 3.0 이상에서 Kotlin 2.0과 함께 AGP 7.3 이상을 사용합니다. /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3를 참고하세요.

Android용 소비자 SDK: 기존 및 지원 중단된 기능

  • ConsumerTrip, ConsumerTripCallback, ConsumerTripManager, ConsumerTripOptions: 2023년 9월 15일부터 사용 중단되었습니다. 교체: TripModel, TripModelCallback, TripModelManager, TripModelOptions. 이전 가이드를 참고하세요.
  • Trip 클래스 및 Trip.TripStatus / Trip.TripType 주석(TripInfo#getTripStatus(), TripInfo#getTripType(), TripModelCallback#onTripStatusUpdated): 2023년 9월 15일부터 지원 중단되었습니다. 교체: TripInfo.TripStatus / TripInfo.TripType, TripInfo#getCurrentTripStatus(), TripInfo#getCurrentTripType(), TripModelCallback#onTripStatusUpdate. 이전 가이드를 참고하세요.
  • MarkerStyleOptions 및 PolylineStyleOptions: 2021년 11월 30일부터 사용 중단되었습니다. 대체: MarkerOptions 및 PolylineOptions(Maps SDK와 공유됨) 증상: Consumer SDK는 MarkerOptions 기본값이 아닌 마커 또는 다중선 유형별로 자체 기본 스타일을 적용합니다. 이전 가이드를 참고하세요.
  • 비공개 저장소 배포 채널: 지원 중단됨. 대체: Google Maven 저장소(버전 2.1.0 이상) 이전 가이드를 참고하세요.

Android용 Consumer SDK로 할 수 있는 작업

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