iOS용 Driver SDK 빠른 참조

iOS용 Driver SDK는 모바일 앱 툴킷이자 Fleet Engine의 구성요소입니다. 주문형 이동 및 예약된 작업의 경우 Navigation SDK에서 Fleet Engine으로 운전자 앱의 차량 위치, 경로, 경유지, 남은 거리, ETA를 전송합니다.

iOS용 Driver SDK: 주요 정보

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

iOS용 Driver SDK: 사용 시기

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

  • 실시간 차량 위치 업데이트를 Fleet Engine에 전송하려면 iOS 드라이버 앱이 필요합니다.
  • Navigation SDK에서 Fleet Engine으로 경로, 경유지, 남은 거리, ETA를 보고해야 합니다.
  • 운전자가 앱을 전환하지 않고도 하나의 앱에서 할당된 주문형 이동을 관리하고 탐색할 수 있어야 합니다.
  • iOS에서 Fleet Engine 예약된 작업을 위한 운전자 앱을 빌드하고 있습니다.

iOS용 Driver SDK를 사용하지 않는 경우

  • Fleet Engine 추적 없이 iOS 앱에 세부 경로 안내 내비게이션만 필요합니다. 대신 iOS용 Navigation SDK를 사용하세요.
  • 소비자 앱에서 탑승자 또는 고객에게 이동 또는 배송 진행 상황을 표시해야 합니다. 대신 iOS용 Consumer SDK를 사용하세요.
  • 위치 및 경로 이외의 차량 데이터 업데이트를 전송해야 합니다. 이러한 업데이트는 백엔드를 통해 Fleet Engine으로 전송됩니다. 대신 Fleet Engine Service를 사용하세요.
  • 운전자 앱은 Android에서 실행됩니다. 대신 Android용 Driver SDK를 사용하세요.

iOS용 Driver SDK: 설정

iOS용 Driver SDK 공식 패키지:

  • cocoapods: GoogleRidesharingDriver
  • swift_package: https://github.com/googlemaps/ios-driver-sdk

iOS용 Driver SDK: 일반적인 실수

  • 문제: updateMask 매개변수가 비어 있으면 시작 후 첫 번째 차량 업데이트가 'update_mask cannot be empty' 오류와 함께 실패할 수 있습니다. 해결 방법: 항상 updateMask에 하나 이상의 필드 이름을 제공하고 GMTDVehicleReporterListener didFailVehicleUpdate에서 이 오류를 처리합니다. /maps/documentation/mobility/driver-sdk/on-demand/ios/troubleshoot을 참고하세요.
  • 문제: 마지막 업데이트 이후 기기가 이동하지 않은 경우(예: 운전자가 대기 중인 경우) GMSRoadSnappedLocationProvider에서 위치 업데이트를 계속 전송하지 않습니다. 해결 방법: 기기가 정지된 상태에서 새 위치 업데이트를 전송하려면 GMSRoadSnappedLocationProvider를 중지한 후 시작합니다(GMTDVehicleReporter가 이미 리스너로 추가된 상태). /maps/documentation/mobility/driver-sdk/on-demand/ios/vehicle-ready를 참고하세요.
  • 문제: setDestinations()에 전달된 좌표가 이동의 경유지와 일치하지 않으면 소비자 앱에서 이동을 올바르게 렌더링하지 않습니다. 해결 방법: setDestinations()에 전달된 위도/경도가 Fleet Engine의 이동 경유지 좌표와 일치하는지 확인합니다. /maps/documentation/mobility/driver-sdk/on-demand/ios/trip-details를 참고하세요.
  • 문제: 낙관적 버전 연산자(~>)를 사용하면 예측할 수 없고 반복할 수 없는 빌드가 발생할 수 있으며, 버전을 생략하면 최신 SDK가 로드되어 브레이킹 체인지가 포함되거나 최소 iOS 버전이 높아질 수 있습니다. Carthage는 지원되지 않습니다. 해결 방법: CocoaPods 또는 Swift Package Manager에서 정확한 Driver SDK 버전을 고정하고 업그레이드하기 전에 출시 노트를 확인하세요. /maps/documentation/mobility/driver-sdk/on-demand/ios/versions를 참고하세요.

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

  • GMTSVehicleMatch 클래스: 지원 중단됨. 대체: Driver SDK에서는 대체가 필요하지 않습니다(차량 일치는 Fleet Engine에서 처리됨). 증상: iOS용 Driver SDK v2.2.0에서 지원 중단되었으며 현재 Driver SDK 참조에서 생략되었습니다. 이전 가이드를 참고하세요.
  • GMTSServiceType 및 fetchAuthTokenForServiceType:authorizationContext:completion:: 2021년 11월 29일부터 지원 중단되었습니다. 교체: GMTDAuthorization fetchTokenWithContext:completion:를 GMTDAuthorizationContext로 교체합니다(차량 ID에 대한 소유권 주장만 해당). 이전 가이드를 참고하세요.

iOS용 Driver SDK로 할 수 있는 작업

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