本節提供 iOS 適用的 Consumer SDK 版本資訊。
v11.1.1 (2026 年 11 月)
- 更新 Swift 套件,使用最新的 Maps SDK for iOS 11.1 修補程式。
- 無須變更程式碼。SDK 二進位檔與 11.1.0 版相同,SDK 在執行階段仍會回報 11.1.0 版。
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 SDK 和 Consumer SDK 相容性,因此可在同一個應用程式中建構。
- 支援 Swift Package Manager,適用於司機和消費者 SDK。
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 年第 2 季起推出的 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。
停止支援 iOS 12 - 2021 年 10 月 18 日
為因應內部依附元件的異動,我們將在即將推出的 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 的問題。