本節提供 Consumer SDK for iOS 的版本資訊。
v11.1.0 (2026 年 9 月)
- 11.1.0 版的版本升級。
- 修正小錯誤並更新內部依附元件。
v10.10.1 (2026 年 5 月)
- [修正錯誤] 修正迴歸問題:如果回應中缺少特定欄位,行程更新可能會失敗。
v10.10 (2026 年 3 月)
- [修正錯誤] 進行變更,協助 ConsumerSDK 在行程期間發生網路中斷時,能更快復原。
- Consumer SDK 是以 Xcode 26 建構。
v10.0.0 (2025 年 6 月)
已變更
- 我們已停止支援 iOS 15。最低 iOS 版本現為 16.0。
API 變更
- 新增
GMTSVehicleLocationOptions類別,您可以使用serverTime屬性,判斷 Fleet Engine 收到最新位置更新的時間。 - 在
GMTSVehicleLocation中新增initWithOptions<GMTSVehicleLocationOptions>初始化工具 - 淘汰
GMTSVehicleLocation中的initWithLatLng:GMTSLatLng初始化器。請改用initWithOptions:<GMTSVehicleLocationOptions>初始化器。
v9.2.1 (2025 年 4 月)
已變更
- 修正未定義符號錯誤。
v9.2 (2025 年 1 月)
已變更
- 版本從 9.0 升級至 9.2。
- 支援雲端式地圖樣式設定。
- 支援使用者在行程期間擷取「車輛位置」狀態。
- 修正折線消失的罕見問題。
v9.0 (2024 年 7 月)
已變更
- 支援 Geo iOS SDK 9.0 版。
- 我們已停止支援 iOS 14。iOS 最低版本現為 15.0。
- 這個版本包含 .xcprivacy 檔案,可支援 Apple 隱私權資訊清單。
- 包含可能修正罕見記錄相關當機問題的措施。
v3.3.0 (2024 年 3 月)
已變更
- 支援 Driver 和 Consumer SDK 相容性,因此可在同一個應用程式中建構。
- 支援 Driver 和 Consumer SDK 的 Swift Package Manager。
v3.2.0 (2023 年 12 月)
已變更
- 修正錯誤並更新說明文件。
已淘汰
- 淘汰
GMTCMapView中的[GMTCMapView initWithCoder]。
v3.1.1 (2023 年 10 月)
已變更
- 修正未呼叫
GMSMapViewDelegate方法的錯誤。
v3.1.0 (2023 年 9 月)
已變更
- Consumer SDK 的 CocoaPod 現在是 .xcframework,支援在 Intel 和 Apple Silicon 架構 Mac 上開發的裝置和模擬器版本。
v3.0.1 (2023 年 8 月)
已變更
- 修正未定義符號錯誤。
v3.0.0 (2023 年 5 月)
已變更
- 移除
GMTCMapView中已淘汰的初始化器。 - 修正從
GMTCTripModel移除所有訂閱者後,仍持續擷取驗證權杖的問題。 - 我們已停止支援 iOS 13。iOS 最低版本現為 14.0。
- 現在支援的最低 Xcode 版本為 14.0。請注意 Xcode 14 版本資訊中,有關終止支援使用中間碼建構的淘汰項目。
- 根據行動作業系統版本支援政策,我們將自 Consumer SDK for iOS 3.0.0 版起,停止支援 iOS 13。現在支援的最低 OS 版本為 iOS 14。舊版 SDK 將繼續支援 iOS 13。如果依附元件未指定版本號碼,IDE 會載入最新版 SDK,且應用程式的新版本將不支援 iOS 13。在應用程式的建構依附元件中指定 Consumer SDK for iOS 版本,即可控管何時提高新版應用程式的最低支援 OS 版本。
公告
2023 年 5 月 15 日:停止支援 iOS 14
根據行動作業系統版本支援政策,我們將在即將推出的 Consumer SDK for iOS 主要版本中,停止支援 iOS 14。
2024 年第二季起推出的 Consumer SDK for iOS 版本,最低支援 iOS 15。舊版 SDK 將繼續支援 iOS 14。
如果依附元件未指定版本號碼,IDE 會載入最新版 SDK,而應用程式的新版本將不支援 iOS 14。
在應用程式的建構依附元件中指定 Consumer SDK for iOS 版本,即可控管何時提高新版應用程式的最低支援 OS 版本。
v2.2.0 (2023 年 2 月)
已變更
- 將標頭檔案中的條款及細則網址更新為正確連結,並修正其他標點符號相關的小問題。
- 修正說明文件中的各種拼字、標點符號和其他細微錯誤。
v2.1.0 (2022 年 9 月 12 日)
已變更
- 修正錯誤並更新說明文件。
v2.0.0 (2022 年 7 月 18 日)
已變更
移除終端點服務,包括:
GMTSTerminalPointGMTSTerminalPointAccessPointGMTSTerminalPointTravelModeGMTSTerminalPointsVehicleSearchPreferenceGMTSTravelModeETA
我們已停止支援 iOS 12。iOS 最低版本現為 13.0。
已淘汰
- 已淘汰公開類別 GMTCMapView 中的初始化器。
公告
在 2023 年 Consumer iOS SDK 主要版本更新中,我們將凍結 (淘汰) 對 iOS 13 的支援。自 2023 年 6 月起,支援的最低 iOS 版本為 iOS 14。客戶應在更新前,先變更程式碼中的最低版本支援旗標,做好準備。
v1.0.6 (2022 年 3 月 24 日)
修正內部錯誤。
v1.0 (2021 年 12 月 7 日)
這個版本支援的最低 iOS 版本為 12.0。
API 變更
驗證異動
SDK 會針對每個 gRPC 呼叫
getToken(),以實作AuthTokenFactory介面。SDK 會攔截對 Fleet Engine 的呼叫,然後將getToken()傳回的 JWT 附加至 HTTP 授權標頭,藉此完成這項作業。請注意,您必須自行產生有效的權杖。也就是未過期且具有適當宣告的權杖。已將
GMTSAuthorization變更為GMTCAuthorization。已移除「
GMTSServiceType」。
行程資訊和回呼異動
更新行程屬性名稱:
remainingDistanceOfActiveRouteInMeters。GMTCTripModelSubscriber新增了流量資料更新功能。新增
remainingDistanceOfCurrentRouteInMeters屬性。在
GMTSTripPropertyFields中新增屬性:GMTSTripPropertyFieldRemainingDistanceOfActiveRouteInMeters。GMTSTripPropertyFieldDistanceOfRemainingRouteInMetersGMTSTripPropertyFieldActiveRoute。GMTSTripPropertyFieldActiveRouteTrafficGMTSTripPropertyFieldRemainingRoute。GMTSTripPropertyFieldRemainingRouteTraffic。
在
GMTSTrip中新增remainingDistanceOfActiveRouteInMeters和distanceOfRemainingRouteInMeters屬性。RegisterSubscriber現在會自動開始監控tripModel的行程。如果沒有訂閱者,UnregisterSubscriber就會停止監控。ModelState和ModelOptions已分別重新命名為state和options。已從公開標頭中移除stop和start。modelState已重新命名為state。modelOptions已重新命名為options。- 在
TripModel中移除start()和stop()。
其他 API 異動
移除了
GMTSTripPreview和GMTSTripPreviewVehicleOptions。移除取貨地點選擇服務,包括:
GMTSPickupPointArea。GMTSPickupPointGroup。GMTSPickupPointMatch。
2021 年 10 月 18 日:停止支援 iOS 12
為因應內部依附元件的異動,我們將在即將推出的 iOS 版 Consumer SDK 主要版本中,停止支援 iOS 12。
iOS 版 Consumer SDK 2.0 以上版本僅支援搭載 iOS 13 以上版本的裝置。舊版 SDK 將繼續支援 iOS 12。
如果 CocoaPods 或 Carthage 中的依附元件未指定版本編號,Xcode 會載入最新版本,而應用程式的新版本將不支援 iOS 12。
請務必在應用程式的建構依附元件中指定版本,以便控管何時提高新版應用程式的最低支援 OS 版本。如需指定版本的範例,請參閱 Maps SDK for iOS 說明文件。請參閱應用程式維護最佳做法指南。
v0.11.0 (2021 年 9 月 30 日)
變更
- 新增 SDK 初始化期間的當機偵測功能。您也可以在
GMTCServices上使用setAbnormalTerminationReportingEnabled:API 選擇不採用。
API 變更
已更新所有課程的名稱前置字串:
- GRC -> GMTC,例如 GRCMapView -> GMTCMapView。
- GRS -> GMTS,例如 GRSTrip -> GMTSTrip。
GMTSAuthorization API 更新
新增鍵
kGMTSAuthorizationContextKeyTaskID,用於在呼叫 fetchAuthTokenForServiceType:authorizationContext:completion: 時,在authorizationContext中指定任務 ID。GMTSServiceType 列舉更新:
舊值 新值 GMTSServiceTypeUnknownGMTSServiceTypeUnspecifiedGMTSServiceTypeTripServiceGMTSServiceTypeVehicleServiceGMTSServiceTypeVehicleGMTSServiceTypeTerminalPointServiceGMTSServiceTypeTask
v0.10.0 (2021 年 5 月 3 日)
變更
不再支援 iOS 10.x。現在最低支援的 iOS 版本為 11.0。
API 變更
推出
GRCMutableMarkerStyleOptions,讓行程分享標記自訂更便利。在
GRCTripModelSubscriber通訊協定中導入tripModel:didUpdateRemainingRoute:和tripModel:didUpdateRemainingRouteDistance:,以便在剩餘路線或距離更新時,接收行程更新回呼。
v0.9.0 (2021 年 1 月 25 日)
改善項目
- 這個版本推出路況感知折線,用於分享行程。
API 變更
- 推出
GRCMutablePolylineStyleOptions,用於自訂折線,可啟用行程分享的路況折線算繪功能。 - 在
GRCTripModelSubscriber中新增廣告流量資料更新回呼: GRSTrafficData推出。- 在
GRSTripWaypoint中新增屬性,用於存取車流量資料: - 在
GRSTrip中新增了用於存取流量資料的方法:
v0.6.7 (2020 年 3 月 23 日)
改善項目
- 行程狀態為
ARRIVED_AT_PICKUP時,系統不會顯示路線折線。 - 改善偏離路線車輛追蹤功能 (需要 DriverSDK 1.15):
- 車輛駛過上車地點時,車輛追蹤功能不會將車輛貼齊路線。
- 車輛追蹤功能可顯示車輛在道路外的位置,例如未在地圖上標示的停車場。
- 當駕駛的目的地與 Fleet Engine 中的目的地不符時,車輛圖示不會再強制顯示過時路線。
- 系統現在會捨棄過時的行程回應。
v0.6.3 (2019 年 12 月 16 日)
變更
新增行程要求延遲時間的記錄。
新增行程回應錯誤的記錄。
v0.5.4(86.0) (2019 年 8 月 7 日)
新功能
- 支援多個目的地的行程分享。
API 變更
GRSTripStatus新增了行程狀態。GRSTripStatusEnrouteToIntermediateDestination。GRSTripStatusArrivedAtIntermediateDestination。
GRSTrip新增了屬性。intermediateDestinations。intermediateDestinationIndex。
GRCTripServiceSubscriber新增了 callback API。- (void)tripService:(GRCTripService *)servicedidUpdateETAToNextWaypoint:(NSTimeInterval)nextWaypointETA;- (void)tripService:(GRCTripService *)service didUpdateIntermediateDestinations: (nullable NSArray<GRSTerminalLocation *> *)intermediateDestinations;
GRCMapViewMarkerType新增了標記類型列舉。GRCMapViewMarkerTypeIntermediateDestination。
GRCCustomizableMarkerType新增了可自訂的標記類型列舉。GRCCustomizableMarkerTypeIntermediateDestination
GRCMapViewCustomerState新增了 mapViewCustomerState。GRCMapViewCustomerStateJourneySharing
已從「
GRCMapViewCustomerState」刪除四位mapViewCustomerState成員。GRCMapViewCustomerStateWaitingForPickupGRCMapViewCustomerStateArrivedAtPickupGRCMapViewCustomerStateEnRouteGRCMapViewCustomerStateEndOfTrip
已從
GRCMapView刪除四個 mapView 回呼 API。-(void)mapViewDidStartWaitingForPickup:(GRCMapView *)mapview;-(void)mapViewDidUpdateDueToDriverArrived:(GRCMapView *)mapview;-(void)mapViewDidStartTripEnroute:(GRCMapView *)mapview;-(void)mapViewDidCompleteTrip:(GRCMapView *)mapview;
GRCMapView新增了回呼 API。- (void)mapViewDidStartJourneySharing:(GRCMapView *)mapView;
改善項目
當清單中第一個路線控點的預計到達時間變更時,更新所有剩餘路線控點的預計到達時間。
司機抵達上車地點時,強制相機自動重新置中。
行程預訂後,在取得任何相符車輛位置前,攝影機邊界會同時包含上車和下車地點。
v0.4.5(28.0) (2019 年 6 月 26 日)
新功能
- 共乘支援行程分享。
API 變更
type欄位已從GRSTerminalLocation中移除。
修正錯誤
現在,只有在路線區段同步時,才會顯示路線動畫,使用者體驗更佳。
修正問題:呼叫
GRCCustomizableMarkerTypeSelectedDropoffPoint的 APIisMarkerStyleOptionsCustomizedForType:時,一律傳回 NO。
v0.4.3 (2019 年 5 月 17 日)
新功能
- 行程分享功能支援連續行程。
- 行程分享功能現在支援動態車輛位置回報率。
API 變更
GRCMapViewMarkerType
| 舊值 | 新值 |
|---|---|
GRCMapViewMarkerTypeSelectedPickup |
GRCMapViewMarkerTypeSelectedPickupPoint |
GRCMapViewMarkerTypeSelectedDropoff |
GRCMapViewMarkerTypeSelectedDropoffPoint |
GRCMapViewMarkerTypePickupCandidate |
GRCMapViewMarkerTypeSuggestedPickupPoint |
GRCMapViewMarkerTypeHighlightedPickupPoint |
|
GRCMapViewMarkerTypeTripPreviewPickupPoint |
|
GRCMapViewMarkerTypeTripPreviewDropoffPoint |
|
GRCMapViewMarkerTypeTripPickupPoint |
|
GRCMapViewMarkerTypeTripDropoffPoint |
GRCMapView
| 舊值 | 新值 |
|---|---|
redrawRidesharingOverlays |
GRCTripServiceSubscriber 通訊協定
| 舊值 | 新值 |
|---|---|
tripService:didUpdateTripRoute: |
tripService:didUpdateActiveRoute: |
tripService:didUpdateRemainingDistance |
tripService:didUpdateActiveRouteRemainingDistance |
tripService:didUpdateRemainingWaypoints |
GRCPolylineType
| 舊值 | 新值 |
|---|---|
GRCPolylineTypeTripRoute |
GRCPolylineTypeActiveRoute |
GRCPolylineTypeTripPreviewAutoRoute |
GRCPolylineTypePreviewAutoRoute |
GRCPolylineTypeTripPreviewTaxiRoute |
GRCPolylineTypePreviewTaxiRoute |
GRCPolylineTypeTripPreviewTruckRoute |
GRCPolylineTypePreviewTruckRoute |
GRCPolylineTypeTripPreviewTwoWheelerRoute |
GRCPolylineTypePreviewTwoWheelerRoute |
GRCPolylineTypeRemainingRoute |
GRCPolylineStyleOptions
| 舊值 | 新值 |
|---|---|
zIndex |
GRSTrip
| 舊值 | 新值 |
|---|---|
remainingWaypoints 資源 |
|
route 資源 |
|
remainingDistanceInMeters 資源 |
|
GRSTripWaypoint |
改善項目
- 減少行程分享的網路用量。
- 選取的取貨候選地點現已醒目顯示。
- 與 Maps SDK 3.1.0 版相容
修正錯誤
- 修正問題:標記在第二次輕觸時沒有回應。
- 修正以下問題:預訂行程後,mapView 的攝影機邊界有時會在開始時顯示非預期的可視區域。
- 修正 SDK 版本 API 的問題。