Consumer SDK for iOS 版本資訊

本節包含 iOS 版 Consumer SDK 的版本資訊。

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> 初始化程式。

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

已變更

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

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

變更

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

v0.9.0 (2021 年 1 月 25 日)

改善項目

API 變更

0.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。
  • 已將新的 callback 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 的問題。