本頁面由 Cloud Translation API 翻譯而成。

Consumer SDK for iOS 版本資訊

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

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。在應用程式的建構依附元件中指定 iOS 適用的 Consumer SDK 版本，即可控管何時提高新版應用程式支援的最低 OS 版本。

公告

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

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

自 2024 年第二季起，發布的 iOS 版 Consumer SDK 版本將支援 iOS 15 以上版本。較舊的 SDK 版本仍會支援 iOS 14。

如果依附元件未指定版本號碼，IDE 會載入最新版 SDK，而應用程式的新建版本將不支援 iOS 14。

在應用程式的建構依附元件中指定 iOS 版 Consumer SDK 的版本，以便控管何時提高新版應用程式支援的最低作業系統。

v2.2.0 (2023 年 2 月)

已變更

將標頭檔案中的條款及細則網址更新為正確連結，並修正其他標點符號的小問題。
修正說明文件中的各種拼字、標點符號和其他細微錯誤。

2.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 日

因應內部依附元件的變更，我們將在即將推出的 Consumer SDK for iOS 主要版本中，停止支援 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 變更

已從「GRSTerminalLocation」中移除「type」欄位。

修正錯誤

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