Consumer SDK for iOS 版本資訊

本節提供 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 日)

已變更

  • 移除終端點服務,包括:

    • 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 呼叫 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 日)

變更

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 變更

v0.9.0 (2021 年 1 月 25 日)

改善項目

API 變更

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 *)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

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 的問題。