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: 설정
- 인증: API 키, JSON 웹 토큰(JWT)
- 사용 설정할 API: iOS용 Maps SDK
- 시작하기: iOS용 Driver SDK 설정
- 참조: iOS용 Driver SDK 참조
- 정책: iOS용 Driver SDK 정책
- 출시 노트: iOS용 Driver SDK 출시 노트
iOS용 Driver SDK 공식 패키지:
- cocoapods:
GoogleRidesharingDriver - swift_package:
https://github.com/googlemaps/ios-driver-sdk
iOS용 Driver SDK: 관련 제품
- 함께 자주 사용되는 제품: iOS용 Navigation SDK, Fleet Engine 서비스, iOS용 Consumer SDK
iOS용 Driver SDK: 일반적인 실수
- 문제:
updateMask매개변수가 비어 있으면 시작 후 첫 번째 차량 업데이트가 'update_mask cannot be empty' 오류와 함께 실패할 수 있습니다. 해결 방법: 항상updateMask에 하나 이상의 필드 이름을 제공하고GMTDVehicleReporterListenerdidFailVehicleUpdate에서 이 오류를 처리합니다. /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일부터 지원 중단되었습니다. 교체:GMTDAuthorizationfetchTokenWithContext:completion:를GMTDAuthorizationContext로 교체합니다(차량 ID에 대한 소유권 주장만 해당). 이전 가이드를 참고하세요.
iOS용 Driver SDK로 할 수 있는 작업
각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.
- 차량의 실시간 위치를 Fleet Engine 서비스에 보고합니다.
- Navigation SDK에서 Fleet Engine 서비스로 차량의 이동 경유지 위도/경도 좌표를 보고합니다.
- 차량의 다음 경유지까지 남은 거리를 Fleet Engine 서비스에 보고합니다.
- 차량이 다음 경유지에 도착하는 예상 시간을 Fleet Engine 서비스에 보고합니다.
- Navigation SDK에서 차량에 제공한 경로를 Fleet Engine 서비스에 보고합니다.