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

Consumer SDK for iOS 版本資訊

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

第 9.0 版 (2024 年 7 月)

已變更

支援 Geo iOS SDK 9.0 版。
我們已停止支援 iOS 14。目前的最低 iOS 版本為 15.0。
這個版本包含 .xcprivacy 檔案，可支援 Apple 隱私權資訊清單。
包含可修正的罕見記錄相關當機問題。

第 3.3.0 版 (2024 年 3 月)

已變更

支援 Driver 和 Consumer SDK 相容性，因此可在同一個應用程式中建構。
支援針對驅動程式和消費者 SDK 的 Swift Package Manager。

v3.2.0 (2023 年 12 月)

已變更

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

已淘汰

淘汰了 GMTCMapView 中的 [GMTCMapView initWithCoder]。

3.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 版本資訊中已淘汰的內容，瞭解使用 bitcode 建構功能的支援何時結束。
根據行動作業系統版本支援政策，自 Consumer SDK for iOS 3.0.0 版起，我們將停止支援 iOS 13。新版最低支援的作業系統為 iOS 14。舊版 SDK 將繼續支援 iOS 13。如果依附元件未指定版本號碼，IDE 會載入最新 SDK 版本，且新版應用程式將不支援 iOS 13。在應用程式的版本依附元件中指定 iOS 版 Consumer SDK 版本，以便控制何時提高新版應用程式支援的最低作業系統版本。

公告

凍結 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 的版本，以便控制何時針對新版應用程式提高支援的最低 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 版本為 iOS 14。客戶應先準備好，在更新前變更程式碼中的最低版本支援標記。

v1.0.6 (2022 年 3 月 24 日)

修正內部錯誤。

v1.0 (2021 年 12 月 7 日)

此版本支援的最低 iOS 版本為 12.0。

API 變更

驗證方式異動

SDK 會針對每個 gRPC 的 AuthTokenFactory 介面實作呼叫 getToken()。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 2.0 以上版本的消費者 SDK 僅支援搭載 iOS 13 以上版本的裝置。舊版 SDK 將繼續支援 iOS 12。

如果 CocoaPods 或 Carthage 中的依附元件未指定版本號碼，Xcode 會載入最新版本，而應用程式的新版本將不支援 iOS 12。

請務必在應用程式的版本依附元件中指定版本，以便控制何時提高新版應用程式支援的最低作業系統版本。請參閱 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 列舉已更新：

舊值	新值
`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 中的目的地不符時，系統不會再強制將車輛圖示指向舊路線。
系統現在會捨棄過期的行程回應。

第 0.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 中移除。

修正錯誤

路線動畫現在只會在路線路段同步時顯示，進而改善使用者體驗。
修正了針對 GRCCustomizableMarkerTypeSelectedDropoffPoint 呼叫 API isMarkerStyleOptionsCustomizedForType: 一律會傳回 NO 的問題。

v0.4.3 (2019 年 5 月 17 日)

新功能

返回「旅程分享」支援功能。
歷程分享功能現在支援動態車輛位置回報率。

API 變更

GRCMapViewMarkerType

舊值	新值
`GRCMapViewMarkerTypeSelectedPickup`	`GRCMapViewMarkerTypeSelectedPickupPoint`
`GRCMapViewMarkerTypeSelectedDropoff`	`GRCMapViewMarkerTypeSelectedDropoffPoint`
`GRCMapViewMarkerTypePickupCandidate`	`GRCMapViewMarkerTypeSuggestedPickupPoint`
	`GRCMapViewMarkerTypeHighlightedPickupPoint`
	`GRCMapViewMarkerTypeTripPreviewPickupPoint`
	`GRCMapViewMarkerTypeTripPreviewDropoffPoint`
	`GRCMapViewMarkerTypeTripPickupPoint`
	`GRCMapViewMarkerTypeTripDropoffPoint`

GRCMapView

舊值	新值
	`redrawRidesharingOverlays`

GRCTripService 訂閱者通訊協定

舊值	新值
`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 的問題。