Consumer SDK for iOS 版本資訊

本節提供 iOS 版 Consumer SDK 的版本資訊。

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> 初始化工具。

9.2.1 版 (2025 年 4 月)

已變更

修正未定義的符號錯誤。

9.2 版 (2025 年 1 月)

已變更

版本從 9.0 升級至 9.2。
支援雲端式地圖樣式設定。
支援使用者在行程期間擷取「車輛位置」狀態。
修正折線消失的罕見問題。

第 9.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 版本。

公告

停止支援 iOS 14 - 2023 年 5 月 15 日

根據行動作業系統版本支援政策，我們將在即將推出的 iOS 版 Consumer SDK 主要版本中，停止支援 iOS 14。

自 2024 年第二季起，發布的 iOS 版 Consumer SDK 版本將支援 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 日)

已變更

修正錯誤並更新說明文件。

2.0.0 版 (2022 年 7 月 18 日)

已變更

移除終端點服務，包括：
- GMTSTerminalPoint
- GMTSTerminalPointAccessPoint
- GMTSTerminalPointTravelMode
- GMTSTerminalPointsVehicleSearchPreference
- GMTSTravelModeETA
我們已停止支援 iOS 12。現在最低須使用 iOS 13.0 版。

已淘汰

已淘汰公用類別 GMTCMapView 中的初始值。

公告

在 2023 年的 Consumer iOS SDK 主要版本更新中，我們將凍結 (淘汰) 對 iOS 13 的支援。自 2023 年 6 月起，我們將支援 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 更新

呼叫 fetchAuthTokenForServiceType:authorizationContext:completion: 時，在 authorizationContext 中新增了用於指定工作 ID 的索引鍵 kGMTSAuthorizationContextKeyTaskID。

GMTSServiceType 列舉已更新：

舊值	新值
`GMTSServiceTypeUnknown`	`GMTSServiceTypeUnspecified`
`GMTSServiceTypeTripService`
`GMTSServiceTypeVehicleService`	`GMTSServiceTypeVehicle`
`GMTSServiceTypeTerminalPointService`
	`GMTSServiceTypeTask`

v0.10.0 (2021 年 5 月 3 日)

變更

已停止支援 iOS 10.x。現在支援的最低 iOS 版本為 11.0。

API 變更

推出 GRCMutableMarkerStyleOptions ，讓使用者更輕鬆自訂行程分享標記。
在 GRCTripModelSubscriber 通訊協定中導入 tripModel:didUpdateRemainingRoute: 和 tripModel:didUpdateRemainingRouteDistance:，用於在剩餘路線或距離更新時，回呼行程更新。

0.9.0 版 (2021 年 1 月 25 日)

改善項目

這個版本推出流量感知折線，方便使用者分享行程。

API 變更

推出 GRCMutablePolylineStyleOptions，可自訂折線，用於啟用行程分享的交通資訊折線算繪功能。
在 GRCTripModelSubscriber 中新增了交通資訊更新回呼：
- tripModel:didUpdateActiveRouteTraffic:
導入 GRSTrafficData。
在 GRSTripWaypoint 中新增屬性，以存取流量資料：
- trafficData
在 GRSTrip 中新增方法，用於存取流量資料：
- activeRouteTraffic
- remainingRouteTraffic

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。
已將新的回呼 API 新增至 GRCTripServiceSubscriber。
- - (void)tripService:(GRCTripService *)service didUpdateETAToNextWaypoint:(NSTimeInterval)nextWaypointETA;
- - (void)tripService:(GRCTripService *)service didUpdateIntermediateDestinations: (nullable NSArray<GRSTerminalLocation *> *)intermediateDestinations;
GRCMapViewMarkerType 中新增了標記類型列舉。
- GRCMapViewMarkerTypeIntermediateDestination。
GRCCustomizableMarkerType 中新增可自訂的標記類型列舉。
- GRCCustomizableMarkerTypeIntermediateDestination
GRCMapViewCustomerState 中新增了 mapViewCustomerState。
- GRCMapViewCustomerStateJourneySharing
已從「GRCMapViewCustomerState」中刪除四位mapViewCustomerState成員。
- GRCMapViewCustomerStateWaitingForPickup
- GRCMapViewCustomerStateArrivedAtPickup
- GRCMapViewCustomerStateEnRoute
- GRCMapViewCustomerStateEndOfTrip
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」中移除。

修正錯誤

現在只有在路徑區隔同步時，才會發生路徑動畫，進而提升使用者體驗。
修正問題：呼叫 API isMarkerStyleOptionsCustomizedForType: 時，GRCCustomizableMarkerTypeSelectedDropoffPoint 一律會傳回 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 的問題。

Consumer SDK for iOS 版本資訊 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

v10.10 (2026 年 3 月)

v10.0.0 (2025 年 6 月)

已變更

API 變更

9.2.1 版 (2025 年 4 月)

已變更

9.2 版 (2025 年 1 月)

已變更

第 9.0 版 (2024 年 7 月)

已變更

v3.3.0 (2024 年 3 月)

已變更

v3.2.0 (2023 年 12 月)

已變更

已淘汰

v3.1.1 (2023 年 10 月)

已變更

v3.1.0 (2023 年 9 月)

已變更

v3.0.1 (2023 年 8 月)

已變更

v3.0.0 (2023 年 5 月)

已變更

公告

停止支援 iOS 14 - 2023 年 5 月 15 日

v2.2.0 (2023 年 2 月)

已變更

v2.1.0 (2022 年 9 月 12 日)

已變更

2.0.0 版 (2022 年 7 月 18 日)

已變更

已淘汰

公告

v1.0.6 (2022 年 3 月 24 日)

v1.0 (2021 年 12 月 7 日)

API 變更

停止支援 iOS 12 - 2021 年 10 月 18 日

v0.11.0 (2021 年 9 月 30 日)

變更

API 變更

所有類別的名稱前置字串已更新：

GMTSAuthorization API 更新

v0.10.0 (2021 年 5 月 3 日)

變更

API 變更

0.9.0 版 (2021 年 1 月 25 日)

改善項目

API 變更

v0.6.7 (2020 年 3 月 23 日)

改善項目

v0.6.3 (2019 年 12 月 16 日)

變更

v0.5.4(86.0) (2019 年 8 月 7 日)

新功能

API 變更

改善項目

v0.4.5(28.0) (2019 年 6 月 26 日)

新功能

API 變更

修正錯誤

v0.4.3 (2019 年 5 月 17 日)

新功能

API 變更

GRCMapViewMarkerType

GRCMapView

GRCTripServiceSubscriber 協定

GRCPolylineType

GRCPolylineStyleOptions

GRSTrip

改善項目

修正錯誤

Consumer SDK for iOS 版本資訊