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: 설정
- 인증: JSON 웹 토큰(JWT)
- 또한 다음을 사용 설정합니다. Fleet Engine 서비스
- 시작하기: iOS용 Consumer SDK 설정
- 참조: iOS용 Consumer SDK 참조
- 정책: iOS용 Consumer SDK 정책
- 출시 노트: iOS용 Consumer SDK 출시 노트
공식 iOS용 Consumer SDK 패키지:
- cocoapods:
GoogleRidesharingConsumer - swift_package:
https://github.com/googlemaps/ios-consumer-sdk
iOS용 Consumer SDK: 관련 상품
- 함께 자주 사용되는 제품: Fleet Engine 서비스, iOS용 Driver SDK, Android용 Driver SDK, iOS용 Maps 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}형식을 사용하지 않으면 이동 모니터링이 400INVALID_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로 할 수 있는 작업
각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.
- Fleet Engine에서 모바일 앱으로 이동 진행 상황을 추적하는 맞춤설정 가능한 대화형 지도를 추가합니다.
- Fleet Engine에서 웹페이지 또는 모바일 앱의 지도로 이동을 추적하는 경로 다중선을 추가합니다.
- Fleet Engine 이동을 위해 웹페이지 또는 모바일 앱의 지도에서 경로를 따라 이동 진행 상황을 업데이트합니다.
- Fleet Engine에서 이동 진행 상황을 추적하는 지도에서 도로, 다중선, 다각형의 스타일을 변경합니다.
- Fleet Engine에서 이동 진행 상황을 추적하는 지도에 지도 지형지물을 표시하거나 숨깁니다.
- Fleet Engine에서 이동 진행 상황을 추적하는 지도의 아이콘 및 텍스트 라벨 스타일을 변경합니다.
- Fleet Engine에서 이동 진행 상황을 추적하는 지도에서 확대/축소 수준에 따라 다양한 지도 스타일을 적용합니다.
- Fleet Engine에서 이동 진행 상황을 추적하는 지도에서 장소의 밀도를 변경합니다. 실험용 참고: Consumer SDK의 클라우드 기반 지도 스타일 지정 지원은 정식 버전이지만 관심 장소 밀도 제어는 실험용 클라우드 기반 지도 스타일 지정 기능입니다(밝은 지도 스타일에서만 지원됨).
- Fleet Engine에서 이동 진행 상황을 추적하는 지도의 건물 스타일을 변경합니다. 실험용 참고: Consumer SDK의 클라우드 기반 지도 스타일 지정 지원은 정식 버전이지만 3D 및 풋프린트 건물 스타일 맞춤설정은 실험용 클라우드 기반 지도 스타일 지정 기능입니다(밝은 지도 스타일에서만 지원됨).
- Fleet Engine에서 이동 진행 상황을 추적하는 지도의 명소 스타일을 변경합니다. 실험용 참고: Consumer SDK의 클라우드 기반 지도 스타일 지정 지원은 정식 버전이지만, 명소 아이콘 맞춤설정은 실험용 클라우드 기반 지도 스타일 지정 기능입니다(밝은 지도 스타일에서만 지원됨).
- Fleet Engine에서 이동 진행 상황을 추적하는 지도에서 마커를 맞춤설정합니다.
- Fleet Engine에서 이동 진행 상황을 추적하는 지도에서 경로 다중선을 맞춤설정합니다.