開始使用 iOS 版 Driver SDK

您可以使用 Driver SDK 為 行程和訂單進度應用程式。Driver SDK 提供車輛 對隨選乘車和 Deliveries 解決方案機群引擎更新位置和工作。

驅動程式 SDK 可讓您的 Fleet Engine 服務和您的自訂服務掌握 車輛的位置和州別舉例來說,車輛可以是 ONLINEOFFLINE,車輛位置會隨著行程進展而變更。

基本系統需求

  • 行動裝置必須搭載 iOS 14 以上版本。
  • Xcode 15 以上版本。
  • 必要條件

    本指南假設您的應用程式已導入 Navigation SDK,以及機群 引擎 皆已設定完成不過,範例程式碼提供了 瞭解如何設定 Navigation SDK

    您也必須啟用 Maps SDK for iOS 在您的 Google Cloud 專案中 然後取得 API 鍵

    專案設定

    Swift 套件管理工具

    您可以透過 Swift 套件管理工具。如要新增 SDK,請確認您具備 已移除所有現有的驅動程式 SDK 依附元件

    如要將 SDK 加入新專案或現有專案,請按照下列步驟操作:

    1. 開啟 Xcode projectworkspace,然後依序前往「File」>新增套件依附元件
    2. 輸入 https://github.com/googlemaps/ios-driver-sdk 做為網址,然後按下 Enter 鍵 來提取套件,然後點選「Add Package」
    3. 如要安裝特定 version,請將「Dependency Rule」(依附元件規則) 欄位設為 版本化選項如果是新專案,建議您指定最新版本 使用「完全比對版本」如果有需要 SQL 指令的分析工作負載 則 BigQuery 可能是最佳選擇完成後,點選「新增套件」。
    4. 在「Choose Package Products」視窗中,確認 GoogleRidesharingDriver 將新增至 您指定的main目標完成後,點選「新增套件」。
    5. 如要驗證安裝狀態,請前往目標的 General 窗格。 在「Frameworks、Library and Embedded Content」中應會顯示已安裝的套件。 您也可以查看「套件依附元件」「專案導覽器」的 驗證套件及其版本

    如要更新現有專案的 package,請按照下列步驟操作:

    1. 如果要升級的是 9.0.0 以下版本,請務必移除 下列依附元件:GoogleMapsBaseGoogleMapsCore 和 升級後的費用為 GoogleMapsM4B。請勿移除以下項目的依附元件: GoogleMaps。詳情請參閱 9.0.0 版本資訊

      在 Xcode 專案配置設定中,找到「Frameworks, libraries」 和嵌入內容請使用減號(-) 移除下列架構:

      • GoogleMapsBase (僅適用於 9.0.0 以下版本的升級作業)
      • GoogleMapsCore (僅適用於 9.0.0 以下版本的升級作業)
      • GoogleMapsM4B (僅適用於 9.0.0 以下版本的升級作業)
    2. 在 Xcode 中,前往 [檔案] >套裝行程 >更新至最新套件版本」。
    3. 如要驗證安裝狀態,請前往「Project Navigator」的「Package Dependencies」部分 驗證套件及其版本
    ,瞭解如何調查及移除這項存取權。

    如要移除現有驅動程式 SDK 依附元件,請使用 CocoaPods,請按照下列步驟操作:

    1. 關閉 Xcode 工作區。開啟終端機並執行下列指令:
      sudo gem install cocoapods-deintegrate cocoapods-clean 
      pod deintegrate 
      pod cache clean --all
    2. 移除 PodfilePodfile.resolved 和 如果不是 CocoaPods,則使用 Xcode workspace

    移除已安裝的現有驅動程式 SDK 手動操作,步驟如下:

    1. 在 Xcode 專案配置設定中,找出 Frameworks、 程式庫和嵌入內容使用減號(-)即可移除 下列架構:

      • GoogleRidesharingDriver.xcframework
    2. 從 Xcode 專案的頂層目錄中,移除 GoogleRidesharingDriver 軟體包。

    CocoaPods

    如要使用 CocoaPods 設定 Driver SDK,您必須備妥下列項目:

    • CocoaPods 工具:如要安裝此工具,請開啟終端機並執行 。
       sudo gem install cocoapods
    
    1. 建立驅動程式 SDK 的 Podfile,然後透過該 Pod 安裝 API 其依附元件:在專案目錄中建立名為 Podfile 的檔案。 這個檔案定義了專案的依附元件。編輯 Podfile 依附元件以下是包含依附元件的範例:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      以下這個範例包含了 使用驅動程式 SDK 做為依附元件:

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      
    2. 儲存 Podfile。開啟終端機並前往包含 Podfile:

      cd <path-to-project>
      
    3. 執行 pod 安裝指令。這個指令會安裝 Podfile 及其所有依附元件。

      pod install
      
    4. 關閉 Xcode,然後開啟 (按兩下) 專案的 .xcworkspace 檔案以啟動 Xcode。從現在起,您必須使用 .xcworkspace 檔案即可開啟專案。

    ,瞭解如何調查及移除這項存取權。

    請參閱 CocoaPods 入門指南 指南 詳細資料。

    手動安裝程式庫

    XCFramework 是二進位套件,用來安裝 驅動程式 SDK。這個套件可用於多個項目 平台,包括使用 Apple silicon。本指南說明如何 手動新增包含 將 SDK 驅動程式至專案,並設定建構作業 設定。

    下載 SDK 二進位檔和資源:

    1. 解壓縮檔案以存取 XCFramework 和資源。

    2. 啟動 Xcode 並開啟現有專案,或建立新專案 專案。如果您是 iOS 新手,請建立新專案並選取 應用程式範本。

    3. 如果沒有架構群組,請在專案群組下建立架構群組

    4. 如要安裝驅動程式 SDK,請拖曳 將 GoogleRidesharingDriver.xcframework 個檔案匯入專案 架構、程式庫和嵌入內容。在系統提示時選取 視需要複製項目。

    5. 將下載的 GoogleRidesharingDriver.bundle 拖曳到頂層 目錄。系統提示時,請選取 Copy items if needed

    6. 從「Project Navigator」中選取專案,然後選擇 並指定應用程式的目標

    7. 開啟「建構階段」分頁,然後在「連結二進位檔」和「程式庫的連結二進位檔」中,新增 下列架構和程式庫 (如果尚未提供):

      • Accelerate.framework
      • AudioToolbox.framework
      • AVFoundation.framework
      • CoreData.framework
      • CoreGraphics.framework
      • CoreLocation.framework
      • CoreTelephony.framework
      • CoreText.framework
      • GLKit.framework
      • ImageIO.framework
      • libc++.tbd
      • libxml2.tbd
      • libz.tbd
      • LocalAuthentication.framework
      • OpenGLES.framework
      • QuartzCore.framework
      • SystemConfiguration.framework
      • UIKit.framework
      • WebKit.framework
    8. 選擇專案 (而非特定目標),然後開啟「Build」 設定標籤。在 Other Linker Flags 區段中,將 -ObjC 包括偵錯和發布版本如果這些設定沒有顯示,請變更 在「Build Settings」列中,從「Basic」變更為「All」

    檢查 Apple 隱私權資訊清單檔案

    Apple 要求在 App Store 上架應用程式,要求取得應用程式隱私權詳細資訊。如需最新資訊和其他資訊,請前往 Apple App Store 隱私權詳細資料頁面

    Apple 隱私權資訊清單檔案包含在 SDK 資源套件中。如要確認隱私權資訊清單檔案已納入並檢查其中的內容,請建立應用程式的封存檔案,然後從封存檔中產生隱私權報告

    實作授權和驗證

    當驅動程式應用程式產生更新並傳送至 Fleet Engine 後端時, 要求必須包含有效的存取權杖。授權和驗證 因此驅動程式 SDK 會呼叫您的物件 皆符合 GMTDAuthorization 通訊協定物件負責 並提供必要的存取權杖

    應用程式開發人員可以選擇產生權杖的產生方式,實作項目 應能夠執行下列操作:

    • 從 HTTPS 伺服器擷取存取權杖 (可能為 JSON 格式)。
    • 剖析及快取權杖。
    • 請在權杖過期時重新整理。

    如要進一步瞭解 Fleet Engine 伺服器預期的權杖,請參閱建立 JSON Web Token (JWT) 授權

    提供者 ID 與 Google Cloud 專案 ID 相同。參閱 Fleet Engine 快速入門導覽課程 指南 瞭解詳情

    以下範例實作存取權杖供應工具:

    Swift

    import GoogleRidesharingDriver
    
    private let providerURL = "INSERT_YOUR_TOKEN_PROVIDER_URL"
    
    class SampleAccessTokenProvider: NSObject, GMTDAuthorization {
      private struct AuthToken {
        // The cached vehicle token.
        let token: String
        // Keep track of when the token expires for caching.
        let expiration: TimeInterval
        // Keep track of the vehicle ID the cached token is for.
        let vehicleID: String
      }
    
      enum AccessTokenError: Error {
        case missingAuthorizationContext
        case missingData
      }
    
      private var authToken: AuthToken?
    
      func fetchToken(
        with authorizationContext: GMTDAuthorizationContext?,
        completion: @escaping GMTDAuthTokenFetchCompletionHandler
      ) {
        // Get the vehicle ID from the authorizationContext. This is set by the Driver SDK.
        guard let authorizationContext = authorizationContext else {
          completion(nil, AccessTokenError.missingAuthorizationContext)
          return
        }
        let vehicleID = authorizationContext.vehicleID
    
        // If appropriate, use the cached token.
        if let authToken = authToken,
          authToken.expiration > Date.now.timeIntervalSince1970 && authToken.vehicleID == vehicleID
        {
          completion(authToken.token, nil)
          return
        }
    
        // Otherwise, try to fetch a new token from your server.
        let request = URLRequest(url: URL(string: providerURL))
        let task = URLSession.shared.dataTask(with: request) { [weak self] data, _, error in
          guard let strongSelf = self else { return }
          guard error == nil else {
            completion(nil, error)
            return
          }
    
          // Replace the following key values with the appropriate keys based on your
          // server's expected response.
          let vehicleTokenKey = "VEHICLE_TOKEN_KEY"
          let tokenExpirationKey = "TOKEN_EXPIRATION"
          guard let data = data,
            let fetchData = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
            let token = fetchData[vehicleTokenKey] as? String,
            let expiration = fetchData[tokenExpirationKey] as? Double
          else {
            completion(nil, AccessTokenError.missingData)
            return
          }
    
          strongSelf.authToken = AuthToken(
            token: token, expiration: expiration, vehicleID: vehicleID)
          completion(token, nil)
        }
        task.resume()
      }
    }
    

    Objective-C

    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    // SampleAccessTokenProvider.h
    @interface SampleAccessTokenProvider : NSObject<GMTDAuthorization>
    @end
    
    static NSString *const PROVIDER_URL = @"INSERT_YOUR_TOKEN_PROVIDER_URL";
    
    // SampleAccessTokenProvider.m
    @implementation SampleAccessTokenProvider{
      // The cached vehicle token.
      NSString *_cachedVehicleToken;
      // Keep track of the vehicle ID the cached token is for.
      NSString *_lastKnownVehicleID;
      // Keep track of when tokens expire for caching.
      NSTimeInterval _tokenExpiration;
    }
    
    -   (void)fetchTokenWithContext:(nullable GMTDAuthorizationContext *)authorizationContext
                       completion:(nonnull GMTDAuthTokenFetchCompletionHandler)completion {
      // Get the vehicle ID from the authorizationContext. This is set by the Driver SDK.
      NSString *vehicleID = authorizationContext.vehicleID;
      if (!vehicleID) {
        NSAssert(NO, @"Vehicle ID is missing from authorizationContext.");
        return;
      }
    
      // Clear cached vehicle token if vehicle ID has changed.
      if (![_lastKnownVehicleID isEqual:vehicleID]) {
        _tokenExpiration = 0.0;
        _cachedVehicleToken = nil;
      }
      _lastKnownVehicleID = vehicleID;
    
      // Clear cached vehicletoken if it has expired.
      if ([[NSDate date] timeIntervalSince1970] > _tokenExpiration) {
        _cachedVehicleToken = nil;
      }
    
      // If appropriate, use the cached token.
      if (_cachedVehicleToken) {
        completion(_cachedVehicleToken, nil);
        return;
      }
      // Otherwise, try to fetch a new token from your server.
      NSURL *requestURL = [NSURL URLWithString:PROVIDER_URL];
      NSMutableURLRequest *request =
          [[NSMutableURLRequest alloc] initWithURL:requestURL];
      request.HTTPMethod = @"GET";
      // Replace the following key values with the appropriate keys based on your
      // server's expected response.
      NSString *vehicleTokenKey = @"VEHICLE_TOKEN_KEY";
      NSString *tokenExpirationKey = @"TOKEN_EXPIRATION";
      __weak typeof(self) weakSelf = self;
      void (^handler)(NSData *_Nullable data, NSURLResponse *_Nullable response,
                      NSError *_Nullable error) =
          ^(NSData *_Nullable data, NSURLResponse *_Nullable response, NSError *_Nullable error) {
            typeof(self) strongSelf = weakSelf;
            if (error) {
              completion(nil, error);
              return;
            }
    
            NSError *JSONError;
            NSMutableDictionary *JSONResponse =
                [NSJSONSerialization JSONObjectWithData:data options:kNilOptions error:&JSONError];
    
            if (JSONError) {
              completion(nil, JSONError);
              return;
            } else {
              // Sample code only. No validation logic.
              id expirationData = JSONResponse[tokenExpirationKey];
              if ([expirationData isKindOfClass:[NSNumber class]]) {
                NSTimeInterval expirationTime = ((NSNumber *)expirationData).doubleValue;
                strongSelf->_tokenExpiration = [[NSDate date] timeIntervalSince1970] + expirationTime;
              }
              strongSelf->_cachedVehicleToken = JSONResponse[vehicleTokenKey];
              completion(JSONResponse[vehicleTokenKey], nil);
            }
          };
      NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
      NSURLSession *mainQueueURLSession =
          [NSURLSession sessionWithConfiguration:config delegate:nil
                                   delegateQueue:[NSOperationQueue mainQueue]];
      NSURLSessionDataTask *task = [mainQueueURLSession dataTaskWithRequest:request completionHandler:handler];
      [task resume];
    }
    
    @end
    

    建立 RidesharingDriverAPI 執行個體

    如要取得 GMTDVehicleReporter 例項,您必須先建立 GMTDRidesharingDriverAPI 執行個體,使用 providerID、車輛 ID、 DriverContext 和 accessTokenProvider。providerID 與 Google 相同 Cloud 專案 ID。也可以從以下位置存取 GMTDVehicleReporter 執行個體: 驅動程式 API

    以下範例會建立 GMTDRidesharingDriverAPI 例項:

    Swift

    import GoogleRidesharingDriver
    
    private let providerID = "INSERT_YOUR_PROVIDER_ID"
    
    class SampleViewController: UIViewController {
      private let mapView: GMSMapView
    
      override func viewDidLoad() {
        super.viewDidLoad()
    
        let vehicleID = "INSERT_CREATED_VEHICLE_ID"
        let accessTokenProvider = SampleAccessTokenProvider()
        let driverContext = GMTDDriverContext(
          accessTokenProvider: accessTokenProvider,
          providerID: providerID,
          vehicleID: vehicleID,
          navigator: mapView.navigator)
        let ridesharingDriverAPI = GMTDRidesharingDriverAPI(driverContext: driverContext)
      }
    }
    

    Objective-C

    #import "SampleViewController.h"
    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
    
    @implementation SampleViewController {
      GMSMapView *_mapView;
    }
    
    -   (void)viewDidLoad {
      NSString *vehicleID = @"INSERT_CREATED_VEHICLE_ID";
      SampleAccessTokenProvider *accessTokenProvider =
                                    [[SampleAccessTokenProvider alloc] init];
      GMTDDriverContext *driverContext =
        [[GMTDDriverContext alloc] initWithAccessTokenProvider:accessTokenProvider
                                                    providerID:PROVIDER_ID
                                                     vehicleID:vehicleID
                                                     navigator:_mapView.navigator];
    
      GMTDRidesharingDriverAPI *ridesharingDriverAPI = [[GMTDRidesharingDriverAPI alloc] initWithDriverContext:driverContext];
    }
    

    可選擇監聽 VehicleReporter 事件

    GMTDVehicleReporter 會在以下時間定期更新車輛資料: locationTrackingEnabledtrue。如要回應這些定期更新, 物件可訂閱 GMTDVehicleReporter 事件,方法是遵守 GMTDVehicleReporterListener 通訊協定。

    您可以處理下列事件:

    以下範例會處理這些事件:

    Swift

    import GoogleRidesharingDriver
    
    private let providerID = "INSERT_YOUR_PROVIDER_ID"
    
    class SampleViewController: UIViewController, GMTDVehicleReporterListener {
      private let mapView: GMSMapView
    
      override func viewDidLoad() {
        // Assumes you have implemented the sample code up to this step.
        ridesharingDriverAPI.vehicleReporter.add(self)
      }
    
      func vehicleReporter(_ vehicleReporter: GMTDVehicleReporter, didSucceed vehicleUpdate: GMTDVehicleUpdate) {
        // Handle update succeeded.
      }
    
      func vehicleReporter(_ vehicleReporter: GMTDVehicleReporter, didFail vehicleUpdate: GMTDVehicleUpdate, withError error: Error) {
        // Handle update failed.
      }
    }
    

    Objective-C

    /*
    
        *   SampleViewController.h
     */
    @interface SampleViewController : UIViewController<GMTDVehicleReporterListener>
    @end
    
    /*
    
        *   SampleViewController.m
     */
    #import "SampleViewController.h"
    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
    
    @implementation SampleViewController {
      GMSMapView *_mapView;
    }
    
    -   (void)viewDidLoad {
      // Assumes you have implemented the sample code up to this step.
      [ridesharingDriverAPI.vehicleReporter addListener:self];
    }
    
    -   (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter didSucceedVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate {
      // Handle update succeeded.
    }
    
    -   (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter didFailVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate withError:(NSError *)error {
      // Handle update failed.
    }
    
    @end
    

    新增 GMTDVehicleReporter 作為 GMSRoadSnappedLocationProvider 的事件監聽器

    為了向驅動程式 SDK 提供位置更新通知,GMTDVehicleReporter 必須設為 GMSRoadSnappedLocationProvider 的事件監聽器。

    Swift

    import GoogleRidesharingDriver
    
    private let providerID = "INSERT_YOUR_PROVIDER_ID"
    
    class SampleViewController: UIViewController, GMTDVehicleReporterListener {
      private let mapView: GMSMapView
    
      override func viewDidLoad() {
        // Assumes you have implemented the sample code up to this step.
        if let roadSnappedLocationProvider = mapView.roadSnappedLocationProvider {
          roadSnappedLocationProvider.add(ridesharingDriverAPI.vehicleReporter)
          roadSnappedLocationProvider.startUpdatingLocation()
        }
      }
    }
    

    Objective-C

    /*
    
        *   SampleViewController.h
     */
    @interface SampleViewController : UIViewController<GMTDVehicleReporterListener>
    @end
    
    /*
    
        *   SampleViewController.m
     */
    #import "SampleViewController.h"
    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
    
    @implementation SampleViewController {
      GMSMapView *_mapView;
    }
    
    -   (void)viewDidLoad {
      // Assumes you have implemented the sample code up to this step.
      [_mapView.roadSnappedLocationProvider addListener:ridesharingDriverAPI.vehicleReporter];
      [_mapView.roadSnappedLocationProvider startUpdatingLocation];
    }
    
    @end
    

    啟用位置追蹤功能

    如要啟用位置追蹤功能,應用程式可以將 locationTrackingEnabled 設為 trueGMTDVehicleReporterGMTDVehicleReporter 會自動傳送 位置更新。當服務比對相符並將車輛指派給行程後, GMTDVehicleReporterGMSNavigator 時自動傳送路線更新 處於導覽模式 (透過 setDestinations 設定目的地時)。

    行程更新期間設定的路線會與駕駛人行駛的路線相同 正在導航工作階段。因此,如要分享旅程 正確,透過 setDestinations 設定的路線控點應該會與 目的地設定於 Fleet Engine 後端

    如果將 locationTrackingEnabled 設為 true,系統會傳送行程和車輛的最新資訊 會依據 locationUpdateInterval。如果將 locationTrackingEnabled 設為 false, 更新停止作業,並將最後的車輛更新要求傳送至 Fleet Engine 後端,以便將車輛狀態設為 GMTDVehicleState.offline。詳情請見 updateVehicleState敬上 有關處理 locationTrackingEnabled 失敗的特別注意事項 已設為 false

    以下範例啟用位置追蹤功能:

    Swift

    import GoogleRidesharingDriver
    
    private let providerID = "INSERT_YOUR_PROVIDER_ID"
    
    class SampleViewController: UIViewController, GMTDVehicleReporterListener {
      private let mapView: GMSMapView
    
      override func viewDidLoad() {
        // Assumes you have implemented the sample code up to this step.
        ridesharingDriverAPI.vehicleReporter.locationTrackingEnabled = true
      }
    }
    

    Objective-C

    /*
        *   SampleViewController.m
     */
    #import "SampleViewController.h"
    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
    
    @implementation SampleViewController {
      GMSMapView *_mapView;
    }
    
    -   (void)viewDidLoad {
      // Assumes you have implemented the sample code up to this step.
      ridesharingDriverAPI.vehicleReporter.locationTrackingEnabled = YES;
    }
    
    @end
    

    報表間隔預設為 10 秒,但報表間隔時間可以 變更為 locationUpdateInterval。支援的更新間隔下限 5 秒支援的更新間隔時間上限為 60 秒。頻率較高 更新可能會導致要求和錯誤變慢。

    更新車輛狀態

    以下範例說明如何將車輛狀態設為 ONLINE。詳情請見 updateVehicleState敬上 。

    Swift

    import GoogleRidesharingDriver
    
    private let providerID = "INSERT_YOUR_PROVIDER_ID"
    
    class SampleViewController: UIViewController, GMTDVehicleReporterListener {
      private let mapView: GMSMapView
    
      override func viewDidLoad() {
        // Assumes you have implemented the sample code up to this step.
        ridesharingDriverAPI.vehicleReporter.update(.online)
      }
    }
    

    Objective-C

    #import "SampleViewController.h"
    #import "SampleAccessTokenProvider.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";
    
    @implementation SampleViewController {
      GMSMapView *_mapView;
    }
    
    -   (void)viewDidLoad {
      // Assumes you have implemented the sample code up to this step.
      [ridesharingDriverAPI.vehicleReporter
                                       updateVehicleState:GMTDVehicleStateOnline];
    }
    
    @end
    

    當遮罩為空白時,可能會發生 update_mask 錯誤,且這個錯誤通常發生 進行更新。以下範例說明如何處理 這個錯誤:

    Swift

    import GoogleRidesharingDriver
    
    class VehicleReporterListener: NSObject, GMTDVehicleReporterListener {
      func vehicleReporter(
        _ vehicleReporter: GMTDVehicleReporter,
        didFail vehicleUpdate: GMTDVehicleUpdate,
        withError error: Error
      ) {
        let fullError = error as NSError
        if let innerError = fullError.userInfo[NSUnderlyingErrorKey] as? NSError {
          let innerFullError = innerError as NSError
          if innerFullError.localizedDescription.contains("update_mask cannot be empty") {
            emptyMaskUpdates += 1
            return
          }
        }
        failedUpdates += 1
      }
    
      override init() {
        emptyMaskUpdates = 0
        failedUpdates = 0
      }
    }
    

    Objective-C

    #import "VehicleReporterListener.h"
    #import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>
    
    @implementation VehicleReporterListener {
      NSInteger emptyMaskUpdates = 0;
      NSInteger failedUpdates = 0;
    }
    
    -   (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter
       didFailVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate
                  withError:(NSError *)error {
      for (NSError *underlyingError in error.underlyingErrors) {
        if ([underlyingError.localizedDescription containsString:@"update_mask cannot be empty"]) {
          emptyMaskUpdates += 1;
          return;
        }
      }
      failedUpdates += 1
    }
    
    @end
    

    停用位置更新功能並將車輛離線

    應用程式可以停用更新功能,並將車輛離線。舉例來說 司機的班機結束,應用程式可以將 locationTrackingEnabled 設為 false。 停用更新功能也會將 Fleet Engine 上的車輛狀態設為「OFFLINE」 後端。

    Swift

    vehicleReporter.locationTrackingEnabled = false
    

    Objective-C

    _vehicleReporter.locationTrackingEnabled = NO;