iOS용 Consumer SDK 빠른 참조

iOS용 Consumer SDK를 사용하면 iOS 소비자 앱이 Fleet Engine에서 주문형 이동을 추적할 수 있습니다. GMTCTripModel 및 GMTCJourneySharingSession와 같은 클래스는 이동 데이터를 모델링하고 지도에 차량의 위치, 경로, ETA, 남은 거리를 표시합니다.

iOS용 소비자 SDK: 주요 정보

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

iOS용 소비자 SDK: 사용 시기

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

  • Fleet Engine에서 추적하는 주문형 이동 또는 배송 여정을 소비자가 추적하는 iOS 앱이 필요합니다.
  • iOS 소비자 앱의 지도에 차량의 거의 실시간 위치, 경로, 실시간 교통정보를 표시해야 합니다.
  • iOS에서 주문형 이동의 승차 및 하차 ETA와 남은 거리를 표시해야 합니다.
  • 이미 주문형 이동에 Fleet Engine 및 Driver SDK를 사용하고 있으며 여정 공유의 소비자 측면이 필요합니다.

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

  • 소비자가 예약된 작업 또는 배송을 추적해야 합니다. 예약된 작업 소비자 환경은 JavaScript용으로 문서화되어 있습니다. 대신 JavaScript Consumer SDK를 사용하세요.
  • Android 소비자 앱에서 주문형 이동 진행 상황을 공유해야 합니다. 대신 Android용 소비자 SDK를 사용하세요.
  • 웹 앱에서 주문형 이동 진행 상황을 공유해야 합니다. 대신 JavaScript Consumer SDK를 사용하세요.
  • 운전자의 iOS 앱에서 Fleet Engine으로 운전자의 위치와 이동 상태를 전송해야 합니다. 대신 iOS용 Driver SDK를 사용하세요.

iOS용 소비자 SDK: 설정

공식 iOS용 Consumer SDK 패키지:

  • cocoapods: GoogleRidesharingConsumer
  • swift_package: https://github.com/googlemaps/ios-consumer-sdk

iOS용 Consumer SDK: 일반적인 실수

  • 문제: JWT가 이동 ID 없이 서명되었거나 만료된 경우 이동 모니터링이 401 UNAUTHENTICATED 오류로 실패합니다. 해결 방법: 토큰 제공자(GMTCAuthorization)가 승인 컨텍스트에서 이동 ID에 대해 발급된 JWT를 반환하고, 이동별로 캐시하고, 만료 시 새로고침하도록 합니다. /maps/documentation/mobility/journey-sharing/on-demand/ios/auth-sdk를 참고하세요.
  • 문제: 이동 이름이 providers/{provider_id}/trips/{trip_id} 형식을 사용하지 않으면 이동 모니터링이 400 INVALID_ARGUMENT으로 실패합니다. 해결 방법: Google Cloud 프로젝트 ID를 provider_id로 사용하고 SDK를 초기화할 때 동일한 프로젝트 ID를 providerID로 전달합니다. /maps/documentation/mobility/journey-sharing/on-demand/ios/init-sdk를 참고하세요.
  • 문제: 이동이 완료되거나 취소된 후에도 앱이 업데이트를 계속 수신 대기합니다. 해결 방법: 이동이 완료되거나 취소되면 이동 모델에서 unregisterSubscriber를 호출합니다. /maps/documentation/mobility/journey-sharing/on-demand/ios/share-journey를 참고하세요.
  • 문제: Xcode에 추가하지 않는 한 수동 XCFramework 설치에서는 필수 리소스 번들과 빌드 설정이 생략됩니다. 해결 방법: 가능한 경우 CocoaPods를 사용합니다. 수동 설치의 경우 프로젝트에 gRPCCertificates.bundle 및 GoogleRidesharingConsumer.bundle를 추가하고, 나열된 프레임워크를 연결하고, 디버그 및 출시를 위해 기타 링커 플래그에 -ObjC를 추가합니다. /maps/documentation/mobility/journey-sharing/on-demand/ios/setup을 참고하세요.

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

  • GMTSVehicleLocation -initWithLatLng:latLngAccuracy:heading:headingAccuracy:speed:speedAccuracy:updateTime:isSnappableToRoute: 초기화 도구: 2025년 6월 1일부터 지원 중단되었습니다. 대체: GMTSVehicleLocation -initWithOptions:을(를) GMTSVehicleLocationOptions(으)로 대체합니다.
  • [GMTCMapView initWithCoder]: 2023년 12월 1일부터 지원 중단되었습니다. 교체: GMTCMapView -initWithOptions:.

iOS용 Consumer SDK로 할 수 있는 작업

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