本節包含 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 日)
已變更
移除終端點服務,包括:
GMTSTerminalPointGMTSTerminalPointAccessPointGMTSTerminalPointTravelModeGMTSTerminalPointsVehicleSearchPreferenceGMTSTravelModeETA
我們已停止支援 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 列舉已更新:
舊值 新值 GMTSServiceTypeUnknownGMTSServiceTypeUnspecifiedGMTSServiceTypeTripServiceGMTSServiceTypeVehicleServiceGMTSServiceTypeVehicleGMTSServiceTypeTerminalPointServiceGMTSServiceTypeTask
v0.10.0 (2021 年 5 月 3 日)
變更
已停止支援 iOS 10.x。現在支援的最低 iOS 版本為 11.0。
API 變更
推出
GRCMutableMarkerStyleOptions,讓使用者更輕鬆自訂行程分享標記。在
GRCTripModelSubscriber通訊協定中導入tripModel:didUpdateRemainingRoute:和tripModel:didUpdateRemainingRouteDistance:,用於在剩餘路線或距離更新時,回呼行程更新。
v0.9.0 (2021 年 1 月 25 日)
改善項目
- 這個版本推出「交通狀況感知折線」,方便使用者分享行程。
API 變更
- 推出
GRCMutablePolylineStyleOptions,可用於自訂折線,並為旅程分享功能啟用流量折線的算繪功能。 - 在
GRCTripModelSubscriber中新增了交通資訊更新回呼: - 導入
GRSTrafficData。 - 在
GRSTripWaypoint中新增屬性,以存取流量資料: - 在
GRSTrip中新增方法,可存取流量資料:
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 *)servicedidUpdateETAToNextWaypoint:(NSTimeInterval)nextWaypointETA;- (void)tripService:(GRCTripService *)service didUpdateIntermediateDestinations: (nullable NSArray<GRSTerminalLocation *> *)intermediateDestinations;
GRCMapViewMarkerType中新增了標記類型列舉。GRCMapViewMarkerTypeIntermediateDestination。
GRCCustomizableMarkerType中新增了可自訂的標記類型列舉。GRCCustomizableMarkerTypeIntermediateDestination
GRCMapViewCustomerState中新增了 mapViewCustomerState。GRCMapViewCustomerStateJourneySharing
已從「
GRCMapViewCustomerState」刪除四位「mapViewCustomerState」成員。GRCMapViewCustomerStateWaitingForPickupGRCMapViewCustomerStateArrivedAtPickupGRCMapViewCustomerStateEnRouteGRCMapViewCustomerStateEndOfTrip
從
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 的問題。